Migration from 3.3.x to 3.4.0
This section is meant to provide useful help in migrating your OpenSIPS installations from the 3.3.0 version to 3.4.0.
You can find the all the new additions in the 3.4.0 release compiled under this page. The ChangeLog may help your understanding of the migration / update process.
DB migration
Section titled “DB migration”You can migrate your 3.3.x MySQL DB to the 3.4.x format using the opensips-cli tool :
$ opensips-cli -x database migrate 3.3_to_3.4 opensips_3_3 opensips_3_4where :
- opensips_3_3 is the existing DB name corresponding to version 3.3.x format
- opensips_3_4 is the DB name to be created for 3.4.x format
See the opensips-cli documentation for more details.
Script migration
Section titled “Script migration”- no changes to opensips.cfg syntax
Global Parameters
Section titled “Global Parameters”- log_facility has been deprecated and replaced with syslog_facility.
- log_name has been deprecated and replaced with syslog_name.
- log_stderror has been deprecated and is now equivalent with setting the new stderror_enabled and syslog_enabled parameters as following:
- log_stderror=yes - stderror_enabled=yes and syslog_enabled=no (default)
- log_stderror=no - stderror_enabled=no and syslog_enabled=yes.
Core Variables
Section titled “Core Variables”- no changes
Core keywords
Section titled “Core keywords”- no changes
Core functions
Section titled “Core functions”- no changes
Core MI commands
Section titled “Core MI commands”- the output of the list_blacklists rules have changed to improve readability:
- owner - now a string
- expire - indicates the number of seconds until the rule expires
- proto - printed as string protocol, or “any”
Statistics migration
Section titled “Statistics migration”- no changes
Module migration
Section titled “Module migration”B2B_LOGIC module
Section titled “B2B_LOGIC module”- The flags of the b2b_bridge() function have been renamed as following:
- n to notify
- f to rollback-failed
- t[nn] to max_duration=[int].
- The flags of the b2b_init_request() function have been renamed as following:
- a to transparent-auth
- p to preserve-to
- t[nn] to setup-timeout=[nn]
- The init_sdp_body and init_sdp_ctype parameters of the b2b_init_request() function have been dropped.
- The use_init_sdp module parameter has been dropped.
CFGUTILS module
Section titled “CFGUTILS module”- the ts_usec_delta() 5th parameter has changed: it is now a string instead of an integer, allowing arbitrary-sized diffs to be performed (no longer limited to max 2147 seconds).
DIALOG module
Section titled “DIALOG module”- The val parameter of store_dlg_value() is now a variable.
- the first parameter, idx of the set_dlg_flag(), test_and_set_dlg_flag(), reset_dlg_flag(), is_dlg_flag_set() functions is now a static string.
- The
$DLG_flagsvariable now returns a list of flag names separted by space instead of a single integer value.
MID_REGISTRAR module
Section titled “MID_REGISTRAR module”- Check the module docs for the flags parameters of the mid_registrar_save() and mid_registrar_lookup() functions for the mapping between the old and new flag names.
NATHELPER module
Section titled “NATHELPER module”- Check the module docs for the flags parameters of the fix_nated_sdp() and nat_uac_test() functions for the mapping between the old and new flag names.
REGISTRAR module
Section titled “REGISTRAR module”- Check the module docs for the flags parameters of the save() and lookup() functions for the mapping between the old and new flag names.
TM module
Section titled “TM module”- Check the module docs for the flags parameter of the t_relay() function for the mapping between the old and new flag names.
Command line options migration
Section titled “Command line options migration”- The -E option has been removed as standard error logging is used by default until the config script is parsed and a different setting is encountered (i.e. logging to syslog and stderror disabled etc.).