Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
install:3.0.x-to-3.1.x [2010/10/04 10:02]
miconda
install:3.0.x-to-3.1.x [2010/10/11 20:05] (current)
87.93.206.26
Line 1: Line 1:
 ====== Upgrade from 3.0.x to 3.1.x ====== ====== Upgrade from 3.0.x to 3.1.x ======
- 
-Note: 3.1.x has not been released it, target date is September 2010. Until then, 3.1.x means GIT master branch (development version). 
  
 3.0.x refers to Kamailio releases 3.0.x and SR branch sr_3.0. 3.0.x refers to Kamailio releases 3.0.x and SR branch sr_3.0.
Line 42: Line 40:
 </code> </code>
  
-Next is the MySQL script to update tables for lcr module. **Beware** that you will lose old data you had for lcr module since the new version requires new tables, therefore old tables are removed.+==== lcr tables ==== 
 + 
 +You can migrate from old data and db structure of lcr module to new version by using migration script available at: 
 +  * http://box.openxg.com/tmp/lcr_upgrade_from_3.0.sh 
 + 
 +If you want to do by hand or you don't have any data in lcr module tables, then next is the MySQL script to update tables for lcr module. **Beware** that by running the script as provided next, you will lose old data you had for lcr module since the new version requires new tables, therefore old tables are removed.
  
 <code c> <code c>
Line 98: Line 101:
  
   * module was merged into modules/auth   * module was merged into modules/auth
-  * rpid related functions and parameters moved to siputils +  * RPID related functions and parameters moved to siputils 
-  * none_reuse parameter removed, you have to use one_time_nonce parameter instead+  * nonce_reuse parameter removed, you have to use one_time_nonce parameter instead 
 +  * PV authentication functions were re-designed. See README of the module for new prototype and more details: 
 +  * http://kamailio.org/docs/modules/3.1.x/modules/auth.html
  
-==== modules_k/permissions ==== 
  
-  * a new column in address table to hold a tag value per record. The value is returned in peer tag avp upon address matching.+==== modules_k/auth_radius ====
  
-==== modules/tm ====+  * Module is now using modules/auth api. 
 +  * Functions radius_www_authorize()/radius_proxy_authorize() now return a new negative result value -2 if there was something wrong in the request. 
 +  * Realm argument must now be always given when radius_www_authorize()/radius_proxy_authorize() functions are called. 
 +  * See http://kamailio.org/docs/modules/3.1.x/modules/auth.html for new auth module parameters.
  
-  * no timer parameters value adjustments - they are milisecond, therefore make sure the values of **fr_inv_timer**, **fr_timer** are given in mili-seconds otherwise you get a very fast timeout. Note that dynamic timeout values given via avps for each transaction are still in seconds. You can use t_set_fr(...) functions with milisecond parameters as alternative to avps. +==== modules_k/dialog ====
-  * new parameter **failure_reply_mode** to control winning branch selection (reply code) for failure_route - if you used kamailio config, be sure you set this parameter to **3** in order to have same behavior as in 1.5.x or lower and 3.0.x. Otherwise, see t_drop_replies() function to control the behaviour per transaction inside config file, within failure_route.+
  
 +  * If configuration parameter "detect_spirals" is set (true by default), spiraling messages will be detected and not cause the creation of another dialog structure. Otherwise, the old behavior of maintaining one dialog per spiral occurrence will be maintained.
 +  * New callback type DLGCB_SPIRALED will be executed on detection of a spiraling message ("detect_spirals" must be enabled, however).
 +  * Changes to database: toroute column was removed, toroute_name column was added
 +
 +==== modules_k/dispatcher ====
 +
 +  * Changes to database: attrs column was added
  
 ==== modules/lcr ==== ==== modules/lcr ====
Line 121: Line 134:
   * MI functions are not supported anymore; use RPC functions instead.   * MI functions are not supported anymore; use RPC functions instead.
  
-==== modules_k/auth_radius ====+==== modules_k/nathelper ====
  
-  * Module is now using modules_s/auth api, which means that modules_s/auth module needs to be loaded instead of modules_k/auth module before this module is loaded+  * rtpproxy functionality was removed from the nathelper module and belongs to the new rtpproxy module - see README files for both modules
-  * Functions www_challenge()/proxy_challenge() are not anymore used to send 401/407 responses.  See examples in README file on how to send those responses. + 
-  * Functions radius_www_authorize()/radius_proxy_authorize() now return a new negative result value -2 if there was something wrong in the request. +==== modules_k/permissions ==== 
-  * Realm argument must now be always given when radius_www_authorize()/radius_proxy_authorize() functions are called. + 
-  * See modules_s/auth for new auth module parameters.+  * a new column in address table to hold a tag value per record. The value is returned in peer tag avp upon address matching.
  
 ==== modules_k/ratelimit ==== ==== modules_k/ratelimit ====
  
   * rl_drop() was dropped (same functionality can be achieved with: append_to_reply() and sl_send_reply() - see the README file.   * rl_drop() was dropped (same functionality can be achieved with: append_to_reply() and sl_send_reply() - see the README file.
 +  * module moved to modules/ratelimit
  
-==== modules_k/nathelper ====+==== modules_k/sl ====
  
-  * rtpproxy functionality was removed from the nathelper module and belongs to the new rtpproxy module - see README files for both modules.+  * module was merged in **modules/sl**
  
-==== modules_k/dialog ====+==== modules_k/sms ====
  
-  * If configuration parameter "detect_spirals" is set (true by default), spiraling messages will be detected and not cause the creation of another dialog structure. Otherwise, the old behavior of maintaining one dialog per spiral occurrence will be maintained. +  * module was merged in **modules/sms** 
-  New callback type DLGCB_SPIRALED will be executed on detection of a spiraling message ("detect_spirals" must be enabled, however).+ 
 +==== modules/tm ==== 
 + 
 +**IMPORTANT - pay attention to next changes**
  
 +  * removed the auto-adjustment of timer parameters for too low values (in Kamailio 3.0.x, if the value was lower than 120, they were multiplied with 1000)
 +    * all timer parameters must be set in milisecond
 +      * make sure the values of **fr_inv_timer**, **fr_timer** are given in mili-seconds otherwise you get a very fast timeout
 +    * note that dynamic timeout values given via avps for each transaction are still in seconds
 +    * you can use t_set_fr(...) functions with milisecond parameters as alternative to avps.
 +  * new parameter **failure_reply_mode** to control winning branch selection (reply code) for failure_route
 +    * if you used kamailio config, be sure you set this parameter to **3** in order to have same behavior as in 1.5.x or lower and 3.0.x
 +    * otherwise, see t_drop_replies() function to control the behaviour per transaction inside config file, within failure_route.
  
 ===== Core ===== ===== Core =====
  
-  * no effect of config compat mode in core drop() action is the same all the time +  * no more different behaviour based on config compat mode in core 
-    * drop a reply in onreply route +    * drop() action is the same all the time 
-    * drop the request in onsend route+      * drop a reply in onreply route 
 +      * drop the request in onsend route
  
  

Navigation

Wiki

Other

QR Code
QR Code install:3.0.x-to-3.1.x (generated for current page)