|
@@ -41,7 +41,7 @@ Will Quan
|
|
|
1.9. METADATA_KEYS (required)
|
|
|
1.10. METADATA_READONLY (optional)
|
|
|
1.11. METADATA_LOGFLAGS (optional)
|
|
|
- 1.12. DB Maintaince Script : openserdbctl
|
|
|
+ 1.12. DB Maintaince Script : kamdbctl
|
|
|
1.13. DB Recovery : bdb_recover
|
|
|
1.14. Known Limitations
|
|
|
|
|
@@ -55,7 +55,7 @@ Will Quan
|
|
|
1.6. METADATA_COLUMNS
|
|
|
1.7. METADATA_KEYS
|
|
|
1.8. METADATA_LOGFLAGS
|
|
|
- 1.9. openserdbctl
|
|
|
+ 1.9. kamdbctl
|
|
|
1.10. bdb_recover usage
|
|
|
|
|
|
Chapter 1. Admin Guide
|
|
@@ -147,7 +147,7 @@ modparam("db_berkeley", "journal_roll_interval", 3600)
|
|
|
Parameters: tablename (or db_path); to reload a particular
|
|
|
table provide the tablename as the arguement (eg subscriber);
|
|
|
to reload all tables provide the db_path to the db files. The
|
|
|
- path can be found in openserctlrc DB_PATH variable.
|
|
|
+ path can be found in kamctlrc DB_PATH variable.
|
|
|
|
|
|
1.6. Installation and Running
|
|
|
|
|
@@ -175,18 +175,18 @@ modparam("db_berkeley", "journal_roll_interval", 3600)
|
|
|
install as root user of the main directory. This will install
|
|
|
the binaries in /usr/local/sbin/. If this was successful,
|
|
|
openser control engine files should now be installed as
|
|
|
- /usr/local/sbin/openserdbctl.
|
|
|
+ /usr/local/sbin/kamdbctl.
|
|
|
|
|
|
Decide where (on the filesystem) you want to install the
|
|
|
Berkeley DB files. For instance,
|
|
|
'/usr/local/etc/openser/db_berkeley' directory. Make note of
|
|
|
- this directory as we need to add this path to the openserctlrc
|
|
|
+ this directory as we need to add this path to the kamctlrc
|
|
|
file. Note: OpenSER will not startup without these DB files.
|
|
|
|
|
|
- Edit openserctlrc - There are two parameters in this file that
|
|
|
+ Edit kamctlrc - There are two parameters in this file that
|
|
|
should be configured before openserctrdb script can work
|
|
|
properly: DBENGINE and DB_PATH. Edit file:
|
|
|
- '/usr/local/etc/openser/openserctlrc'
|
|
|
+ '/usr/local/etc/openser/kamctlrc'
|
|
|
## database type: MYSQL, PGSQL, DB_BERKELEY, or DBTEXT,
|
|
|
by default none is loaded
|
|
|
# DBENGINE=DB_BERKELEY
|
|
@@ -209,11 +209,11 @@ by default none is loaded
|
|
|
METADATA_LOGFLAGS
|
|
|
0
|
|
|
|
|
|
- Execute openserdbctl - There are three (3) groups of tables you
|
|
|
+ Execute kamdbctl - There are three (3) groups of tables you
|
|
|
may need depending on your situation.
|
|
|
- openserdbctl create (required)
|
|
|
- openserdbctl presence (optional)
|
|
|
- openserdbctl extra (optional)
|
|
|
+ kamdbctl create (required)
|
|
|
+ kamdbctl presence (optional)
|
|
|
+ kamdbctl extra (optional)
|
|
|
|
|
|
Modify the OpenSER configuration file to use db_berkeley
|
|
|
module. The database URL for modules must be the path to the
|
|
@@ -248,7 +248,7 @@ by default none is loaded
|
|
|
|
|
|
1.7. Database Schema and Metadata
|
|
|
|
|
|
- All Berkeley DB tables are created via the openserdbctl script.
|
|
|
+ All Berkeley DB tables are created via the kamdbctl script.
|
|
|
This section provides details as to the content and format of
|
|
|
the DB file upon creation.
|
|
|
|
|
@@ -396,28 +396,28 @@ r) last_name(str) email_address(str) datetime_created(datetime) timezone
|
|
|
and syslog the value should be set to 1+16=17. Or if you do not
|
|
|
want to journal at all, set this to 0.
|
|
|
|
|
|
-1.12. DB Maintaince Script : openserdbctl
|
|
|
+1.12. DB Maintaince Script : kamdbctl
|
|
|
|
|
|
- Use the openserdbctl script for maintaining OpenSER Berkeley DB
|
|
|
+ Use the kamdbctl script for maintaining OpenSER Berkeley DB
|
|
|
tables. This script assumes you have DBENGINE and DB_PATH setup
|
|
|
- correctly in openserctlrc. Note Unsupported commands are-
|
|
|
+ correctly in kamctlrc. Note Unsupported commands are-
|
|
|
backup, restore, migrate, copy, serweb.
|
|
|
|
|
|
- Example 1.9. openserdbctl
|
|
|
-usage: openserdbctl create
|
|
|
- openserdbctl presence
|
|
|
- openserdbctl extra
|
|
|
- openserdbctl drop
|
|
|
- openserdbctl reinit
|
|
|
- openserdbctl bdb list (lists the underlying db files in D
|
|
|
+ Example 1.9. kamdbctl
|
|
|
+usage: kamdbctl create
|
|
|
+ kamdbctl presence
|
|
|
+ kamdbctl extra
|
|
|
+ kamdbctl drop
|
|
|
+ kamdbctl reinit
|
|
|
+ kamdbctl bdb list (lists the underlying db files in D
|
|
|
B_PATH)
|
|
|
- openserdbctl bdb cat db (prints the contents of db file to
|
|
|
+ kamdbctl bdb cat db (prints the contents of db file to
|
|
|
STDOUT in plain-text)
|
|
|
- openserdbctl bdb swap db (installs db.new by db -> db.old; d
|
|
|
+ kamdbctl bdb swap db (installs db.new by db -> db.old; d
|
|
|
b.new -> db)
|
|
|
- openserdbctl bdb append db datafile (appends data to a new ins
|
|
|
+ kamdbctl bdb append db datafile (appends data to a new ins
|
|
|
tance of db; output DB_PATH/db.new)
|
|
|
- openserdbctl bdb newappend db datafile (appends data to a new ins
|
|
|
+ kamdbctl bdb newappend db datafile (appends data to a new ins
|
|
|
tance of db; output DB_PATH/db.new)
|
|
|
|
|
|
1.13. DB Recovery : bdb_recover
|