git-svn-id: https://openser.svn.sourceforge.net/svnroot/openser/trunk@4571 689a6050-402a-0410-94f2-e92a70836424
... | ... |
@@ -873,7 +873,7 @@ reply_code, dstavp) |
873 | 873 |
|
874 | 874 |
Example 1.38. cr_replace_host usage |
875 | 875 |
... |
876 |
-openserctl fifo cr_replace_host "-d proxy -p 49 -h proxy1 -t proxy2" |
|
876 |
+kamctl fifo cr_replace_host "-d proxy -p 49 -h proxy1 -t proxy2" |
|
877 | 877 |
... |
878 | 878 |
|
879 | 879 |
1.5.4. cr_deactivate_host |
... | ... |
@@ -895,7 +895,7 @@ openserctl fifo cr_replace_host "-d proxy -p 49 -h proxy1 -t proxy2" |
895 | 895 |
|
896 | 896 |
Example 1.39. cr_deactivate_host usage |
897 | 897 |
... |
898 |
-openserctl fifo cr_deactivate_host "-d proxy -p 49 -h proxy1" |
|
898 |
+kamctl fifo cr_deactivate_host "-d proxy -p 49 -h proxy1" |
|
899 | 899 |
... |
900 | 900 |
|
901 | 901 |
1.5.5. cr_activate_host |
... | ... |
@@ -911,7 +911,7 @@ openserctl fifo cr_deactivate_host "-d proxy -p 49 -h proxy1" |
911 | 911 |
|
912 | 912 |
Example 1.40. cr_activate_host usage |
913 | 913 |
... |
914 |
-openserctl fifo cr_activate_host "-d proxy -p 49 -h proxy1" |
|
914 |
+kamctl fifo cr_activate_host "-d proxy -p 49 -h proxy1" |
|
915 | 915 |
... |
916 | 916 |
|
917 | 917 |
1.5.6. cr_add_host |
... | ... |
@@ -931,7 +931,7 @@ openserctl fifo cr_activate_host "-d proxy -p 49 -h proxy1" |
931 | 931 |
|
932 | 932 |
Example 1.41. cr_add_host usage |
933 | 933 |
... |
934 |
-openserctl fifo cr_add_host "-d proxy -p 49 -h proxy1 -w 0.25" |
|
934 |
+kamctl fifo cr_add_host "-d proxy -p 49 -h proxy1 -w 0.25" |
|
935 | 935 |
... |
936 | 936 |
|
937 | 937 |
1.5.7. cr_delete_host |
... | ... |
@@ -952,7 +952,7 @@ openserctl fifo cr_add_host "-d proxy -p 49 -h proxy1 -w 0.25" |
952 | 952 |
|
953 | 953 |
Example 1.42. cr_delete_host usage |
954 | 954 |
... |
955 |
-openserctl fifo cr_delete_host "-d proxy -p 49 -h proxy1 -w 0.25" |
|
955 |
+kamctl fifo cr_delete_host "-d proxy -p 49 -h proxy1 -w 0.25" |
|
956 | 956 |
... |
957 | 957 |
|
958 | 958 |
1.6. Examples |
... | ... |
@@ -1169,7 +1169,7 @@ cr_tree_rewrite_uri(tree, domain) |
1169 | 1169 |
<title><function>cr_replace_host</function> usage</title> |
1170 | 1170 |
<programlisting format="linespecific"> |
1171 | 1171 |
... |
1172 |
-openserctl fifo cr_replace_host "-d proxy -p 49 -h proxy1 -t proxy2" |
|
1172 |
+kamctl fifo cr_replace_host "-d proxy -p 49 -h proxy1 -t proxy2" |
|
1173 | 1173 |
... |
1174 | 1174 |
</programlisting> |
1175 | 1175 |
</example> |
... | ... |
@@ -1202,7 +1202,7 @@ openserctl fifo cr_replace_host "-d proxy -p 49 -h proxy1 -t proxy2" |
1202 | 1202 |
<title><function>cr_deactivate_host</function> usage</title> |
1203 | 1203 |
<programlisting format="linespecific"> |
1204 | 1204 |
... |
1205 |
-openserctl fifo cr_deactivate_host "-d proxy -p 49 -h proxy1" |
|
1205 |
+kamctl fifo cr_deactivate_host "-d proxy -p 49 -h proxy1" |
|
1206 | 1206 |
... |
1207 | 1207 |
</programlisting> |
1208 | 1208 |
</example> |
... | ... |
@@ -1229,7 +1229,7 @@ openserctl fifo cr_deactivate_host "-d proxy -p 49 -h proxy1" |
1229 | 1229 |
<title><function>cr_activate_host</function> usage</title> |
1230 | 1230 |
<programlisting format="linespecific"> |
1231 | 1231 |
... |
1232 |
-openserctl fifo cr_activate_host "-d proxy -p 49 -h proxy1" |
|
1232 |
+kamctl fifo cr_activate_host "-d proxy -p 49 -h proxy1" |
|
1233 | 1233 |
... |
1234 | 1234 |
</programlisting> |
1235 | 1235 |
</example> |
... | ... |
@@ -1272,7 +1272,7 @@ openserctl fifo cr_activate_host "-d proxy -p 49 -h proxy1" |
1272 | 1272 |
<title><function>cr_add_host</function> usage</title> |
1273 | 1273 |
<programlisting format="linespecific"> |
1274 | 1274 |
... |
1275 |
-openserctl fifo cr_add_host "-d proxy -p 49 -h proxy1 -w 0.25" |
|
1275 |
+kamctl fifo cr_add_host "-d proxy -p 49 -h proxy1 -w 0.25" |
|
1276 | 1276 |
... |
1277 | 1277 |
</programlisting> |
1278 | 1278 |
</example> |
... | ... |
@@ -1316,7 +1316,7 @@ openserctl fifo cr_add_host "-d proxy -p 49 -h proxy1 -w 0.25" |
1316 | 1316 |
<title><function>cr_delete_host</function> usage</title> |
1317 | 1317 |
<programlisting format="linespecific"> |
1318 | 1318 |
... |
1319 |
-openserctl fifo cr_delete_host "-d proxy -p 49 -h proxy1 -w 0.25" |
|
1319 |
+kamctl fifo cr_delete_host "-d proxy -p 49 -h proxy1 -w 0.25" |
|
1320 | 1320 |
... |
1321 | 1321 |
</programlisting> |
1322 | 1322 |
</example> |
... | ... |
@@ -334,7 +334,7 @@ shm_status(); |
334 | 334 |
|
335 | 335 |
Example 1.14. rand_set_prob usage |
336 | 336 |
... |
337 |
-$ openserctl fifo rand_set_prob 10 |
|
337 |
+$ kamctl fifo rand_set_prob 10 |
|
338 | 338 |
... |
339 | 339 |
|
340 | 340 |
1.5.2. rand_reset_prob |
... | ... |
@@ -345,7 +345,7 @@ $ openserctl fifo rand_set_prob 10 |
345 | 345 |
|
346 | 346 |
Example 1.15. rand_reset_prob usage |
347 | 347 |
... |
348 |
-$ openserctl fifo rand_reset_prob |
|
348 |
+$ kamctl fifo rand_reset_prob |
|
349 | 349 |
... |
350 | 350 |
|
351 | 351 |
1.5.3. rand_get_prob |
... | ... |
@@ -356,7 +356,7 @@ $ openserctl fifo rand_reset_prob |
356 | 356 |
|
357 | 357 |
Example 1.16. rand_get_prob usage |
358 | 358 |
... |
359 |
-$ openserctl fifo get_prob |
|
359 |
+$ kamctl fifo get_prob |
|
360 | 360 |
The actual probability is 50 percent. |
361 | 361 |
... |
362 | 362 |
|
... | ... |
@@ -372,7 +372,7 @@ The actual probability is 50 percent. |
372 | 372 |
|
373 | 373 |
Example 1.17. check_config_hash usage |
374 | 374 |
... |
375 |
-$ openserctl fifo check_config_hash |
|
375 |
+$ kamctl fifo check_config_hash |
|
376 | 376 |
The actual config file hash is identical to the stored one. |
377 | 377 |
... |
378 | 378 |
|
... | ... |
@@ -385,7 +385,7 @@ The actual config file hash is identical to the stored one. |
385 | 385 |
|
386 | 386 |
Example 1.18. get_config_hash usage |
387 | 387 |
... |
388 |
-$ openserctl fifo get_config_hash |
|
388 |
+$ kamctl fifo get_config_hash |
|
389 | 389 |
1580a37104eb4de69ab9f31ce8d6e3e0 |
390 | 390 |
... |
391 | 391 |
|
... | ... |
@@ -409,7 +409,7 @@ $ openserctl fifo get_config_hash |
409 | 409 |
|
410 | 410 |
Example 1.19. shv_set usage |
411 | 411 |
... |
412 |
-$ openserctl fifo shv_set debug int 0 |
|
412 |
+$ kamctl fifo shv_set debug int 0 |
|
413 | 413 |
... |
414 | 414 |
|
415 | 415 |
1.5.7. shv_get |
... | ... |
@@ -427,8 +427,8 @@ $ openserctl fifo shv_set debug int 0 |
427 | 427 |
|
428 | 428 |
Example 1.20. shv_get usage |
429 | 429 |
... |
430 |
-$ openserctl fifo shv_get debug |
|
431 |
-$ openserctl fifo shv_get |
|
430 |
+$ kamctl fifo shv_get debug |
|
431 |
+$ kamctl fifo shv_get |
|
432 | 432 |
... |
433 | 433 |
|
434 | 434 |
1.6. Exported pseudo-variables |
... | ... |
@@ -382,7 +382,7 @@ shm_status(); |
382 | 382 |
<title><function moreinfo="none">rand_set_prob</function> usage</title> |
383 | 383 |
<programlisting format="linespecific"> |
384 | 384 |
... |
385 |
-$ openserctl fifo rand_set_prob 10 |
|
385 |
+$ kamctl fifo rand_set_prob 10 |
|
386 | 386 |
... |
387 | 387 |
</programlisting> |
388 | 388 |
</example> |
... | ... |
@@ -401,7 +401,7 @@ $ openserctl fifo rand_set_prob 10 |
401 | 401 |
<function moreinfo="none">rand_reset_prob</function> usage</title> |
402 | 402 |
<programlisting format="linespecific"> |
403 | 403 |
... |
404 |
-$ openserctl fifo rand_reset_prob |
|
404 |
+$ kamctl fifo rand_reset_prob |
|
405 | 405 |
... |
406 | 406 |
</programlisting> |
407 | 407 |
</example> |
... | ... |
@@ -418,7 +418,7 @@ $ openserctl fifo rand_reset_prob |
418 | 418 |
<title><function moreinfo="none">rand_get_prob</function> usage</title> |
419 | 419 |
<programlisting format="linespecific"> |
420 | 420 |
... |
421 |
-$ openserctl fifo get_prob |
|
421 |
+$ kamctl fifo get_prob |
|
422 | 422 |
The actual probability is 50 percent. |
423 | 423 |
... |
424 | 424 |
</programlisting> |
... | ... |
@@ -438,7 +438,7 @@ The actual probability is 50 percent. |
438 | 438 |
<title><function moreinfo="none">check_config_hash</function> usage</title> |
439 | 439 |
<programlisting format="linespecific"> |
440 | 440 |
... |
441 |
-$ openserctl fifo check_config_hash |
|
441 |
+$ kamctl fifo check_config_hash |
|
442 | 442 |
The actual config file hash is identical to the stored one. |
443 | 443 |
... |
444 | 444 |
</programlisting> |
... | ... |
@@ -457,7 +457,7 @@ The actual config file hash is identical to the stored one. |
457 | 457 |
<title><function moreinfo="none">get_config_hash</function> usage</title> |
458 | 458 |
<programlisting format="linespecific"> |
459 | 459 |
... |
460 |
-$ openserctl fifo get_config_hash |
|
460 |
+$ kamctl fifo get_config_hash |
|
461 | 461 |
1580a37104eb4de69ab9f31ce8d6e3e0 |
462 | 462 |
... |
463 | 463 |
</programlisting> |
... | ... |
@@ -495,7 +495,7 @@ $ openserctl fifo get_config_hash |
495 | 495 |
<title><function moreinfo="none">shv_set</function> usage</title> |
496 | 496 |
<programlisting format="linespecific"> |
497 | 497 |
... |
498 |
-$ openserctl fifo shv_set debug int 0 |
|
498 |
+$ kamctl fifo shv_set debug int 0 |
|
499 | 499 |
... |
500 | 500 |
</programlisting> |
501 | 501 |
</example> |
... | ... |
@@ -522,8 +522,8 @@ $ openserctl fifo shv_set debug int 0 |
522 | 522 |
<title><function moreinfo="none">shv_get</function> usage</title> |
523 | 523 |
<programlisting format="linespecific"> |
524 | 524 |
... |
525 |
-$ openserctl fifo shv_get debug |
|
526 |
-$ openserctl fifo shv_get |
|
525 |
+$ kamctl fifo shv_get debug |
|
526 |
+$ kamctl fifo shv_get |
|
527 | 527 |
... |
528 | 528 |
</programlisting> |
529 | 529 |
</example> |
... | ... |
@@ -41,7 +41,7 @@ Will Quan |
41 | 41 |
1.9. METADATA_KEYS (required) |
42 | 42 |
1.10. METADATA_READONLY (optional) |
43 | 43 |
1.11. METADATA_LOGFLAGS (optional) |
44 |
- 1.12. DB Maintaince Script : openserdbctl |
|
44 |
+ 1.12. DB Maintaince Script : kamdbctl |
|
45 | 45 |
1.13. DB Recovery : bdb_recover |
46 | 46 |
1.14. Known Limitations |
47 | 47 |
|
... | ... |
@@ -55,7 +55,7 @@ Will Quan |
55 | 55 |
1.6. METADATA_COLUMNS |
56 | 56 |
1.7. METADATA_KEYS |
57 | 57 |
1.8. METADATA_LOGFLAGS |
58 |
- 1.9. openserdbctl |
|
58 |
+ 1.9. kamdbctl |
|
59 | 59 |
1.10. bdb_recover usage |
60 | 60 |
|
61 | 61 |
Chapter 1. Admin Guide |
... | ... |
@@ -147,7 +147,7 @@ modparam("db_berkeley", "journal_roll_interval", 3600) |
147 | 147 |
Parameters: tablename (or db_path); to reload a particular |
148 | 148 |
table provide the tablename as the arguement (eg subscriber); |
149 | 149 |
to reload all tables provide the db_path to the db files. The |
150 |
- path can be found in openserctlrc DB_PATH variable. |
|
150 |
+ path can be found in kamctlrc DB_PATH variable. |
|
151 | 151 |
|
152 | 152 |
1.6. Installation and Running |
153 | 153 |
|
... | ... |
@@ -175,18 +175,18 @@ modparam("db_berkeley", "journal_roll_interval", 3600) |
175 | 175 |
install as root user of the main directory. This will install |
176 | 176 |
the binaries in /usr/local/sbin/. If this was successful, |
177 | 177 |
openser control engine files should now be installed as |
178 |
- /usr/local/sbin/openserdbctl. |
|
178 |
+ /usr/local/sbin/kamdbctl. |
|
179 | 179 |
|
180 | 180 |
Decide where (on the filesystem) you want to install the |
181 | 181 |
Berkeley DB files. For instance, |
182 | 182 |
'/usr/local/etc/openser/db_berkeley' directory. Make note of |
183 |
- this directory as we need to add this path to the openserctlrc |
|
183 |
+ this directory as we need to add this path to the kamctlrc |
|
184 | 184 |
file. Note: OpenSER will not startup without these DB files. |
185 | 185 |
|
186 |
- Edit openserctlrc - There are two parameters in this file that |
|
186 |
+ Edit kamctlrc - There are two parameters in this file that |
|
187 | 187 |
should be configured before openserctrdb script can work |
188 | 188 |
properly: DBENGINE and DB_PATH. Edit file: |
189 |
- '/usr/local/etc/openser/openserctlrc' |
|
189 |
+ '/usr/local/etc/openser/kamctlrc' |
|
190 | 190 |
## database type: MYSQL, PGSQL, DB_BERKELEY, or DBTEXT, |
191 | 191 |
by default none is loaded |
192 | 192 |
# DBENGINE=DB_BERKELEY |
... | ... |
@@ -209,11 +209,11 @@ by default none is loaded |
209 | 209 |
METADATA_LOGFLAGS |
210 | 210 |
0 |
211 | 211 |
|
212 |
- Execute openserdbctl - There are three (3) groups of tables you |
|
212 |
+ Execute kamdbctl - There are three (3) groups of tables you |
|
213 | 213 |
may need depending on your situation. |
214 |
- openserdbctl create (required) |
|
215 |
- openserdbctl presence (optional) |
|
216 |
- openserdbctl extra (optional) |
|
214 |
+ kamdbctl create (required) |
|
215 |
+ kamdbctl presence (optional) |
|
216 |
+ kamdbctl extra (optional) |
|
217 | 217 |
|
218 | 218 |
Modify the OpenSER configuration file to use db_berkeley |
219 | 219 |
module. The database URL for modules must be the path to the |
... | ... |
@@ -248,7 +248,7 @@ by default none is loaded |
248 | 248 |
|
249 | 249 |
1.7. Database Schema and Metadata |
250 | 250 |
|
251 |
- All Berkeley DB tables are created via the openserdbctl script. |
|
251 |
+ All Berkeley DB tables are created via the kamdbctl script. |
|
252 | 252 |
This section provides details as to the content and format of |
253 | 253 |
the DB file upon creation. |
254 | 254 |
|
... | ... |
@@ -396,28 +396,28 @@ r) last_name(str) email_address(str) datetime_created(datetime) timezone |
396 | 396 |
and syslog the value should be set to 1+16=17. Or if you do not |
397 | 397 |
want to journal at all, set this to 0. |
398 | 398 |
|
399 |
-1.12. DB Maintaince Script : openserdbctl |
|
399 |
+1.12. DB Maintaince Script : kamdbctl |
|
400 | 400 |
|
401 |
- Use the openserdbctl script for maintaining OpenSER Berkeley DB |
|
401 |
+ Use the kamdbctl script for maintaining OpenSER Berkeley DB |
|
402 | 402 |
tables. This script assumes you have DBENGINE and DB_PATH setup |
403 |
- correctly in openserctlrc. Note Unsupported commands are- |
|
403 |
+ correctly in kamctlrc. Note Unsupported commands are- |
|
404 | 404 |
backup, restore, migrate, copy, serweb. |
405 | 405 |
|
406 |
- Example 1.9. openserdbctl |
|
407 |
-usage: openserdbctl create |
|
408 |
- openserdbctl presence |
|
409 |
- openserdbctl extra |
|
410 |
- openserdbctl drop |
|
411 |
- openserdbctl reinit |
|
412 |
- openserdbctl bdb list (lists the underlying db files in D |
|
406 |
+ Example 1.9. kamdbctl |
|
407 |
+usage: kamdbctl create |
|
408 |
+ kamdbctl presence |
|
409 |
+ kamdbctl extra |
|
410 |
+ kamdbctl drop |
|
411 |
+ kamdbctl reinit |
|
412 |
+ kamdbctl bdb list (lists the underlying db files in D |
|
413 | 413 |
B_PATH) |
414 |
- openserdbctl bdb cat db (prints the contents of db file to |
|
414 |
+ kamdbctl bdb cat db (prints the contents of db file to |
|
415 | 415 |
STDOUT in plain-text) |
416 |
- openserdbctl bdb swap db (installs db.new by db -> db.old; d |
|
416 |
+ kamdbctl bdb swap db (installs db.new by db -> db.old; d |
|
417 | 417 |
b.new -> db) |
418 |
- openserdbctl bdb append db datafile (appends data to a new ins |
|
418 |
+ kamdbctl bdb append db datafile (appends data to a new ins |
|
419 | 419 |
tance of db; output DB_PATH/db.new) |
420 |
- openserdbctl bdb newappend db datafile (appends data to a new ins |
|
420 |
+ kamdbctl bdb newappend db datafile (appends data to a new ins |
|
421 | 421 |
tance of db; output DB_PATH/db.new) |
422 | 422 |
|
423 | 423 |
1.13. DB Recovery : bdb_recover |
... | ... |
@@ -550,11 +550,11 @@ void bdblib_log(int op, table_p _tp, char* _msg, int len) |
550 | 550 |
* files (db) that we require. |
551 | 551 |
* |
552 | 552 |
* There is one db file per openser table (eg. acc), and they should exist |
553 |
- * in your DB_PATH (refer to openserctlrc) directory. |
|
553 |
+ * in your DB_PATH (refer to kamctlrc) directory. |
|
554 | 554 |
* |
555 | 555 |
* This function does _not_ create the underlying binary db tables. |
556 | 556 |
* Creating the tables MUST be manually performed before |
557 |
- * openser startup by 'openserdbctl create' |
|
557 |
+ * openser startup by 'kamdbctl create' |
|
558 | 558 |
* |
559 | 559 |
* Function returns NULL on error, which will cause openser to exit. |
560 | 560 |
* |
... | ... |
@@ -145,7 +145,7 @@ modparam("db_berkeley", "journal_roll_interval", 3600) |
145 | 145 |
|
146 | 146 |
<para>Parameters: <emphasis>tablename (or db_path); to reload a particular table |
147 | 147 |
provide the tablename as the arguement (eg subscriber); to reload all tables provide the db_path to |
148 |
- the db files. The path can be found in openserctlrc DB_PATH variable. |
|
148 |
+ the db files. The path can be found in kamctlrc DB_PATH variable. |
|
149 | 149 |
</emphasis></para> |
150 | 150 |
</section> |
151 | 151 |
</section> |
... | ... |
@@ -192,20 +192,20 @@ modparam("db_berkeley", "journal_roll_interval", 3600) |
192 | 192 |
as root user of the main directory. This will install the binaries |
193 | 193 |
in /usr/local/sbin/. |
194 | 194 |
If this was successful, openser control engine files should now |
195 |
- be installed as /usr/local/sbin/openserdbctl. |
|
195 |
+ be installed as /usr/local/sbin/kamdbctl. |
|
196 | 196 |
</para> |
197 | 197 |
|
198 | 198 |
<para> |
199 | 199 |
Decide where (on the filesystem) you want to install the Berkeley DB files. |
200 | 200 |
For instance, '/usr/local/etc/openser/db_berkeley' directory. |
201 |
- Make note of this directory as we need to add this path to the openserctlrc file. |
|
201 |
+ Make note of this directory as we need to add this path to the kamctlrc file. |
|
202 | 202 |
Note: OpenSER will not startup without these DB files. |
203 | 203 |
</para> |
204 | 204 |
|
205 | 205 |
<para> |
206 |
- Edit openserctlrc - There are two parameters in this file that should be |
|
206 |
+ Edit kamctlrc - There are two parameters in this file that should be |
|
207 | 207 |
configured before openserctrdb script can work properly: DBENGINE and DB_PATH. |
208 |
- Edit file: '/usr/local/etc/openser/openserctlrc' |
|
208 |
+ Edit file: '/usr/local/etc/openser/kamctlrc' |
|
209 | 209 |
</para> |
210 | 210 |
<programlisting format="linespecific"> |
211 | 211 |
## database type: MYSQL, PGSQL, DB_BERKELEY, or DBTEXT, by default none is loaded |
... | ... |
@@ -234,13 +234,13 @@ modparam("db_berkeley", "journal_roll_interval", 3600) |
234 | 234 |
|
235 | 235 |
|
236 | 236 |
<para> |
237 |
- Execute openserdbctl - There are three (3) groups of tables you may need depending |
|
237 |
+ Execute kamdbctl - There are three (3) groups of tables you may need depending |
|
238 | 238 |
on your situation. |
239 | 239 |
</para> |
240 | 240 |
<programlisting format="linespecific"> |
241 |
- openserdbctl create (required) |
|
242 |
- openserdbctl presence (optional) |
|
243 |
- openserdbctl extra (optional) |
|
241 |
+ kamdbctl create (required) |
|
242 |
+ kamdbctl presence (optional) |
|
243 |
+ kamdbctl extra (optional) |
|
244 | 244 |
</programlisting> |
245 | 245 |
|
246 | 246 |
<para> |
... | ... |
@@ -284,7 +284,7 @@ modparam("db_berkeley", "journal_roll_interval", 3600) |
284 | 284 |
<title>Database Schema and Metadata</title> |
285 | 285 |
|
286 | 286 |
<para> |
287 |
- All Berkeley DB tables are created via the openserdbctl script. |
|
287 |
+ All Berkeley DB tables are created via the kamdbctl script. |
|
288 | 288 |
This section provides details as to the content and |
289 | 289 |
format of the DB file upon creation. |
290 | 290 |
</para> |
... | ... |
@@ -488,25 +488,25 @@ username(str) domain(str) password(str) ha1(str) ha1b(str) first_name(str) last_ |
488 | 488 |
</section> |
489 | 489 |
|
490 | 490 |
<section> |
491 |
- <title>DB Maintaince Script : openserdbctl </title> |
|
491 |
+ <title>DB Maintaince Script : kamdbctl </title> |
|
492 | 492 |
|
493 | 493 |
<para> |
494 |
- Use the openserdbctl script for maintaining OpenSER Berkeley DB tables. |
|
495 |
- This script assumes you have DBENGINE and DB_PATH setup correctly in openserctlrc. |
|
494 |
+ Use the kamdbctl script for maintaining OpenSER Berkeley DB tables. |
|
495 |
+ This script assumes you have DBENGINE and DB_PATH setup correctly in kamctlrc. |
|
496 | 496 |
Note Unsupported commands are- backup, restore, migrate, copy, serweb. |
497 | 497 |
<example> |
498 |
- <title>openserdbctl</title> |
|
498 |
+ <title>kamdbctl</title> |
|
499 | 499 |
<programlisting> |
500 |
-usage: openserdbctl create |
|
501 |
- openserdbctl presence |
|
502 |
- openserdbctl extra |
|
503 |
- openserdbctl drop |
|
504 |
- openserdbctl reinit |
|
505 |
- openserdbctl bdb list (lists the underlying db files in DB_PATH) |
|
506 |
- openserdbctl bdb cat db (prints the contents of db file to STDOUT in plain-text) |
|
507 |
- openserdbctl bdb swap db (installs db.new by db -> db.old; db.new -> db) |
|
508 |
- openserdbctl bdb append db datafile (appends data to a new instance of db; output DB_PATH/db.new) |
|
509 |
- openserdbctl bdb newappend db datafile (appends data to a new instance of db; output DB_PATH/db.new) |
|
500 |
+usage: kamdbctl create |
|
501 |
+ kamdbctl presence |
|
502 |
+ kamdbctl extra |
|
503 |
+ kamdbctl drop |
|
504 |
+ kamdbctl reinit |
|
505 |
+ kamdbctl bdb list (lists the underlying db files in DB_PATH) |
|
506 |
+ kamdbctl bdb cat db (prints the contents of db file to STDOUT in plain-text) |
|
507 |
+ kamdbctl bdb swap db (installs db.new by db -> db.old; db.new -> db) |
|
508 |
+ kamdbctl bdb append db datafile (appends data to a new instance of db; output DB_PATH/db.new) |
|
509 |
+ kamdbctl bdb newappend db datafile (appends data to a new instance of db; output DB_PATH/db.new) |
|
510 | 510 |
</programlisting> |
511 | 511 |
</example> |
512 | 512 |
</para> |
... | ... |
@@ -110,7 +110,7 @@ mv acc_4.log acc_3.log.20050605 |
110 | 110 |
data into the renamed files. |
111 | 111 |
* Send Kamailio the MI command to close and reopen the |
112 | 112 |
renamed files. For example, using FIFO: |
113 |
-openserctl fifo flat_rotate |
|
113 |
+kamctl fifo flat_rotate |
|
114 | 114 |
|
115 | 115 |
This will force Kamailio to close the renamed files and |
116 | 116 |
open new ones with original names, such as acc_1.log. New |
... | ... |
@@ -88,7 +88,7 @@ mv acc_4.log acc_3.log.20050605 |
88 | 88 |
Send &openser; the MI command to close and reopen the |
89 | 89 |
renamed files. For example, using FIFO: |
90 | 90 |
<screen> |
91 |
-openserctl fifo flat_rotate |
|
91 |
+kamctl fifo flat_rotate |
|
92 | 92 |
</screen> |
93 | 93 |
This will force &openser; to close the renamed files and open |
94 | 94 |
new ones with original names, such as |
... | ... |
@@ -128,7 +128,7 @@ modparam("db_oracle", "reconnect", 0.5) |
128 | 128 |
|
129 | 129 |
1.6. Utility openser_orasel |
130 | 130 |
|
131 |
- For working with openserctl script, should be able to print the |
|
131 |
+ For working with kamctl script, should be able to print the |
|
132 | 132 |
'query' results to the terminal in a user-readable form. The |
133 | 133 |
standard command-line Oracle client (sqlplus) is not quite |
134 | 134 |
suitable for this, as it cannot align row width to real |
... | ... |
@@ -136,7 +136,7 @@ modparam("db_oracle", "reconnect", 0.5) |
136 | 136 |
<section> |
137 | 137 |
<title>Utility openser_orasel</title> |
138 | 138 |
<para> |
139 |
- For working with openserctl script, should be able to print the 'query' |
|
139 |
+ For working with kamctl script, should be able to print the 'query' |
|
140 | 140 |
results to the terminal in a user-readable form. The standard command-line |
141 | 141 |
Oracle client (sqlplus) is not quite suitable for this, as it cannot align |
142 | 142 |
row width to real (received) data's (it always prints a cell width as |
... | ... |
@@ -445,7 +445,7 @@ int init_ds_db(void) |
445 | 445 |
} else if (_ds_table_version != DS_TABLE_VERSION |
446 | 446 |
&& _ds_table_version != DS_TABLE_VERSION2) { |
447 | 447 |
LM_ERR("invalid table version (found %d , required %d or %d)\n" |
448 |
- "(use openserdbctl reinit)\n", |
|
448 |
+ "(use kamdbctl reinit)\n", |
|
449 | 449 |
_ds_table_version, DS_TABLE_VERSION, DS_TABLE_VERSION2 ); |
450 | 450 |
return -1; |
451 | 451 |
} |
... | ... |
@@ -149,8 +149,8 @@ if(is_gflag("4")) |
149 | 149 |
|
150 | 150 |
Example 1.5. set_gflag usage |
151 | 151 |
... |
152 |
-$ openserctl fifo set_gflag 1 |
|
153 |
-$ openserctl fifo set_gflag 0x3 |
|
152 |
+$ kamctl fifo set_gflag 1 |
|
153 |
+$ kamctl fifo set_gflag 0x3 |
|
154 | 154 |
... |
155 | 155 |
|
156 | 156 |
1.5.2. reset_gflag |
... | ... |
@@ -161,8 +161,8 @@ $ openserctl fifo set_gflag 0x3 |
161 | 161 |
|
162 | 162 |
Example 1.6. reset_gflag usage |
163 | 163 |
... |
164 |
-$ openserctl fifo reset_gflag 1 |
|
165 |
-$ openserctl fifo reset_gflag 0x3 |
|
164 |
+$ kamctl fifo reset_gflag 1 |
|
165 |
+$ kamctl fifo reset_gflag 0x3 |
|
166 | 166 |
... |
167 | 167 |
|
168 | 168 |
1.5.3. is_gflag |
... | ... |
@@ -174,19 +174,19 @@ $ openserctl fifo reset_gflag 0x3 |
174 | 174 |
|
175 | 175 |
Example 1.7. is_gflag usage |
176 | 176 |
... |
177 |
-$ openserctl fifo set_gflag 1024 |
|
178 |
-$ openserctl fifo is_gflag 1024 |
|
177 |
+$ kamctl fifo set_gflag 1024 |
|
178 |
+$ kamctl fifo is_gflag 1024 |
|
179 | 179 |
TRUE |
180 |
-$ openserctl fifo is_gflag 1025 |
|
180 |
+$ kamctl fifo is_gflag 1025 |
|
181 | 181 |
TRUE |
182 |
-$ openserctl fifo is_gflag 1023 |
|
182 |
+$ kamctl fifo is_gflag 1023 |
|
183 | 183 |
FALSE |
184 |
-$ openserctl fifo set_gflag 0x10 |
|
185 |
-$ openserctl fifo is_gflag 1023 |
|
184 |
+$ kamctl fifo set_gflag 0x10 |
|
185 |
+$ kamctl fifo is_gflag 1023 |
|
186 | 186 |
TRUE |
187 |
-$ openserctl fifo is_gflag 1007 |
|
187 |
+$ kamctl fifo is_gflag 1007 |
|
188 | 188 |
FALSE |
189 |
-$ openserctl fifo is_gflag 16 |
|
189 |
+$ kamctl fifo is_gflag 16 |
|
190 | 190 |
TRUE |
191 | 191 |
... |
192 | 192 |
|
... | ... |
@@ -197,7 +197,7 @@ TRUE |
197 | 197 |
|
198 | 198 |
Example 1.8. get_gflags usage |
199 | 199 |
... |
200 |
-$ openserctl fifo get_gflags |
|
200 |
+$ kamctl fifo get_gflags |
|
201 | 201 |
0x3039 |
202 | 202 |
12345 |
203 | 203 |
... |
... | ... |
@@ -152,8 +152,8 @@ if(is_gflag("4")) |
152 | 152 |
<title><function moreinfo="none">set_gflag</function> usage</title> |
153 | 153 |
<programlisting format="linespecific"> |
154 | 154 |
... |
155 |
-$ openserctl fifo set_gflag 1 |
|
156 |
-$ openserctl fifo set_gflag 0x3 |
|
155 |
+$ kamctl fifo set_gflag 1 |
|
156 |
+$ kamctl fifo set_gflag 0x3 |
|
157 | 157 |
... |
158 | 158 |
</programlisting> |
159 | 159 |
</example> |
... | ... |
@@ -172,8 +172,8 @@ $ openserctl fifo set_gflag 0x3 |
172 | 172 |
<function moreinfo="none">reset_gflag</function> usage</title> |
173 | 173 |
<programlisting format="linespecific"> |
174 | 174 |
... |
175 |
-$ openserctl fifo reset_gflag 1 |
|
176 |
-$ openserctl fifo reset_gflag 0x3 |
|
175 |
+$ kamctl fifo reset_gflag 1 |
|
176 |
+$ kamctl fifo reset_gflag 0x3 |
|
177 | 177 |
... |
178 | 178 |
</programlisting> |
179 | 179 |
</example> |
... | ... |
@@ -191,19 +191,19 @@ $ openserctl fifo reset_gflag 0x3 |
191 | 191 |
<title><function moreinfo="none">is_gflag</function> usage</title> |
192 | 192 |
<programlisting format="linespecific"> |
193 | 193 |
... |
194 |
-$ openserctl fifo set_gflag 1024 |
|
195 |
-$ openserctl fifo is_gflag 1024 |
|
194 |
+$ kamctl fifo set_gflag 1024 |
|
195 |
+$ kamctl fifo is_gflag 1024 |
|
196 | 196 |
TRUE |
197 |
-$ openserctl fifo is_gflag 1025 |
|
197 |
+$ kamctl fifo is_gflag 1025 |
|
198 | 198 |
TRUE |
199 |
-$ openserctl fifo is_gflag 1023 |
|
199 |
+$ kamctl fifo is_gflag 1023 |
|
200 | 200 |
FALSE |
201 |
-$ openserctl fifo set_gflag 0x10 |
|
202 |
-$ openserctl fifo is_gflag 1023 |
|
201 |
+$ kamctl fifo set_gflag 0x10 |
|
202 |
+$ kamctl fifo is_gflag 1023 |
|
203 | 203 |
TRUE |
204 |
-$ openserctl fifo is_gflag 1007 |
|
204 |
+$ kamctl fifo is_gflag 1007 |
|
205 | 205 |
FALSE |
206 |
-$ openserctl fifo is_gflag 16 |
|
206 |
+$ kamctl fifo is_gflag 16 |
|
207 | 207 |
TRUE |
208 | 208 |
... |
209 | 209 |
</programlisting> |
... | ... |
@@ -220,7 +220,7 @@ TRUE |
220 | 220 |
<function moreinfo="none">get_gflags</function> usage</title> |
221 | 221 |
<programlisting format="linespecific"> |
222 | 222 |
... |
223 |
-$ openserctl fifo get_gflags |
|
223 |
+$ kamctl fifo get_gflags |
|
224 | 224 |
0x3039 |
225 | 225 |
12345 |
226 | 226 |
... |
... | ... |
@@ -593,7 +593,7 @@ start_recording(); |
593 | 593 |
|
594 | 594 |
Example 1.23. nh_enable_ping usage |
595 | 595 |
... |
596 |
-$ openserctl fifo nh_enable_ping 1 |
|
596 |
+$ kamctl fifo nh_enable_ping 1 |
|
597 | 597 |
... |
598 | 598 |
|
599 | 599 |
1.7.2. nh_enable_rtpp |
... | ... |
@@ -611,7 +611,7 @@ $ openserctl fifo nh_enable_ping 1 |
611 | 611 |
|
612 | 612 |
Example 1.24. nh_enable_rtpp usage |
613 | 613 |
... |
614 |
-$ openserctl fifo nh_enable_rtpp udp:192.168.2.133:8081 0 |
|
614 |
+$ kamctl fifo nh_enable_rtpp udp:192.168.2.133:8081 0 |
|
615 | 615 |
... |
616 | 616 |
|
617 | 617 |
1.7.3. nh_show_rtpp |
... | ... |
@@ -623,7 +623,7 @@ $ openserctl fifo nh_enable_rtpp udp:192.168.2.133:8081 0 |
623 | 623 |
|
624 | 624 |
Example 1.25. nh_show_rtpp usage |
625 | 625 |
... |
626 |
-$ openserctl fifo nh_show_rtpp |
|
626 |
+$ kamctl fifo nh_show_rtpp |
|
627 | 627 |
... |
628 | 628 |
|
629 | 629 |
Chapter 2. Frequently Asked Questions |
... | ... |
@@ -805,7 +805,7 @@ start_recording(); |
805 | 805 |
<title><function moreinfo="none">nh_enable_ping</function> usage</title> |
806 | 806 |
<programlisting format="linespecific"> |
807 | 807 |
... |
808 |
-$ openserctl fifo nh_enable_ping 1 |
|
808 |
+$ kamctl fifo nh_enable_ping 1 |
|
809 | 809 |
... |
810 | 810 |
</programlisting> |
811 | 811 |
</example> |
... | ... |
@@ -833,7 +833,7 @@ $ openserctl fifo nh_enable_ping 1 |
833 | 833 |
<function moreinfo="none">nh_enable_rtpp</function> usage</title> |
834 | 834 |
<programlisting format="linespecific"> |
835 | 835 |
... |
836 |
-$ openserctl fifo nh_enable_rtpp udp:192.168.2.133:8081 0 |
|
836 |
+$ kamctl fifo nh_enable_rtpp udp:192.168.2.133:8081 0 |
|
837 | 837 |
... |
838 | 838 |
</programlisting> |
839 | 839 |
</example> |
... | ... |
@@ -853,7 +853,7 @@ $ openserctl fifo nh_enable_rtpp udp:192.168.2.133:8081 0 |
853 | 853 |
<function moreinfo="none">nh_show_rtpp</function> usage</title> |
854 | 854 |
<programlisting format="linespecific"> |
855 | 855 |
... |
856 |
-$ openserctl fifo nh_show_rtpp |
|
856 |
+$ kamctl fifo nh_show_rtpp |
|
857 | 857 |
... |
858 | 858 |
</programlisting> |
859 | 859 |
</example> |
... | ... |
@@ -33,10 +33,10 @@ |
33 | 33 |
The tracing can be turned on/off using fifo commad. |
34 | 34 |
</para> |
35 | 35 |
<para> |
36 |
- openserctl fifo sip_trace on |
|
36 |
+ kamctl fifo sip_trace on |
|
37 | 37 |
</para> |
38 | 38 |
<para> |
39 |
- openserctl fifo sip_trace off |
|
39 |
+ kamctl fifo sip_trace off |
|
40 | 40 |
</para> |
41 | 41 |
</section> |
42 | 42 |
<section> |
... | ... |
@@ -185,7 +185,7 @@ if (!check_blacklist("global_blacklist"))) |
185 | 185 |
<title><function>reload_blacklists</function> usage</title> |
186 | 186 |
<programlisting format="linespecific"> |
187 | 187 |
... |
188 |
-openserctl fifo reload_blacklist |
|
188 |
+kamctl fifo reload_blacklist |
|
189 | 189 |
... |
190 | 190 |
</programlisting> |
191 | 191 |
</example> |
... | ... |
@@ -76,7 +76,7 @@ static int mi_child_init(void); |
76 | 76 |
static void mod_destroy(void); |
77 | 77 |
|
78 | 78 |
/* --- fifo functions */ |
79 |
-struct mi_root * mi_reload_blacklist(struct mi_root* cmd, void* param); /* usage: openserctl fifo reload_blacklist */ |
|
79 |
+struct mi_root * mi_reload_blacklist(struct mi_root* cmd, void* param); /* usage: kamctl fifo reload_blacklist */ |
|
80 | 80 |
|
81 | 81 |
|
82 | 82 |
static cmd_export_t cmds[]={ |