Documentation -> Migration -> Migration from 2.4.x to 3.0.0
This page has been visited 276 times.
This section is meant to provide useful help in migrating your OpenSIPS installations from the 2.4.0 version to 3.0.0.
You can find the all the new additions in the 3.0.0 release compiled under this page. The ChangeLog may help your understanding of the migration / update process.
Make sure you don't have any Makefile.conf files in your sources' root before starting the migration. The configuration file generated by 'menuconfig is not compatible with the one in older version!
1. DB migration
You can migrate your 2.4.x MySQL DB to the 3.0.x format by using the opensipsdbctl tool :
# opensipsdbctl migrate opensips_2_4 opensips_3_0
- opensips_2_4 is the existing DB name corresponding to version 2.4.x format
- opensips_3_0 is the DB name to be created for 3.0.x format
- 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
NOTE that the migration tool is available only for MYSQL databases!
NOTE that the default MySQL DB engine is now InnoDB!
Back to Table of Contents
2. Script migration
The following is the full list of backwards-incompatible syntax or functional changes in the OpenSIPS configuration script (some of them are fixes):
2.1 Global Parameters
- the children parameter is replaced by udp_workers parameter. The old name is marked as obsolete, but it still can be used (it will be effectively removed in the next release)
- the tcp_children parameter is replaced by tcp_workers parameter. The old name is marked as obsolete, but it still can be used (it will be effectively removed in the next release)
- the use_children option inside the listen parameter is replaced by use_workers. The old name is marked as obsolete, but it still can be used (it will be effectively removed in the next release)
2.2 Core keywords
2.3 Core MI commands
2.4 Statistics migration
3. Module migration
3.2 AUTH_AAA module
3.3 DB_MYSQL module
- the tls_client_domain module parameter was removed in favor of a new way of enabling TLS for specific MySQL connections via the DB URL.
3.4 CLUSTERER module
- the current_id, current_info and neighbor_info module parameters were renamed to my_node_id, my_node_info and neighbor_node_info respectively.
3.5 DIALOG module
3.6 DROUTING module
3.7 LOAD_BALANCER module
3.8 PRESENCE module
3.9 REST_CLIENT module
3.10 TLS_MGM module
- the address column from the tls_mgm table was removed and the TLS domain matching is now driven by two new columns: match_ip_address and match_sip_domain
- the syntax for the server_domain and client_domain parameters now only accepts the TLS domain name
- the client_domain_avp module parameter was renamed to client_tls_domain_avp
3.11 URI module