Login | Register


Documentation -> Tips and FAQ

1.  Tips

How to do certain things.

1.1  How to recalculate ha1 and ha1b

When you change the domain column in the subscriber table, you have to recalculate ha1 and ha1b fields. In order to do that you must have the password of each subscriber. It is stored in the 'password' column if you have set STORE_PLAINTEXT_PW=1 in opensipsctlrc (default).

HA1 is a MD5 hash of "username:domain:password". For example, if you have created a SIP account 1000@mydomain.com using password 123456, then HA1 is the MD5 hash of "1000:mydomain.com:123456" (without quotes). On the other hand HA1B is the MD5 hash of "username@domain:domain:password"; so using the same example above, HA1B would be the MD5 hash of "1000@mydomain.com:mydomain.com:123456" (without quotes).

To recalculate and update ha1 and ha1b columns in the subscriber table, just execute the following sql statement in mysql:

update subscriber
set ha1 = md5(concat(username, ':', domain, ':', password)),
ha1b = md5(concat(username, '@', domain, ':', domain, ':', password))

Note: the above is only true if you have "use_domain" enabled for auth_db _and_ you do not use a static challenge parameter for www_authorize.

If you use a static challenge for www_authorize (i.e. the first parameter of www_authorize is not the empty string), then HA1 is MD5("username:challenge:password") and HA1B is MD5("username@challenge:challenge:password"). If the challenge parameter of www_authorize is empty, OpenSIPS automatically selects the domain as the challenge value, which gives the solution presented above.

If "use_domain" is false, then the HA1B field must be computed based on "username@:domain:password" or "username@:challenge:password", depending on whether challenge is empty or defined, respectively.

1.2  PHP example to communicate via mi_xmlrpc
$params[] = "dialog:";
$params[] = "tm:";
$method = "get_statistics";
$request = xmlrpc_encode_request($method,$params);

$context = stream_context_create(array('http' => array(
   'method' => "POST",
   'header' => "Content-Type: text/xml",
   'content' => $request
$file = file_get_contents("http://example.opensips.org:8080/RPC2", false, $context);
$response = xmlrpc_decode($file);
if (is_array($response)) {
   trigger_error("xmlrpc: $response[faultString] ($response[faultCode])");
} else {
1.3  Add a new tip here

2.  FAQS

Answers to the most frequent questions

2.1  Changing FROM header

Q) How does one change the FROM Header in OpenSIPS ?

A) Use the uac_replace_from() function in the uac module

2.2  Recalculating HA1 and HA1B hashes when adding a subscriber

Q) How do I re-calculate the ha1 and halb values in the subscriber table for a new subscriber?

A) Run the following mysql operation:

update subscriber set ha1 = md5(concat(username, ':', domain, ':', password)), ha1b = md5(concat(username, '@', domain, ':', domain, ':', password))

This will automatically update the ha1 and ha1b fields for all subscribers.

2.3  Obsolete modules

Q) Some of the modules I was using prior to OpenSIPS 2.1 no longer exist. What happened to them?

A) Starting from OpenSIPS 2.1 we obsoleted some of the old modules (i.e mi_xmlrpc, closeddial, auth_diameter). These modules were not completely removed, but only moved in the modules_obsolete directory and are no longer compiled by default. If you really need these modules, you can manually move them to the modules directory.

2.4  Migrate to MI_XMLRPC_NG module

Q) How can I migrate from the MI_XMLRPC module to MI_XMLRPC_NG

A) The first step is to remove the loadmodule "mi_xmlrpc.so" directive from your script and load the httpd and mi_xmlrpc_ng modules:

loadmodule "httpd.so"
loadmodule "mi_xmlrpc_ng.so"

Next, you have to change the default path of the module to RPC2, the port the server is listening on to 8080 and the buffer size if specified.

modparam("mi_xmlrpc_ng", "mi_xmlrpc_ng_root", "RPC2")
modparam("httpd", "port", 8080)
modparam("httpd", "buf_size", 524288)
 Notice: the reply_option and log_file parameters have no equivalent for the new module, so if you were using these options, you have to revise your scripts logic.
2.5  Migrate from CLOSEDDIAL to DIALPLAN module

Q) How can I achieve the same behavior as the obsolete CLOSEDDIAL module does

A) The DIALPLAN module can be used to achieve the same behavior as the CLOSEDDIAL, which has been obsoleted. The only problem that you might face when migrating to the DIALPLAN module is that the rules are no longer grouped using names, but integers. Therefore, you have to port your groups from literal values (such as "companyA") to a numeric value (such as 10). Each old group has to have its own integer correspondent.

Next, the database has to be updated. Each row from the old closeddial table has to be migrated to the dialplan table, according to the following rule:

  • the dpid column should contain the integer mapping of the literal group_id
  • cd_username and cd_domain should be stored as a URI in the dialplan match_exp and subst_exp columns
  • the repl_exp should be the new URI of the user, corresponding to the closeddial new_uri column
  • the dialplan match_flags, disabled and pr columns should be 0 and the attrs can be NULL

Notice: if you were not using the use_domain, than the cd_domain from the match_exp and subst_exp columns should be omitted and only the $rU should be used in the following commands.

The next step is to modify the cd_lookup() function with the dp_translate() function:

dp_translate("$avp(group)", "$ru/$ru"); # if use_domain is 1
# or
dp_translate("$avp(group)", "$rU/$ru"); # if use_domain is 0

These are only some roughly steps that you have to follow. A full migration guide is highly dependent on your usage.

Page last modified on November 28, 2014, at 05:31 PM