====== Tips for Kamailio migration ======

The page collects tips to migrate Kamailio to SIP-Router and get same behaviour. There are Kamailio functions that do not exist in SIP Router, but alternatives are available to get more or less same behaviour.
===== TCP Connection Lifetime =====

  * **registrar** module in Kamailio 1.5 and earlier had support to set automatically the lifetime of the TCP connection for current processed SIP REGISTER message by defining **tcp_persistent_flag** module parameter and then by setting the flag before save() function was called.
  * In **sip-router** and Kamailio 3.0 **tcp_persistent_flag** parameter does not exist anymore.  Similar functionality can be achieved by setting **tcp_connection_lifetime** core config parameter just a bit higher than max registration expire. The lifetime for a TCP connection is automatically extended when a message is going through. In case of hard/soft phones, the connection is closed by client side when they shut down.

===== Log levels =====

  * the logging in sip-router uses different values for each level. You can get the corresponding level by simple subtracting "1" from the value you used in kamailio. For example the INFO level in kamailio (3) is "2" in sip-router.

===== Module loading =====

  * The mpath statement is also available in sip-router, being an alias to loadpath parameter. In addition, you can omit the ".so" from each loadmodule statement, as this is automatically appended from the sip-router.

http://sip-router.org/wiki/cookbooks/core-cookbook/devel#loadpath

===== Branch Flags Operations =====

  * functions are implemented now by kex module. The parameters must be enclosed in double quotes and they can be pseudo-variables with integer values:

http://sip-router.org/docbook/sip-router/branch/master/modules_k/kex/kex.html

===== Script Flags Operations =====

  * functions are implemented now by kex module. The parameters must be enclosed in double quotes and they can be pseudo-variables with integer values:

http://sip-router.org/docbook/sip-router/branch/master/modules_k/kex/kex.html

===== Dst URI Operations =====

  * functions **setdsturi(uri), resetdsturi() and isdsturiset()** are implemented now by kex module. The syntax is the same:

http://sip-router.org/docbook/sip-router/branch/master/modules_k/kex/kex.html

===== TM Extensions =====

  * several TM extensions are now part of TMX module

http://sip-router.org/docbook/sip-router/branch/master/modules_k/tmx/tmx.html

===== Core parameters =====

  * [b]avp_aliases[/b] is a parameter of PV module

http://sip-router.org/docbook/sip-router/branch/master/modules_k/pv/pv.html

  * [b]disable_dns_blacklist[/b] is replaced by [b]dns_cache_negative_ttl[/b]

http://sip-router.org/wiki/cookbooks/core-cookbook/devel#dns_cache_negative_ttl

  * [b]disable_dns_failover[/b] is replaced by [b]use_dns_failover[/b]

By default, [b]use_dns_failover[/b] is currently "off".  Hopefully, the default can be changed to "on" in order to be compatible with Kamailio default.

===== Core Functions =====

  * [b]append_branch()[/b] - fully Kamailio append_branch() function is now implemented by [b]kex[/b] module and it is named [b]km_append_branch()[/b]. See:
    * http://sip-router.org/docbook/sip-router/branch/master/modules_k/kex/kex.html
    * note: there is still a core function still called [b]append_branch()[/b], but it is SIP Express Router (SER) compatible.
    * [b]km_append_branch()[/b] - as new feature, it accepts now the URI parameter to contain pseudo-variables

===== Script syntax =====

==== Test operator [...] ====

  * [b]test operator [...][/b] is does not exist. Same operation is supported directly in conditional expressions.

Bit tests must be written in conditions without brackets [ and ], for example,

<code c>
    if ($var(a) & 4)
        log("var a has third bit set\n");
</code>

==== Operator := ====

  * [b]:=[/b] used in Kamailio for AVPs - delete all then add - is not available in SIP Router. Same functionality is given by assignment when providing index 'all' to the right AVP. See example:

<code c>
   # Kamailio: $avp(abc) := 'xyz';
   $(avp(abc)[*]) = 'xyz';

   # Kamailio: $avp(abc) := null;
   $(avp(abc)[*]) = $null;
</code>

===== Module parameters =====

  * [b]tm onreply_avp_mode[/b] does not exist

In SIP Router, AVPs that are set in request route are always visible in branch, failure, and onreply_route.  In other words, SIP Router behaves like Kamailio when onreply_avp_mode is set to value 1.

  * [b]tm fr_timer, fr_inv_timer, and contacts_avp[/b] AVP value syntax

In SIP Router, AVP value of tm module parameters fr_timer, fr_inv_timer, and contacts_avp is currently written without $avp(), for example, "i:705".  This is to be fixed.

  * [b]tm fr_timer, fr_inv_timer, wt_timer, delete_timer, and unix_tx_timeout[/b] units

In SIP Router, time value of the above parameters is given in milliseconds, whereas in Kamailio they are given in seconds (see [[ref_manual:timers|tm timers]] for more details). In order to make migration easier, perhaps a new tm module parameter could be introduced to specify, in which units time values are given.

===== Module functions =====

  * [b]t_relay()[/b] does not accept flags parameter

Module parameter "auto_inv_100" can be used to globally turn off gneration of provisional replies (default is 1 == "on").  It is also possible to dynamically control generation of provisional replies using function t_set_auto_inv_100().

t_relay() does not send a negative reply implicitly.  Negative reply is auto-generated at the end of the script if no reply was explicitly sent from the script.

Core parameter "use_dns_failover" can be used to globally turn off DNS failover (default is "off").

  * [b]t_relay()[/b] does not generate internally a negative reply.  Negative reply is can always be generated explicitly from script.  If not done, it is generated implicitly at the end of the script.

  * [b]t_was_cancelled()[/b] is replaced by [b]t_is_canceled()[/b].

===== Route blocks =====

  * [b]error_route[/b] is not supported

Check request sanity at the beginning of script (see sanity module).

===== null keyword =====

**null** keyword is not present in SIP Router. Use pseudo-variable **$null** instead.

In addition, the operator **defined** can be used to check if a value is null or not.

<code c>
if( ! defined $avp(x) ) {
   # the avp is null
   ...
}
</code>