Migration from 3.4.x to 3.5.0

This section is meant to provide useful help in migrating your OpenSIPS installations from the 3.4.0 version to 3.5.0.

You can find the all the new additions in the 3.5.0 release compiled under this page. The ChangeLog may help your understanding of the migration / update process.

DB migration

You can migrate your 3.4.x MySQL DB to the 3.5.x format using the opensips-cli tool :

$ opensips-cli -x database migrate 3.4_to_3.5 opensips_3_4 opensips_3_5

where :

opensips_3_4 is the existing DB name corresponding to version 3.4.x format
opensips_3_5 is the DB name to be created for 3.5.x format

See the opensips-cli documentation for more details.

Script migration

The following is the full list of backwards-incompatible syntax or functional changes in the OpenSIPS configuration script:

none

Global Parameters

The mpath parameter can take several values. This means that if your script contains several declarations, and you rely on the fact that only the last one is being used, you need to completely delete (or comment) the previous ones, otherwise they will be taken into account in the modules search algorithm, and moreover, they will be prioritized.

Core Variables

example

Core keywords

example

Core functions

consider using the new set_via_handling() instead of force_rport(), add_local_report() or force_tcp_alias() (which are to be deprecated in the future)

Core MI commands

example

Statistics migration

example

Module migration

AVPOPS module

This module does not exist anymore. All its functions were re-distributed and replaced as follows:

avp_db_load/store/delete() functions were moved and renamed as sql_avp_load/store_delete() in the sqlops module
avp_db_query() function was moved and renamed as sql_query() in the sqlops module
avp_remove() function was removed, as it can be replaced with scripting $avp(x):=NULL
avp_pushto() function was removed, as it can be replaced with scripting assignment operation
avp_check() function was removed, as it can be replaced with scripting testing operators
avp_copy() function was removed, as it can be replaced with scripting assignment operation
avp_subst() function was removed, as it can be replaced with scripting {re.subst} transformation
avp_op() function was removed, as it can be replaced with scripting operations
is_avp_set() function was removed, as it can be replaced with scripting if ($avp(x)==NULL) {}
avp_shuffle() function was moved under the shuffle_avps() name into the cfgutils module
avp_print() function was moved to the OpenSIPS core under the same name

SQL_CACHER module

BE CAREFUL, the DOUBLE types are now returned as strings, rather than corrupted numerical values.