sr-dev April 2011

sr-dev@lists.kamailio.org

27 participants
272 discussions

git:carstenbock/ims: - added function to lookup a certain URI (lookup( domain, uri))
by Carsten Bock 20 Apr '11

20 Apr '11

Module: sip-router Branch: carstenbock/ims Commit: 64b5e777a06ac8b63b130df7215fa664bb0afa30 URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=64b5e77… Author: Carsten Bock <carsten(a)bock.info> Committer: Carsten Bock <carsten(a)bock.info> Date: Wed Apr 20 22:51:10 2011 +0200 - added function to lookup a certain URI (lookup(domain, uri)) - reverted additions to store additional values into usrloc, does not work at the moment and is not needed. --- modules_k/registrar/doc/registrar_admin.xml | 47 +----------- modules_k/registrar/lookup.c | 79 ------------------- modules_k/registrar/reg_mod.c | 51 +------------ modules_k/registrar/reg_mod.h | 11 --- modules_k/registrar/regpv.c | 2 +- modules_k/registrar/save.c | 108 +-------------------------- 6 files changed, 6 insertions(+), 292 deletions(-) Diff: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commitdiff;h=64b…

1 0

planning next major release 3.2
by Daniel-Constantin Mierla 20 Apr '11

20 Apr '11

Hello, soon we should sketch the roadmap for the next major release 3.2. There are some private git branches with lot of work on it, so we need to synchronize a bit and decide about the proper time: before or after summer. Several devels will be in Berlin for Linuxtag, but no so much overlapping for a big face to face meeting, therefore might be better to have a IRC chat conference sometime in the near future. Next week will be fine for me, say Wednesaday till Friday, in the afternoon to allow fair time of the day for US timezones. If you have other proposals, speak up. Cheers, Daniel -- Daniel-Constantin Mierla http://www.asipto.com

2 3

[tracker] Task opened: Error parsing Via parameter with space before semicolon
by sip-router 19 Apr '11

19 Apr '11

THIS IS AN AUTOMATED MESSAGE, DO NOT REPLY. A new Flyspray task has been opened. Details are below. User who did this - Iñaki Baz Castillo (ibc) Attached to Project - sip-router Summary - Error parsing Via parameter with space before semicolon Task Type - Bug Report Category - Core Status - Assigned Assigned To - Andrei Pelinescu-Onciul Operating System - All Severity - Very Low Priority - Normal Reported Version - Development Due in Version - Undecided Due Date - Undecided Details - The following valid Via causes a parsing error: Via: SIP/2.0/UDP 1.2.3.4;branch=z9hG4bK1aaaaa;rport;param1 ;param2<CRLF> It occurs due to the space before ";param2". If param2 has value (param2=abc or param2 = abc) the error also occurs. According to RFC 3261 BNF the above Via is 100% valid as header parameters separator is SEMI which is defined as: SEMI = SWS ";" SWS SWS = [LWS] LWS = [*WSP CRLF] 1*WSP WSP = SP | HTAB; More information can be found at the following URL: http://sip-router.org/tracker/index.php?do=details&task_id=127 You are receiving this message because you have requested it from the Flyspray bugtracking system. If you did not expect this message or don't want to receive mails in future, you can change your notification settings at the URL shown above.

1 0

[tracker] Assignee added: Error parsing Via parameter with space before semicolon
by sip-router 19 Apr '11

19 Apr '11

THIS IS AN AUTOMATED MESSAGE, DO NOT REPLY. A user has added themself to the list of users assigned to this task. FS#127 - Error parsing Via parameter with space before semicolon User who did this - Iñaki Baz Castillo (ibc) http://sip-router.org/tracker/index.php?do=details&task_id=127 You are receiving this message because you have requested it from the Flyspray bugtracking system. If you did not expect this message or don't want to receive mails in future, you can change your notification settings at the URL shown above.

1 0

Re: [sr-dev] sr-dev Digest, Vol 30, Issue 39 - Presence Problem
by laura testi 19 Apr '11

19 Apr '11

Hi Peter, thank you very much for the suggestion. In fact, with the XHTTP_AUTH enable, SIP Communicator (JITSI) doesn’t work with XCAP of Kamailio. With the XHTTP_AUTH comment out. The Presence authorization finally works, but partially. When bob add alice as a contact, there is a authorization request popup to alice, and alice click accept, then the auth req result popup appear to alice saying the bob has accepted the request! After that, bob can see the presence status of alice correctly. But alice always see the bob is offline. In the xcap table, we see there is an entry in the rls (contact alice in the user bob entry) and another entry in the presence rules (contact alice in the user bob entry). But when I try to add bob as a contact from alice, nothing happen, there is no popup of authorization request to bob. And alice always see the bob is offline. Any idea? Thank you very much. Best Regards, Laura > Message: 2 > Date: Tue, 19 Apr 2011 10:17:34 +0100 > From: Peter Dunkley <peter.dunkley(a)crocodile-rcs.com> > Subject: Re: [sr-dev] Presence problem > To: Development mailing list of the sip-router project > <sr-dev(a)lists.sip-router.org> > Message-ID: <1303204654.4056.10.camel@pd-laptop-linux> > Content-Type: text/plain; charset="utf-8" > > Hi Laura, > > I have recently been testing presence with Kamailio as well. > > > > - The change status of the presentity is immediately visible > > by watcher with the only exception, when the user goes offline, the > > presentity keeps online in the watcher buddy list, any idea? Can you > > help me? > > > > I have had the same issue with clients I was testing with. In my case > it turned out to be problems with the client. > > You should take a LAN trace from the client side and check that the > client logging out is properly updating presence status on log-out. If > that is OK, then take a trace on the client still logged in, it could be > that the client is receiving the status update but not displaying it. > > > > > > The xcap table is empty. Do I need to configure also the xcap table? > > Or it?s automically done by kamailio presence server? > > > > The xcap table will be empty for new subscribers. When the client > requests a document (of supported type) from Kamailio that is not on the > server it will get a "404 Not Found" response. The client should then > create a new document (with sensible defaults for the client) on the > server using an HTTP PUT. > > If the client requests a document that is not of supported type Kamailio > will return a "500 Server Error" response and the client should continue > (if it can) without support for that document. > > During my testing I came across a client that didn't support HTTP > authentication properly, so when Kamailio responded with a 401 the > client gave up instead of authenticating. Disabling HTTP authentication > (take out the "#!define WITH_XHTTPAUTH" line in kamailio.cfg). > > Regards, > > Peter > > -- > Peter Dunkley > Technical Director > Crocodile RCS Ltd >

1 0

Presence problem
by laura testi 19 Apr '11

19 Apr '11

Hi, we are trying to setup a Kamailio as a SIP/SIMPLE presence server for chat based on the guide published in SIP SIMPLE Presence Made Simple with Kamailio 3.1.x on the site: http://kb.asipto.com/kamailio:presence:k31-made-simple. The OS we are using is Linux RHEL 5.6 x64 and MYSQL as Database. We found some strange behaviors of the Kamailio basic presence, presence rules functionalities. As suggested in the guide we created 2 users (Alice and Bob) and both the latest jitsi (SIP communicator) to test it. The test scenario is following by using either UDP or TCP protocol: - Alice add the Bob as a contact - Bob add the Alice as a contact - Alice change presence status - Bob change presence status - Alice send IM to Bob - Bob send IM to - Alice put the status offline - Bob put the status offlice First, test the configuration without XCAP server load: - WITH_XCAPSRV is not defined - Use implicit presence rule modparam("presence_xml", "force_active", 1) (from my understanding, without xcap we can only use implicit presence rule without any authorization for the subscription Result: - Add contact is ok and the presence status is immediately visible (because force_active = 1) - The change status of the presentity is immediately visible by watcher with the only exception, when the user goes offline, the presentity keeps online in the watcher buddy list, any idea? Can you help me? Second, test the configuration with XCAP server load and the configuration is the same of the guide: - WITH_XCAPSRV is defined - Use implicit presence rule modparam("presence_xml", "force_active", 0) - modparam("presence_xml", "integrated_xcap_server", 1) Result: - When Alice add the Bob as a contact, there is no popup to ask the Bob authorization immediately. - When Bob change the presence status, Alice dosen’t see the change(offline), but they can exchange IM. - When Alice goes offline, the popup of the authorization request of the Alice is appear to Bob, Bob accept the request - When Alice come on line again, the same behavior, Alice always see Bob is online even Bob change his status. - When Alice goes offline again, the Authorization Request come up again to Bob just like Bob even Bob has accepted the request before. Very strange When we configured the kamailio with XCAPSRV and enable the xcap also in the SIP communicator as suggested by the guide, we got the following error in /var/log/messages when alice goes online: Apr 18 16:35:01 kamailio3p1 /usr/sbin/kamailio[7561]: ERROR: <script>: ===== xhttp: resource-lists : sip:alice@10.10.5.214 Apr 18 16:35:01 kamailio3p1 /usr/sbin/kamailio[7561]: ERROR: <script>: ===== xhttp: get sip:alice@10.10.5.214 => /xcap-root/resource-lists/users/ sip:alice@10.10.5.214/index Apr 18 16:35:01 kamailio3p1 /usr/sbin/kamailio[7562]: ERROR: <script>: ===== xhttp: pres-rules : sip:alice@10.10.5.214 Apr 18 16:35:01 kamailio3p1 /usr/sbin/kamailio[7562]: ERROR: <script>: ===== xhttp: get sip:alice@10.10.5.214 => /xcap-root/pres-rules/users/ sip:alice@10.10.5.214/presrules The xcap table is empty. Do I need to configure also the xcap table? Or it’s automically done by kamailio presence server? Any idea? Maybe we have wrong configuration or is it a bug of kamailio? Thanks and Best Regards, Laura

2 1

Notifying RLS when XML documents are updated
by Peter Dunkley 19 Apr '11

19 Apr '11

Hello, I am using Kamailio RLS and integrated XCAP Server. When I add a contact with my client it updates my XCAP documents but there is no additional SIP messaging between the client and Kamailio. I have been assured (by the client author) that this is the correct behaviour. However, having looked at both the XCAP Server and RLS module code I cannot see anything that will either inform RLS that a document has been updated or a timer to check for that. Have I missed something obvious? Thanks, Peter -- Peter Dunkley Technical Director Crocodile RCS Ltd

3 5

git:master: domain(k): use server error code for RPC fault reply
by Daniel-Constantin Mierla 18 Apr '11

18 Apr '11

Module: sip-router Branch: master Commit: d2c90c180690343df1c9baf1a2ab420db6047c6a URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=d2c90c1… Author: Daniel-Constantin Mierla <miconda(a)gmail.com> Committer: Daniel-Constantin Mierla <miconda(a)gmail.com> Date: Mon Apr 18 23:26:36 2011 +0200 domain(k): use server error code for RPC fault reply --- modules_k/domain/domain_mod.c | 2 +- 1 files changed, 1 insertions(+), 1 deletions(-) diff --git a/modules_k/domain/domain_mod.c b/modules_k/domain/domain_mod.c index d8ca4ce..555fd8e 100644 --- a/modules_k/domain/domain_mod.c +++ b/modules_k/domain/domain_mod.c @@ -284,7 +284,7 @@ static const char* domain_rpc_reload_doc[2] = { static void domain_rpc_reload(rpc_t* rpc, void* ctx) { if (!db_mode) { - rpc->fault(ctx, 200, "Server Domain Cache Disabled"); + rpc->fault(ctx, 500, "Server Domain Cache Disabled"); return; }

1 0

git:master: dispatcher(k): added RPC commands
by Daniel-Constantin Mierla 18 Apr '11

18 Apr '11

Module: sip-router Branch: master Commit: d997ecfc1df1781b7276b796c443f7d6f1f7cc2a URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=d997ecf… Author: Daniel-Constantin Mierla <miconda(a)gmail.com> Committer: Daniel-Constantin Mierla <miconda(a)gmail.com> Date: Mon Apr 18 23:20:44 2011 +0200 dispatcher(k): added RPC commands - new RPC commands to replace the MI ones --- modules_k/dispatcher/dispatch.c | 42 ++----- modules_k/dispatcher/dispatch.h | 34 ++++++ modules_k/dispatcher/dispatcher.c | 218 +++++++++++++++++++++++++++++++++++++ 3 files changed, 263 insertions(+), 31 deletions(-) diff --git a/modules_k/dispatcher/dispatch.c b/modules_k/dispatcher/dispatch.c index 93274f7..a056dcb 100644 --- a/modules_k/dispatcher/dispatch.c +++ b/modules_k/dispatcher/dispatch.c @@ -86,37 +86,6 @@ static int _ds_table_version = DS_TABLE_VERSION; static ds_ht_t *_dsht_load = NULL; -typedef struct _ds_attrs -{ - str body; - str duid; - int maxload; - int weight; -} ds_attrs_t; - -typedef struct _ds_dest -{ - str uri; - int flags; - int priority; - int dload; - ds_attrs_t attrs; - struct ip_addr ip_address; /*!< IP-Address of the entry */ - unsigned short int port; /*!< Port of the request URI */ - int failure_count; - struct _ds_dest *next; -} ds_dest_t; - -typedef struct _ds_set -{ - int id; /*!< id of dst set */ - int nr; /*!< number of items in dst set */ - int last; /*!< last used item in dst set (round robin) */ - int wlast; /*!< last used item in dst set (by weight) */ - ds_dest_t *dlist; - unsigned int wlist[100]; - struct _ds_set *next; -} ds_set_t; extern int ds_force_dst; @@ -2449,3 +2418,14 @@ int bind_dispatcher(dispatcher_api_t* api) api->is_from = ds_is_from_list; return 0; } + + +ds_set_t *ds_get_list(void) +{ + return _ds_list; +} + +int ds_get_list_nr(void) +{ + return _ds_list_nr; +} diff --git a/modules_k/dispatcher/dispatch.h b/modules_k/dispatcher/dispatch.h index f15cfbf..df95842 100644 --- a/modules_k/dispatcher/dispatch.h +++ b/modules_k/dispatcher/dispatch.h @@ -128,5 +128,39 @@ void ds_ht_timer(unsigned int ticks, void *param); */ int ds_ping_check_rplcode(int); +typedef struct _ds_attrs +{ + str body; + str duid; + int maxload; + int weight; +} ds_attrs_t; + +typedef struct _ds_dest +{ + str uri; + int flags; + int priority; + int dload; + ds_attrs_t attrs; + struct ip_addr ip_address; /*!< IP-Address of the entry */ + unsigned short int port; /*!< Port of the request URI */ + int failure_count; + struct _ds_dest *next; +} ds_dest_t; + +typedef struct _ds_set +{ + int id; /*!< id of dst set */ + int nr; /*!< number of items in dst set */ + int last; /*!< last used item in dst set (round robin) */ + int wlast; /*!< last used item in dst set (by weight) */ + ds_dest_t *dlist; + unsigned int wlist[100]; + struct _ds_set *next; +} ds_set_t; + +ds_set_t *ds_get_list(void); +int ds_get_list_nr(void); #endif diff --git a/modules_k/dispatcher/dispatcher.c b/modules_k/dispatcher/dispatcher.c index 0b8b8c8..2fb8cb6 100644 --- a/modules_k/dispatcher/dispatcher.c +++ b/modules_k/dispatcher/dispatcher.c @@ -62,6 +62,8 @@ #include "../../route.h" #include "../../mem/mem.h" #include "../../mod_fix.h" +#include "../../rpc.h" +#include "../../rpc_lookup.h" #include "ds_ht.h" #include "dispatch.h" @@ -138,6 +140,7 @@ static int mod_init(void); static int child_init(int); static int ds_parse_reply_codes(); +static int ds_init_rpc(void); static int w_ds_select_dst(struct sip_msg*, char*, char*); static int w_ds_select_domain(struct sip_msg*, char*, char*); @@ -256,6 +259,11 @@ static int mod_init(void) LM_ERR("failed to register MI commands\n"); return -1; } + if(ds_init_rpc()<0) + { + LM_ERR("failed to register RPC commands\n"); + return -1; + } if (dst_avp_param.s) dst_avp_param.len = strlen(dst_avp_param.s); @@ -878,3 +886,213 @@ int ds_ping_check_rplcode(int code) void ds_ping_reply_codes_update(str* gname, str* name){ ds_parse_reply_codes(); } + +/*** RPC implementation ***/ + +static const char* dispatcher_rpc_reload_doc[2] = { + "Reload dispatcher destination sets", + 0 +}; + + +/* + * RPC command to reload dispatcher destination sets + */ +static void dispatcher_rpc_reload(rpc_t* rpc, void* ctx) +{ + if(dstid_avp_name.n!=0) { + LM_ERR("No reload support when call load dispatching is enabled." + " Do not set dstid_avp param if you do not use alg 10.\n"); + rpc->fault(ctx, 500, "Command disabled"); + return ; + } + + if(!ds_db_url.s) { + if (ds_load_list(dslistfile)!=0) { + rpc->fault(ctx, 500, "Reload Failed"); + return; + } + } else { + if(ds_load_db()<0) { + rpc->fault(ctx, 500, "Reload Failed"); + return; + } + } + return; +} + + + +static const char* dispatcher_rpc_list_doc[2] = { + "Return the content of dispatcher sets", + 0 +}; + + +/* + * RPC command to print dispatcher destination sets + */ +static void dispatcher_rpc_list(rpc_t* rpc, void* ctx) +{ + void* th; + void* ih; + void* vh; + int j; + char c[3]; + str data = {"", 0}; + ds_set_t *ds_list; + int ds_list_nr; + ds_set_t *list; + + ds_list = ds_get_list(); + ds_list_nr = ds_get_list_nr(); + + if(ds_list==NULL || ds_list_nr<=0) + { + LM_ERR("no destination sets\n"); + rpc->fault(ctx, 500, "No Destination Sets"); + return; + } + + /* add entry node */ + if (rpc->add(ctx, "{", &th) < 0) + { + rpc->fault(c, 500, "Internal error root reply"); + return; + } + if(rpc->struct_add(th, "d{", + "SET_NO", ds_list_nr, + "SET", &ih)<0) + { + rpc->fault(c, 500, "Internal error set structure"); + return; + } + + + for(list = ds_list; list!= NULL; list= list->next) + { + if(rpc->struct_add(ih, "d", + "SET_ID", list->id)<0) + { + rpc->fault(c, 500, "Internal error creating set id"); + return; + } + + for(j=0; j<list->nr; j++) + { + if(rpc->struct_add(ih, "{", + "DEST", &vh)<0) + { + rpc->fault(c, 500, "Internal error creating dest"); + return; + } + + memset(&c, 0, sizeof(c)); + if (list->dlist[j].flags & DS_INACTIVE_DST) + c[0] = 'I'; + else if (list->dlist[j].flags & DS_DISABLED_DST) + c[0] = 'D'; + else + c[0] = 'A'; + + if (list->dlist[j].flags & DS_PROBING_DST) + c[1] = 'P'; + else + c[1] = 'X'; + + if(rpc->struct_add(vh, "SsdS", + "URI", &list->dlist[j].uri, + "FLAGS", c, + "PRIORITY", list->dlist[j].priority, + "ATTRS", (list->dlist[j].attrs.body.s)? + &(list->dlist[j].attrs.body):&data)<0) + { + rpc->fault(c, 500, "Internal error creating dest struct"); + return; + } + } + } + + return; +} + + +static const char* dispatcher_rpc_set_state_doc[2] = { + "Set the state of a destination address", + 0 +}; + + +/* + * RPC command to set the state of a destination address + */ +static void dispatcher_rpc_set_state(rpc_t* rpc, void* ctx) +{ + int group; + str dest; + str state; + int stval; + + if(rpc->scan(ctx, ".SdS", &state, &group, &dest)<3) + { + rpc->fault(ctx, 500, "Invalid Parameters"); + return; + } + if(state.len<=0 || state.s==NULL) + { + LM_ERR("bad state value\n"); + rpc->fault(ctx, 500, "Invalid State Parameter"); + return; + } + + stval = 0; + if(state.s[0]=='0' || state.s[0]=='I' || state.s[0]=='i') { + /* set inactive */ + stval |= DS_INACTIVE_DST; + if((state.len>1) && (state.s[1]=='P' || state.s[1]=='p')) + stval |= DS_PROBING_DST; + } else if(state.s[0]=='1' || state.s[0]=='A' || state.s[0]=='a') { + /* set active */ + if((state.len>1) && (state.s[1]=='P' || state.s[1]=='p')) + stval |= DS_PROBING_DST; + } else if(state.s[0]=='2' || state.s[0]=='D' || state.s[0]=='d') { + /* set disabled */ + stval |= DS_DISABLED_DST; + } else { + LM_ERR("unknow state value\n"); + rpc->fault(ctx, 500, "Unknown State Value"); + return; + } + + if(ds_reinit_state(group, &dest, stval)<0) + { + rpc->fault(ctx, 500, "State Update Failed"); + return; + } + + return; +} + + +rpc_export_t dispatcher_rpc_cmds[] = { + {"dispatcher.reload", dispatcher_rpc_reload, + dispatcher_rpc_reload_doc, 0}, + {"dispatcher.list", dispatcher_rpc_list, + dispatcher_rpc_list_doc, 0}, + {"dispatcher.set_state", dispatcher_rpc_set_state, + dispatcher_rpc_set_state_doc, 0}, + {0, 0, 0, 0} +}; + +/** + * register RPC commands + */ +static int ds_init_rpc(void) +{ + if (rpc_register_array(dispatcher_rpc_cmds)!=0) + { + LM_ERR("failed to register RPC commands\n"); + return -1; + } + return 0; +}

1 0

git:master: dispatcher(k): documented the RPC commands
by Daniel-Constantin Mierla 18 Apr '11

18 Apr '11

Module: sip-router Branch: master Commit: 3979c5627b123d64ff95064f826523aba978bd29 URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=3979c56… Author: Daniel-Constantin Mierla <miconda(a)gmail.com> Committer: Daniel-Constantin Mierla <miconda(a)gmail.com> Date: Mon Apr 18 23:21:49 2011 +0200 dispatcher(k): documented the RPC commands --- modules_k/dispatcher/README | 90 +++++++++++++++++++++---- modules_k/dispatcher/doc/dispatcher_admin.xml | 81 ++++++++++++++++++++++- 2 files changed, 157 insertions(+), 14 deletions(-) diff --git a/modules_k/dispatcher/README b/modules_k/dispatcher/README index 0261325..249d5bc 100644 --- a/modules_k/dispatcher/README +++ b/modules_k/dispatcher/README @@ -14,7 +14,7 @@ Edited by Carsten Bock - BASIS AudioNet GmbH + ng-voice.com Copyright © 2004 FhG FOKUS @@ -82,10 +82,16 @@ Carsten Bock 5.2. ds_list 5.3. ds_reload - 6. Installation and Running + 6. Exported RPC Commands - 6.1. Destination List File - 6.2. Kamailio config file + 6.1. dispatcher.set_state + 6.2. dispatcher.list + 6.3. dispatcher.reload + + 7. Installation and Running + + 7.1. Destination List File + 7.2. Kamailio config file 2. Frequently Asked Questions @@ -183,10 +189,16 @@ Chapter 1. Admin Guide 5.2. ds_list 5.3. ds_reload - 6. Installation and Running + 6. Exported RPC Commands + + 6.1. dispatcher.set_state + 6.2. dispatcher.list + 6.3. dispatcher.reload - 6.1. Destination List File - 6.2. Kamailio config file + 7. Installation and Running + + 7.1. Destination List File + 7.2. Kamailio config file 1. Overview @@ -751,7 +763,8 @@ ds_select_dst("1", "$var(a)"); possible parameters: * "i", "I" or "0" - the last destination should be set to inactive and will be ignored in future requests. - * "a", "A" or "1" - the last destination should be set to active. + * "a", "A" or "1" - the last destination should be set to active and + the error-counter should set to "0". * "p", "P" or "2" - the last destination will be set to probing. Note: You will need to call this function "threshhold"-times, before it will be actually set to probing. @@ -872,12 +885,63 @@ onreply_route { MI DATAGRAM Command Format: ":ds_reload:\n." -6. Installation and Running +6. Exported RPC Commands + + 6.1. dispatcher.set_state + 6.2. dispatcher.list + 6.3. dispatcher.reload + +6.1. dispatcher.set_state + + Sets the state for a destination address (can be use to mark the + destination as active or inactive). + + Name: dispatcher.set_state + + Parameters: + * _state_ : state of the destination address + + “a”: active + + “i”: inactive + + “d”: disabled + The states “a” or “i” can be followed by “p” to set probing mode + (e.g. 'ap' or 'ip') + * _group_: destination group id + * _address_: address of the destination in the _group_ + + Example: + sercmd dispatcher.set_state _state_ _group_ _address_ + +6.2. dispatcher.list + + It lists the groups and included destinations. + + Name: dispatcher.list + + Parameters: none + + Example: + sercmd dispatcher.list + +6.3. dispatcher.reload + + It reloads the groups and included destinations. The command is + disabled for call load based dispatching (algorithm 10) since removal + of destinations may leave the list of active calls with broken + references. + + Name: dispatcher.reload + + Parameters: none + + Example + sercmd dispatcher.reload + +7. Installation and Running - 6.1. Destination List File - 6.2. Kamailio config file + 7.1. Destination List File + 7.2. Kamailio config file -6.1. Destination List File +7.1. Destination List File Each destination point must be on one line. First token is the set id (an integer value), followed by destination address (s string value in @@ -926,7 +990,7 @@ r,opt) ... -6.2. Kamailio config file +7.2. Kamailio config file Next picture displays a sample usage of dispatcher. diff --git a/modules_k/dispatcher/doc/dispatcher_admin.xml b/modules_k/dispatcher/doc/dispatcher_admin.xml index 47cc96c..c851db7 100644 --- a/modules_k/dispatcher/doc/dispatcher_admin.xml +++ b/modules_k/dispatcher/doc/dispatcher_admin.xml @@ -1091,7 +1091,86 @@ onreply_route { </section> </section> - + + <section> + <title>Exported RPC Commands</title> + <section> + <title> + <function moreinfo="none">dispatcher.set_state</function> + </title> + <para> + Sets the state for a destination address (can be use to mark the destination + as active or inactive). + </para> + <para> + Name: <emphasis>dispatcher.set_state</emphasis> + </para> + <para>Parameters:</para> + <itemizedlist> + <listitem><para>_state_ : state of the destination address</para> + <itemizedlist> + <listitem><para> <quote>a</quote>: active</para></listitem> + <listitem><para> <quote>i</quote>: inactive</para></listitem> + <listitem><para> <quote>d</quote>: disabled</para></listitem> + </itemizedlist> + <para>The states <quote>a</quote> or <quote>i</quote> can be + followed by <quote>p</quote> to set probing mode (e.g. 'ap' + or 'ip')</para> + </listitem> + + <listitem><para>_group_: destination group id</para></listitem> + + <listitem><para>_address_: address of the destination in the _group_</para></listitem> + </itemizedlist> + <para> + Example: + </para> + <programlisting format="linespecific"> + sercmd dispatcher.set_state _state_ _group_ _address_ + </programlisting> + </section> + <section> + <title> + <function moreinfo="none">dispatcher.list</function> + </title> + <para> + It lists the groups and included destinations. + </para> + <para> + Name: <emphasis>dispatcher.list</emphasis> + </para> + <para>Parameters: <emphasis>none</emphasis></para> + <para> + Example: + </para> + <programlisting format="linespecific"> + sercmd dispatcher.list + </programlisting> + </section> + <section> + <title> + <function moreinfo="none">dispatcher.reload</function> + </title> + <para> + It reloads the groups and included destinations. The command is + disabled for call load based dispatching (algorithm 10) since + removal of destinations may leave the list of active + calls with broken references. + </para> + <para> + Name: <emphasis>dispatcher.reload</emphasis> + </para> + <para>Parameters: <emphasis>none</emphasis></para> + <para> + Example + </para> + <programlisting format="linespecific"> + sercmd dispatcher.reload + </programlisting> + </section> + + </section> + <section> <title>Installation and Running</title> <section>

1 0

← Newer
1
...
7
8
9
10
11
12
13
...
28
Older →

Jump to page:

2025

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

sr-dev April 2011