!!! 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.).

* the [[ https://opensips.org/docs/modules/3.4.x/cfgutils.html#func_ts_usec_delta | 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).

* no changes to ''opensips.cfg'' syntax

* no changes

* * no changes

* No backwards-incompatible changes to the ''opensips.cfg'' syntax recorded so far!

* no changes

* no changes

* no changes

* [[https://www.opensips.org/Documentation/Script-CoreParameters-3-4#log_facility|log_facility]] has been deprecated and replaced with [[https://www.opensips.org/Documentation/Script-CoreParameters-3-4#syslog_facility|syslog_facility]].
* [[https://www.opensips.org/Documentation/Script-CoreParameters-3-4#log_name|log_name]] has been deprecated and replaced with [[https://www.opensips.org/Documentation/Script-CoreParameters-3-4#syslog_name|syslog_name]].
* [[https://www.opensips.org/Documentation/Script-CoreParameters-3-4#log_stderror|log_stderror]] has been deprecated and is now equivalent with setting the new [[https://www.opensips.org/Documentation/Script-CoreParameters-3-4#stderror_enabled|stderror_enabled]] and [[https://www.opensips.org/Documentation/Script-CoreParameters-3-4#syslog_enabled|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''.

* NEW package available in the repos: '''opensips-auth-modules''', containing both the '''[[ https://opensips.org/docs/modules/3.4.x/auth.html | auth ]]''' and '''[[ https://opensips.org/docs/modules/3.4.x/uac_auth.html | uac_auth ]]''' modules, mainly due to their extra dependency on a TLS library to be present on the system (e.g. OpenSSL or WolfSSL)

* NEW package available in the repos: '''opensips-auth-modules''', containing both the '''auth''' and '''uac_auth''' modules, mainly due to their extra dependency on a TLS library to be present on the system (e.g. OpenSSL or WolfSSL)

* NEW package available in the repos: '''opensips-auth-modules''', containing both the '''auth''' and '''uac_auth''' modules, mainly due to their extra dependency on a TLS library (e.g. OpenSSL or WolfSSL)

* Check the module docs for the '''flags''' parameter of the [[https://opensips.org/docs/modules/3.4.x/tm.html#func_t_relay|t_relay()]] function for the mapping between the old and new flag names.

!!! Packaging migration

!!!! AUTH modules
* the '''auth''' and '''uac_auth''' module are now part of a new package, '''opensips-auth-modules''', mainly due to their extra dependency on a TLS library (e.g. OpenSSL or WolfSSL)

* The [[https://opensips.org/docs/modules/3.4.x/dialog.html#pv_DLG_flags|$DLG_flags]] variable now returns a list of flag names separted by space instead of a single integer value.

!!!! MID_REGISTRAR module
* Check the module docs for the '''flags''' parameters of the [[https://opensips.org/docs/modules/3.4.x/mid_registrar.html#func_mid_registrar_save|mid_registrar_save()]] and [[https://opensips.org/docs/modules/3.4.x/mid_registrar.html#func_mid_registrar_lookup|mid_registrar_lookup()]] functions for the mapping between the old and new flag names.


!!!! NATHELPER module
* Check the module docs for the '''flags''' parameters of the [[https://opensips.org/docs/modules/3.4.x/nathelper.html#func_fix_nated_sdp|fix_nated_sdp()]] and [[https://opensips.org/docs/modules/3.4.x/nathelper.html#func_nat_uac_test|nat_uac_test()]] functions for the mapping between the old and new flag names.

!!!! REGISTRAR module
* Check the module docs for the '''flags''' parameters of the [[https://opensips.org/docs/modules/3.4.x/registrar.html#func_save|save()]] and [[https://opensips.org/docs/modules/3.4.x/registrar.html#func_lookup|lookup()]] functions for the mapping between the old and new flag names.

!!!! TM module
* Check the module docs for the '''flags''' parameter of the [[https://opensips.org/docs/modules/3.4.x/tm.html#func_t_relay|t_relay()]] function for the mapping between the old and new flag names.

* The [[https://opensips.org/docs/modules/3.4.x/dialog.html#pv_DLG_flags|$DLG_flags]] variable now returns a list of flag names separted by space instead of a single integer value.

* The '''val''' parameter of [[https://opensips.org/docs/modules/3.4.x/dialog.html#func_store_dlg_value|store_dlg_value()]] is now a variable.
* the first parameter, '''idx''' of the [[https://opensips.org/docs/modules/3.4.x/dialog.html#func_set_dlg_flag|set_dlg_flag()]], [[https://opensips.org/docs/modules/3.4.x/dialog.html#func_test_and_set_dlg_flag|test_and_set_dlg_flag()]], [[https://opensips.org/docs/modules/3.4.x/dialog.html#func_reset_dlg_flag|reset_dlg_flag()]], [[https://opensips.org/docs/modules/3.4.x/dialog.html#func_is_dlg_flag_set|is_dlg_flag_set()]] functions is now a static string.
* The [[https://opensips.org/docs/modules/3.4.x/dialog.html#pv_DLG_flags|$DLG_flags]] variable now returns a list of flag names separted by space instead of a single integer value).

* example

!!!! DIALOG module
* The '''val''' parameter of [[https://opensips.org/docs/modules/3.4.x/dialog.html#func_store_dlg_value|store_dlg_value()]] is now a variable.

* The flags of the [[https://opensips.org/docs/modules/3.4.x/b2b_logic.html#func_b2b_bridge|b2b_bridge()]] function have been renamed as following:

* The flags of the [[https://opensips.org/docs/modules/3.4.x/b2b_logic.html#func_b2b_init_request|b2b_init_request()]] function have been renamed as following:

* The '''init_sdp_body''' and '''init_sdp_ctype''' parameters of the [[https://opensips.org/docs/modules/3.4.x/b2b_logic.html#func_b2b_init_request|b2b_init_request()]] function have been dropped.
* The '''use_init_sdp''' module parameter has been dropped.

!!!! B2B_LOGIC module
* The flags of the [[https://opensips.org/docs/modules/3.4.x/b2b_logic.html#func_b2b_bridge_retry|b2b_bridge_retry()]] function have been renamed as following:
** '''n''' to '''notify'''
** '''f''' to '''rollback-failed'''
** '''t[nn]''' to '''max_duration=[int]'''.
* The flags of the [[https://opensips.org/docs/modules/3.4.x/b2b_logic.html#func_b2b_init_request|b2b_bridge_retry()]] function have been renamed as following:
** '''a''' to '''transparent-auth'''
** '''p''' to '''preserve-to'''
** '''t[nn]''' to '''setup-timeout=[nn]'''

!!!! CFGUTILS module
* the 'ts_usec_delta()' 5th parameter has changed

* the output of the [[https://www.opensips.org/Documentation/Interface-CoreMI-3-4#list_blacklists|list_blacklists]] rules have changed to improve readability:

* the output of the [[https://www.opensips.org/Documentation/Interface-CoreMI-3-4#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"

!!!!!Documentation -> [[Documentation.Migration|Migration]] -> Migration from 3.3.x to 3.4.0
This page has been visited {$PageCount} times.
(:toc-float Table of Contents:)
----

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 [[ About.Version-3-4-0| under this page]]. The ChangeLog may help your understanding of the migration / update process.

%red% Make sure you don't carry a left-over '''Makefile.conf''' file in your OpenSIPS source tree if migrating to a new branch! This configuration file, generated by ''make menuconfig'', is usually not compatible with the one of a previous major release! %%

----
!!! 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_4
@]
where :
* 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 [[https://github.com/OpenSIPS/opensips-cli/blob/master/docs/modules/database.md#database-migration-mysql-only|the opensips-cli documentation]] for more details.

NOTE:
* the old database will not be deleted, altered or changed - it will not be touched at all
* new database will be created and data from old DB will be imported into it

(:toc-back Back to Table of Contents:)

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

* example

!!!! Global Parameters

* example

!!!! Core Variables

* example

!!!! Core keywords

* example

!!!! Core functions

* example

!!!! Core MI commands

* example

!!!! Statistics migration

* example

!!! Module migration


!!!! CGRateS module
* example