|
@@ -10,8 +10,8 @@ Jan Janak
|
|
|
|
|
|
Copyright © 2004, 2005 FhG FOKUS
|
|
|
Revision History
|
|
|
- Revision $Revision$ $Date: 2008-03-19 21:31:30 +0200
|
|
|
- (Wed, 19 Mar 2008) $
|
|
|
+ Revision $Revision$ $Date: 2008-03-19 20:31:30 +0100
|
|
|
+ (Mi, 19 Mär 2008) $
|
|
|
__________________________________________________________
|
|
|
|
|
|
Table of Contents
|
|
@@ -24,7 +24,7 @@ Jan Janak
|
|
|
|
|
|
1.2. Dependencies
|
|
|
|
|
|
- 1.2.1. OpenSER Modules
|
|
|
+ 1.2.1. Kamailio Modules
|
|
|
1.2.2. External Libraries or Applications
|
|
|
|
|
|
1.3. Exported Parameters
|
|
@@ -46,8 +46,8 @@ Chapter 1. Admin Guide
|
|
|
|
|
|
1.1. Overview
|
|
|
|
|
|
- Flatstore is one of so-called OpenSER database modules. It does
|
|
|
- not export any functions executable from the configuration
|
|
|
+ Flatstore is one of so-called Kamailio database modules. It
|
|
|
+ does not export any functions executable from the configuration
|
|
|
scripts, but it exports a subset of functions from the database
|
|
|
API and thus other module can use it instead of, for example,
|
|
|
mysql module.
|
|
@@ -73,29 +73,29 @@ modparam("acc", "db_url", "flatstore:/var/log/acc")
|
|
|
This configuration options tells acc module that it should use
|
|
|
the flatstore module and the flatstore module should create all
|
|
|
files in /var/log/acc directory. The directory must exist and
|
|
|
- OpenSER processes must have permissions to create files in that
|
|
|
- directory.
|
|
|
+ Kamailio processes must have permissions to create files in
|
|
|
+ that directory.
|
|
|
|
|
|
Name of files in that directory will follow the following
|
|
|
pattern:
|
|
|
<table_name>_<process_name>.log
|
|
|
|
|
|
- For example, entries writen by OpenSER process 8 into acc table
|
|
|
- would be written in file acc_8.log. For each table there will
|
|
|
- be several files, one file for every OpenSER process that wrote
|
|
|
- some data into that table. The main reason why there are
|
|
|
+ For example, entries writen by Kamailio process 8 into acc
|
|
|
+ table would be written in file acc_8.log. For each table there
|
|
|
+ will be several files, one file for every Kamailio process that
|
|
|
+ wrote some data into that table. The main reason why there are
|
|
|
several files for each table is that it is much faster to have
|
|
|
one file per process, because it does not require any locking
|
|
|
- and thus OpenSER processes will not block each other. To get
|
|
|
+ and thus Kamailio processes will not block each other. To get
|
|
|
the complete data for a table you can simply concatenate the
|
|
|
contents of files with the same table name but different
|
|
|
process id.
|
|
|
|
|
|
1.1.1. Rotating Log Files
|
|
|
|
|
|
- There is a new OpenSER MI (management interface) command called
|
|
|
- flat_rotate. When OpenSER receives the command then it will
|
|
|
- close and reopen all files used by flatstore module. The
|
|
|
+ There is a new Kamailio MI (management interface) command
|
|
|
+ called flat_rotate. When Kamailio receives the command then it
|
|
|
+ will close and reopen all files used by flatstore module. The
|
|
|
rotation itself has to be done by another application (such as
|
|
|
logrotate). Follow these steps to rotate files generated by
|
|
|
flatstore module:
|
|
@@ -106,30 +106,30 @@ mv acc_2.log acc_2.log.20050605
|
|
|
mv acc_4.log acc_3.log.20050605
|
|
|
...
|
|
|
|
|
|
- Note that at this point OpenSER will still be writing all
|
|
|
+ Note that at this point Kamailio will still be writing all
|
|
|
data into the renamed files.
|
|
|
- * Send OpenSER the MI command to close and reopen the renamed
|
|
|
- files. For example, using FIFO:
|
|
|
+ * Send Kamailio the MI command to close and reopen the
|
|
|
+ renamed files. For example, using FIFO:
|
|
|
openserctl fifo flat_rotate
|
|
|
|
|
|
- This will force OpenSER to close the renamed files and open
|
|
|
- new ones with original names, such as acc_1.log. New files
|
|
|
- will be open at the point when OpenSER has some data to
|
|
|
- write. It is normal that the files will be not created
|
|
|
+ This will force Kamailio to close the renamed files and
|
|
|
+ open new ones with original names, such as acc_1.log. New
|
|
|
+ files will be open at the point when Kamailio has some data
|
|
|
+ to write. It is normal that the files will be not created
|
|
|
immediately if there is no traffic on the proxy server.
|
|
|
* Move the renamed files somewhere else and process them.
|
|
|
|
|
|
1.2. Dependencies
|
|
|
|
|
|
-1.2.1. OpenSER Modules
|
|
|
+1.2.1. Kamailio Modules
|
|
|
|
|
|
The following modules must be loaded before this module:
|
|
|
- * No dependencies on other OpenSER modules.
|
|
|
+ * No dependencies on other Kamailio modules.
|
|
|
|
|
|
1.2.2. External Libraries or Applications
|
|
|
|
|
|
The following libraries or applications must be installed
|
|
|
- before running OpenSER with this module loaded:
|
|
|
+ before running Kamailio with this module loaded:
|
|
|
* None.
|
|
|
|
|
|
1.3. Exported Parameters
|