Module: sip-router
Branch: janakj/flatstore
Commit: 0d5350a936bf90e3395d2439815cf57146a162c0
URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=0d5350a…
Author: Jan Janak <jan(a)iptel.org>
Committer: Jan Janak <jan(a)iptel.org>
Date: Wed Feb 18 16:33:42 2009 +0100
Remove km_Makefile and km_README.
---
modules/db_flatstore/km_Makefile | 10 --
modules/db_flatstore/km_README | 168 --------------------------------------
2 files changed, 0 insertions(+), 178 deletions(-)
diff --git a/modules/db_flatstore/km_Makefile b/modules/db_flatstore/km_Makefile
deleted file mode 100644
index 6cd413c..0000000
--- a/modules/db_flatstore/km_Makefile
+++ /dev/null
@@ -1,10 +0,0 @@
-# $Id$
-#
-# WARNING: do not run this directly, it should be run by the master Makefile
-
-include ../../Makefile.defs
-auto_gen=
-NAME=db_flatstore.so
-LIBS=
-
-include ../../Makefile.modules
diff --git a/modules/db_flatstore/km_README b/modules/db_flatstore/km_README
deleted file mode 100644
index ee2427f..0000000
--- a/modules/db_flatstore/km_README
+++ /dev/null
@@ -1,168 +0,0 @@
-Flatstore Module
-
-Jan Janak
-
- FhG FOKUS
-
-Edited by
-
-Jan Janak
-
- Copyright � 2004, 2005 FhG FOKUS
- Revision History
- Revision $Revision$ $Date: 2008-08-06 12:08:33 +0200
- (Mi, 06 Aug 2008) $
- __________________________________________________________
-
- Table of Contents
-
- 1. Admin Guide
-
- 1.1. Overview
-
- 1.1.1. Rotating Log Files
-
- 1.2. Dependencies
-
- 1.2.1. Kamailio Modules
- 1.2.2. External Libraries or Applications
-
- 1.3. Exported Parameters
-
- 1.3.1. flush (integer)
-
- 1.4. Exported Functions
- 1.5. Exported MI Functions
-
- 1.5.1. flat_rotate
-
- 2. Developer Guide
-
- List of Examples
-
- 1.1. Set "flush" parameter
-
-Chapter 1. Admin Guide
-
-1.1. Overview
-
- 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.
-
- The module does not export all functions of the database API,
- it supports only one function, insert. The module is limited
- but very fast. It is especially suitable for storing accounting
- information on sites with extremely high traffic. If MySQL is
- too slow or if you get a huge amount of accounting data then
- you can consider using this module. Note that the acc module is
- the only module that was tested with flastore.
-
- The format of the files produced by this module is plain text.
- Each line consists of several fields, fields are separated by |
- character. New information is always appended at the end of the
- file, searching, deleting and updating of existing data is not
- supported by the module.
-
- The acc module can be configured to use flatstore module as
- database backend using the db_url_parameter:
-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
- 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 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 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 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:
- * Rename the files that you want to rotate:
-cd /var/log/acc
-mv acc_1.log acc_1.log.20050605
-mv acc_2.log acc_2.log.20050605
-mv acc_4.log acc_3.log.20050605
-...
-
- Note that at this point Kamailio will still be writing all
- data into the renamed files.
- * Send Kamailio the MI command to close and reopen the
- renamed files. For example, using FIFO:
-kamctl fifo flat_rotate
-
- 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. Kamailio Modules
-
- The following modules must be loaded before this module:
- * No dependencies on other Kamailio modules.
-
-1.2.2. External Libraries or Applications
-
- The following libraries or applications must be installed
- before running Kamailio with this module loaded:
- * None.
-
-1.3. Exported Parameters
-
-1.3.1. flush (integer)
-
- Enable or disable flushing after each write.
-
- Default value is 1.
-
- Example 1.1. Set "flush" parameter
-...
-modparam("db_flatstore", "flush", 0)
-...
-
-1.4. Exported Functions
-
- There are no function exported to routing script.
-
-1.5. Exported MI Functions
-
-1.5.1. flat_rotate
-
- It changes the name of the files where it is written.
-
- Name: flat_rotate
-
- Parameters: none
-
- MI FIFO Command Format:
- :flat_rotate:_reply_fifo_file_
- _empty_line_
-
-Chapter 2. Developer Guide
-
- The module implements the DB API.
Module: sip-router
Branch: janakj/flatstore
Commit: ffb2f540c9c7865cf44308697d623995294933b7
URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=ffb2f54…
Author: Jan Janak <jan(a)iptel.org>
Committer: Jan Janak <jan(a)iptel.org>
Date: Wed Feb 18 15:01:08 2009 +0100
Merge branch 'master' of ssh://janakj@git.sip-router.org/sip-router into flatstore
* 'master' of ssh://janakj@git.sip-router.org/sip-router: (119 commits)
Integrate functions and parameters from kamailio sources.
Ignore emacs backup and lock files.
Various changes to get rid of conflicts and make km_ files compile.
Fixed matching of db flags names at the beginning of line.
Two small fixes in regular expressions.
Module renamed to db_postgres.
Merged contents of km_Makefile (namely pg_config autodetection).
Removed km_Makefile and km_README.
Updated filenames of locally includede header files
Align defines protecting headers with filenames.
Link with both srdb1 and srdb2
SER to sip-router module conversion script.
Kamailio to sip-router module conversion script.
Remove compiler warning about uninitialized variable.
Make the module compile in the sip-router tree.
- fix regression during value conversion when input SQL string is NULL,
- another error condition fix for a problem that gets introduced by a
- add one DBG log to each drivers error condition, that the mem is freed
- improve two errors messages, inform the user that the query is aborted
- db_postgres_convert_rows needs to free the row_buf on all error conditions
...
---
Module: sip-router
Branch: janakj/flatstore
Commit: 2400cb07e16f3e2b237130b83b2a6e6fb76fe370
URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=2400cb0…
Author: Jan Janak <jan(a)iptel.org>
Committer: Jan Janak <jan(a)iptel.org>
Date: Wed Feb 18 16:17:48 2009 +0100
Merge branch kamailio/trunk/db_flatstore into sip-router/janakj/db_flatstore.
* kamailio/trunk/db_flatstore: (23 commits)
- disable big integer (DB_BIGINT) support for non SQL DB modules for now
- don't link with unnecessary libs, related to bug #1855859
- fix link entity names, patch from Carsten Gross
- rebuilt default READMEs
- renaming: changed entities in documentation
- renaming scripts part 1
- fix some FAQ entries, change missing entity, regenerate READMEs
- change name in copyright headers
- fixed bug in keeping the dir path for the flatstore files - as the path is a substring of the DB URL, we need to explicitly allocate a str structure for it; otherwise we will randomly write in memory :D
- titles for admin, devel and faq chapters are defined via entities for coherence and easier management
- updated old entity names
- content of faq removed (mistakenly added by me after Henning did the cleanup for modules' docs; rev 3839)
- entity &user; replaced with &admin; to obey naming structure (entities to be replaced by xinclude); updated obsolete address tags
- re-sync READMEs after last updates
- step 2 for the rest of modules to re-link history from sgml to xml files
- step 1 for the rest of modules to re-link history from sgml to xml files
- modules documentation migrated from sgml to xml docbook format
- migrated to db_bind_api()
- change module docs FAQ link to a common one in the doc dir
- first round of cleanups for documentation
...
---