Resources.DocsMigration15to16 History

Show minor edits - Show changes to markup

April 24, 2013, at 03:03 PM by 109.99.235.212 -
Changed lines 1-94 from:

Resources -> Documentation -> Upgrading from 1.5.x to 1.6.x

This page has been visited 5877 times. (:toc-float Table of Content:)


This section is to provide useful help in migrating your OpenSIPS installations from any release from 1.5 branch to any release from 1.6 branch.

You can find the all the new additions in 1.6.x release compiled under this page. Reading it may help you understand the migration / update process.


DB migration

One table was remove, one table had its schema changed and new tables were added (corresponding to the newly added modules).

The biggest change was done in the PERMISSIONS module, where the trusted and address tables were merged into the address table.

You can migrate your 1.5.x DB to the 1.5.x format by using the opensipdbctl(deprecated) or osipsconsole tools:

   # opensipsdbctl migrate opensips_1_5 opensips_1_6
   or
   # osipsconsole 
   > db migrate opensips_1_5 opensips_1_6
   > quit
   # 

where :

  • opensips_1_5 is the existing DB name corresponding to version 1.5.x format
  • opensips_1_6 is the DB name to be created for 1.6.x format

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

Take care and edit (if necessary) the opensipsctlrc / '''osipsconsolerc" files if you want to customize the DB users used for accessing the new DB.

NOTE that the migration tool is available only for MYSQL databases!

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


Script migration

OpenSIPS core

  1. "$branch" pseudovariable was replaced by "$br" variable

RADIUS modules

A generic AAA interface was build in 1.6 ( very similar to the DB interface). Therefore some changes must be made in the script in the parts referring to modules that use RADIUS. First you must load the aaa_radius module which contains the radius implementation for the AAA interface. Second, you must change the name of the module according to the list:

  1. auth_radius modules became auth_aaa module
  2. group_radius module was merged with group module
  3. uri_radius and uri_db were merged with uri module
  4. avp_radius module does not exist anymore and its functionalities were integrated in aaa_radius modules

ALIAS_DB module

  1. use_domain module parameter was removed as replaced by the "d" per-lookup option.

DISPATCHER module

  1. ds_is_from_list() replaced with a more generic function ds_is_in_list("ip","port"). The new function takes as parameters the IP and PORT to test against the dispatcher list, instead of using only the source IP and PORT (as ds_is_from_list()).

ds_is_from_list() == ds_is_in_list("$si","$sp")

GROUP module

  1. is_user_in() renamed as db_is_user_in()
  2. get_user_group() renamed as db_get_user_group()

PERMISSIONS module

  1. the following script parameters are no longer used: peer_tag_avp, trusted_table, source_col
  • ip_addr_col parameter was renamed as ip_col
  • tag_col parameter was renamed as info_col
  • from_col parameter was renamed as pattern_col
  1. the new functions check_address(), check_source_address(), get_source_group() replace old functions allow_address(), allow_source_address(), allow_trusted()

REGISTRAR module

  1. former global parameters like method_filtering, max_contacts, append_branches, use_path, path_mode and path_use_received are now per AOR / function parameters
  2. sock_flag was moved as flag of the save() function

TM module

  1. t_reply() function does not requires any more a prior create Transaction. If no transaction is found, it will be automatically created.
  2. t_cancel_branch() take flags ("a" - cancel all branches; "o" - cancel all other branches except current; "" - current branch); t_cancel_call() is obsoleted and removed (same as t_cancel_branch("a")).

URI module

  1. check_from() renamed to db_check_from()
  2. check_to() renamed to db_check_to()
  3. does_uri_exist() renamed to db_does_uri_exist()
  4. get_auth_id() renamed to db_get_auth_id()
to:

(:redirect Documentation.Migration-1-5-to-1-6 quiet=1 :)

May 25, 2010, at 10:39 PM by bogdan -
Changed lines 87-94 from:
  1. t_cancel_branch() take flags ("a" - cancel all branches; "o" - cancel all other branches except current; "" - current branch); t_cancel_call() is obsoleted and removed (same as t_cancel_branch("a")).
to:
  1. t_cancel_branch() take flags ("a" - cancel all branches; "o" - cancel all other branches except current; "" - current branch); t_cancel_call() is obsoleted and removed (same as t_cancel_branch("a")).

URI module

  1. check_from() renamed to db_check_from()
  2. check_to() renamed to db_check_to()
  3. does_uri_exist() renamed to db_does_uri_exist()
  4. get_auth_id() renamed to db_get_auth_id()
May 25, 2010, at 07:39 PM by bogdan -
Added line 77:
  1. the new functions check_address(), check_source_address(), get_source_group() replace old functions allow_address(), allow_source_address(), allow_trusted()
October 14, 2009, at 12:52 AM by bogdan -
Added line 10:

Changed lines 15-18 from:

PERMISSIONS module

  1. trusted database table is no longer used
  2. address database table has a new schema
to:

The biggest change was done in the PERMISSIONS module, where the trusted and address tables were merged into the address table.

You can migrate your 1.5.x DB to the 1.5.x format by using the opensipdbctl(deprecated) or osipsconsole tools:

   # opensipsdbctl migrate opensips_1_5 opensips_1_6
   or
   # osipsconsole 
   > db migrate opensips_1_5 opensips_1_6
   > quit
   # 

where :

  • opensips_1_5 is the existing DB name corresponding to version 1.5.x format
  • opensips_1_6 is the DB name to be created for 1.6.x format

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

Take care and edit (if necessary) the opensipsctlrc / '''osipsconsolerc" files if you want to customize the DB users used for accessing the new DB.

NOTE that the migration tool is available only for MYSQL databases!

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

October 13, 2009, at 03:57 AM by anca_vamanu -
Changed line 12 from:

A table was remove, very few tables had their schema changed and new tables were added (corresponding to the newly added modules).

to:

One table was remove, one table had its schema changed and new tables were added (corresponding to the newly added modules).

October 13, 2009, at 03:57 AM by anca_vamanu -
Changed lines 59-64 from:
  1. sock_flag was moved as flag of the save() function
to:
  1. sock_flag was moved as flag of the save() function

TM module

  1. t_reply() function does not requires any more a prior create Transaction. If no transaction is found, it will be automatically created.
  2. t_cancel_branch() take flags ("a" - cancel all branches; "o" - cancel all other branches except current; "" - current branch); t_cancel_call() is obsoleted and removed (same as t_cancel_branch("a")).
October 13, 2009, at 03:54 AM by anca_vamanu -
Changed lines 58-59 from:
  1. former global parameters like method_filtering, max_contacts, append_branches, use_path, path_mode and path_use_received are now per AOR / function parameters
to:
  1. former global parameters like method_filtering, max_contacts, append_branches, use_path, path_mode and path_use_received are now per AOR / function parameters
  2. sock_flag was moved as flag of the save() function
October 13, 2009, at 03:48 AM by anca_vamanu -
Added lines 55-58:

REGISTRAR module

  1. former global parameters like method_filtering, max_contacts, append_branches, use_path, path_mode and path_use_received are now per AOR / function parameters
October 13, 2009, at 03:45 AM by anca_vamanu -
Changed lines 51-55 from:
  1. uses only one database table: trusted database table is no longer used and there is a new schema for the address database table
  2. the following script parameters are no longer used: peer_tag_avp, trusted_table, source_col
  • ip_addr_col parameter was renamed as ip_col
  • tag_col parameter was renamed as info_col
  • from_col parameter was renamed as pattern_col
to:
  1. the following script parameters are no longer used: peer_tag_avp, trusted_table, source_col
  • ip_addr_col parameter was renamed as ip_col
  • tag_col parameter was renamed as info_col
  • from_col parameter was renamed as pattern_col
October 13, 2009, at 03:42 AM by anca_vamanu -
Changed lines 12-13 from:

The database structure was not affected by major changes (like changing the format existing tables). But new tables were added (corresponding to the newly added modules).

to:

A table was remove, very few tables had their schema changed and new tables were added (corresponding to the newly added modules).

PERMISSIONS module

  1. trusted database table is no longer used
  2. address database table has a new schema
Added lines 47-55:

PERMISSIONS module

  1. uses only one database table: trusted database table is no longer used and there is a new schema for the address database table
  2. the following script parameters are no longer used: peer_tag_avp, trusted_table, source_col
  • ip_addr_col parameter was renamed as ip_col
  • tag_col parameter was renamed as info_col
  • from_col parameter was renamed as pattern_col
October 13, 2009, at 03:32 AM by anca_vamanu -
Added lines 37-41:

GROUP module

  1. is_user_in() renamed as db_is_user_in()
  2. get_user_group() renamed as db_get_user_group()
October 13, 2009, at 03:30 AM by anca_vamanu -
Changed lines 24-26 from:
  • auth_radius modules became auth_aaa module
  • group_radius module was merged with group module
  • uri_radius and uri_db were merged with uri module
to:
  1. auth_radius modules became auth_aaa module
  2. group_radius module was merged with group module
  3. uri_radius and uri_db were merged with uri module
  4. avp_radius module does not exist anymore and its functionalities were integrated in aaa_radius modules

ALIAS_DB module

  1. use_domain module parameter was removed as replaced by the "d" per-lookup option.

DISPATCHER module

  1. ds_is_from_list() replaced with a more generic function ds_is_in_list("ip","port"). The new function takes as parameters the IP and PORT to test against the dispatcher list, instead of using only the source IP and PORT (as ds_is_from_list()).

ds_is_from_list() == ds_is_in_list("$si","$sp")

October 13, 2009, at 03:13 AM by anca_vamanu -
Changed lines 19-26 from:
  1. "$branch" pseudovariable was replaced by "$br" variable
to:
  1. "$branch" pseudovariable was replaced by "$br" variable

RADIUS modules

A generic AAA interface was build in 1.6 ( very similar to the DB interface). Therefore some changes must be made in the script in the parts referring to modules that use RADIUS. First you must load the aaa_radius module which contains the radius implementation for the AAA interface. Second, you must change the name of the module according to the list:

  • auth_radius modules became auth_aaa module
  • group_radius module was merged with group module
  • uri_radius and uri_db were merged with uri module
October 13, 2009, at 03:04 AM by anca_vamanu -
Added lines 9-19:

DB migration

The database structure was not affected by major changes (like changing the format existing tables). But new tables were added (corresponding to the newly added modules).


Script migration

OpenSIPS core

  1. "$branch" pseudovariable was replaced by "$br" variable
October 13, 2009, at 02:42 AM by anca_vamanu -
Changed line 8 from:

You can find the all the new additions in 1.6.x release compiled [[Main.Ver160 | under this page]. Reading it may help you understand the migration / update process.

to:

You can find the all the new additions in 1.6.x release compiled under this page. Reading it may help you understand the migration / update process.

October 13, 2009, at 02:42 AM by anca_vamanu -
Added lines 1-8:

Resources -> Documentation -> Upgrading from 1.5.x to 1.6.x

This page has been visited 5877 times. (:toc-float Table of Content:)


This section is to provide useful help in migrating your OpenSIPS installations from any release from 1.5 branch to any release from 1.6 branch.

You can find the all the new additions in 1.6.x release compiled [[Main.Ver160 | under this page]. Reading it may help you understand the migration / update process.


Page last modified on April 24, 2013, at 03:03 PM