!! Main -> [[AvailableVersions|Available Versions]] -> [[Main.Ver19x|1.9.x Releases]] -> Release 1.9.0
This page has been visited {$PageCount} times.
(:toc-float Table of Content:)

----
!!! Migration from 1.8.x to 1.9.0

A [[Resources.DocsMigration180to190|manual for how to migrate/update from 1.8.x to 1.9.0 is now available on site]].

----

!!! What is new in 1.9.0

!!!! CORE

* '''Regular Expression Transformations''' : The ability to perform regular expression ops via the new re. class of transformations [[http://www.opensips.org/Resources/DocsCoreTran#toc67| more ...]]
* new '''$stat(name)''' variable to allow you to read via pseudo-variable the value of any statistic variables.
* '''$var()''' script variables have now an explicit value of NULL, so values can be (a) integer, (b) string or (c) NULL. The NULL value can be tested in an "if" conditions
* new '''tcp_listen_backlog''' parameter to be able to control the backlogging of the TCP listeners in OpenSIPS (default value is 10).
* '''cache_fetch()''' can now retrieve the result in any writable pseudo-variable.
* '''avp_print()''' function now prints the AVP name used in the script, rather than the internally used id.
* '''Web Sockets support''' - support for VIA and URI header parsing for WS (Web Socket) and WSS (Web Socket Secure) protocols, allowing WebRTC clients to get registered and make calls using an intermediate proxy such as OverSIP. Using advanced OpenSIPs features like B2BUA and Topo-hiding etc., it may be possible to bridge WebRTC enabled and non-WebRTC enabled SIP endpoints to communicate with each other.
* '''futex lock support''' added support for fast userspace locks (new USE_FUTEX option available via make menuconfig) which provides a faster implementation that will provide reasonable performance boosts in lock heavy environments
* new MI command '''tcp_list_conns''' to list the ongoing TCP/TLS connections [[http://www.opensips.org/Resources/DocsCoreMi#toc5 | See description...]].
* '''CacheDB Raw Queries''' - the ability to run raw queries on NoSQL type back-ends. The Raw query will be in a format specific for the back-end, thus taking full advantage of it's capabilities

!!!! SCRIPTING Enhancements

* new '''script_trace()''' function used to debug script execution flow and values of pseudo-variables in certain areas of the OpenSIPS script [[http://www.opensips.org/Resources/DocsCoreFcn#toc146 | Read more .... ]]
* '''$param()''' pseudo-variable can be used to retrieve parameters passed through the '''route()''' function [[http://www.opensips.org/Resources/DocsCoreFcn#toc145 | more...]]
* '''named flags''' in script - message, script and branch flags have now alphanumerical names, instead of numerical ID (as so far). [[http://lists.opensips.org/pipermail/news/2013-January/000226.html | Read more ...]].

!!!! TIMER Enhancements
* when re-arming a handler function (for next triggering), do not include the time spent on running the handler (two triggering must be exactly at "interval" difference) -> better '''timer accuracy'''
* '''auto-recalibration''' of timer processes to compensate the time drifting because of running the handlers (running the handlers takes time which usually accumulates and de-sync the timers)
* '''report to logs callbacks the abuse (as time usage)''' the timer processes (if a handler uses more than on timer tick -> report it)

!!!! NEW CACHEDB_COUCHBASE module

* '''CouchBase Connector''' - New module implementing the CacheDB interface that allows communication with a CouchBase server/cluster [[http://lists.opensips.org/pipermail/users/2013-January/024308.html | Read More ...]]

!!!! NEW CACHEDB_MONGODB module

* '''MongoDB Connector''' - New module implementing the CacheDB interface that allows communication with a MongoDB server/replica set/cluster . The module also allows to run Raw queries on a MongoDB server [[http://lists.opensips.org/pipermail/users/2013-January/024359.html | Read More ...]]

!!!! NEW CACHEDB_SQL module

* '''CACHEDB_SQL''' - New module implementing the CacheDB interface that allows communication with a regular SQL database. Can come in handy when you want to have dialog profiles sharing or ratelimiting over a regular SQL-based database.

!!!! NEW EVENT_ROUTE module

* The '''event_route''' module can now be used to process events raised by the Event Interface directly from the configuration script. It provides a new type of route, '''event_route''', that can be used to handle different types of events [[http://www.opensips.org/html/docs/modules/devel/event_route | more ...]]

!!!! NEW PI_HTTP module

* '''pi_http''' - Provides a simple web provisioning interface [[http://www.opensips.org/html/docs/modules/devel/pi_http.html| more ...]]

!!!! AAA_RADIUS module
* '''syslog_name''' - new module parameter to control the logging of the client radius library to syslog (enable, disable, set ident name).

!!!! ACC module
* '''Multi-leg BYE support''' - When using automatic CDR accounting, this feature provides the possibility to store per leg information when the call is ended (BYE message is received) [[http://www.opensips.org/html/docs/modules/1.8.x/acc#multi-call-legs| more ...]]
* A new accounting method has been introduced that can trigger events for each accounting message generated (both CDR and old-style accounting) [[ http://www.opensips.org/html/docs/modules/devel/acc#ACC-events-id | more...]]

!!!! B2B_LOGIC module
* '''b2b_init_request()''' takes new flags :
** 't' - transparent TO hdr - instead of generating a new TO header, preserve the received one (TO hdr gets propagated through the B2B)
** 'a' - transparent authentication - if authentication should be done locally (by B2B) or remote (passed back to caller)
* new module parameter '''b2bl_th_init_timeout''' to make the call setup time configurable (via new module param and via runtime flags) for topo hiding scenarios, to avoid early timeouts (if setup takes too long)
* '''b2b_bridge''' MI function enhanced to accept an optional third parameter that permits injecting provisional media in bridging scenario
* '''full support for changes''' - changes done in script before triggering b2b are now propagated inside B2B, on the outbound side; also, the changes done in the b2b request / reply routes are also stored/used and propagated through the B2B.



!!!! CFGUTILS module
* '''New! Script Locks''' - Set of functions which provide critical regions for the script. A critical region is used when a non-atomic sequence of operations (i.e. read + write) is to be performed concurrently by many processes on the same piece of data. [[http://www.opensips.org/html/docs/modules/devel/cfgutils.html| more ...]]
* '''Time recurrence function''' - Matches a given time recurrence string against the current date and returns either true or false. [[http://www.opensips.org/html/docs/modules/devel/cfgutils.html| more ...]]

!!!! DIALOG module

* '''Improved DB interaction''' : Dialog DB structure and usage was reworked, in order to only query by the primary key for all select/delete/update ops
* '''Improved DELAYED DB Mode''' : for the DLG_DELAYED db mode, the dialog deletion is done in the timer process ( old way was deleting on the spot, wherever that was, eg. SIP worker, MI process, etc )
* '''Own Timer Process''' : The dialog module can be configured to have it's own timer process [[http://www.opensips.org/html/docs/modules/devel/dialog.html#id293888| more ...]]
* '''Bulk DB Deletes''' : Added the option to do bulk dialog deletions in the dialog timer process, in order to reduce the number of DB queries [[http://www.opensips.org/html/docs/modules/devel/dialog.html#id293928| more ...]]
* '''New MI command: list_all_profiles''' - Displays all existing profiles [[http://www.opensips.org/html/docs/modules/devel/dialog.html#id295630| more ...]]

!!!! DIALPLAN module

* '''Multiple table support''' - The dialplan rules can now be organized in multiple tables, providing higher flexibility of rules management [[http://www.opensips.org/html/docs/modules/devel/dialplan.html#id292855| more ...]]
* '''Removed match_len column / Added match_flags column''' - The match_flags integer is a bitmask which currently supports enabling caseless comparison on both strings and regex. Set it to 1 to enable such a behaviour. [[http://www.opensips.org/html/docs/modules/devel/dialplan.html#id250408| more ...]]

!!!! DISPATCHER module

* '''New dispatching algorithm''' - The new algorithm allows you to specify the load of each destination using pseudovariables. The destinations will be tried in the ascending order of the loads. [[http://www.opensips.org/html/docs/modules/devel/dispatcher#id293121| more ...]]
* '''IP Blacklisting''' - Dispatching sets of IPs can now be blacklisted [[http://www.opensips.org/html/docs/modules/devel/dispatcher.html#id250383| more ...]]
* '''Count active destinations''' - Counts the number of destinations in a given set that share the same properties (are all active / inactive / probing, or combinations of these states) [[http://www.opensips.org/html/docs/modules/devel/dispatcher.html#id293518| more ...]]

!!!! DROUTING module

* new function '''dr_is_gw( uri, [type, [flag]])''' to test if a generic SIP URI points to a gateway defined in DR module.
* new '''flag "C" do_routing()''' - DR will only check the prefix without doing any routing.
* '''added gw_priprefix_avp''' parameter, for pushing the selected destination's pri prefix to script

!!!! LOAD_BALANCER module

* '''IP Blacklisting''' - Load balancing groups of IPs can now be blacklisted [[http://www.opensips.org/html/docs/modules/devel/load_balancer.html#id250156| more ...]]
* '''lb_is_destination()''' - check if an IP + PORT is a LB destination. [[http://www.opensips.org/html/docs/modules/devel/load_balancer.html#id250355 | See function docs...]]
* '''lb_count_call()''' - a function to count the current call as load (in LB) for a given destination (with some given resources).[[http://www.opensips.org/html/docs/modules/devel/load_balancer.html#id250435 | See function docs...]]


!!!! MI XMLRPC module

* Prevent the XMLRPC server from returning non-XML characters in the response.

!!!! NATHELPER module

* '''natping_tcp flag''' - Enables SIP OPTIONS pinging on TCP/TLS connections [[http://www.opensips.org/html/docs/modules/devel/nathelper.html| more ...]]

!!!! DB_MYSQL module

* The '''db_mysql''' module can now now trigger the '''E_MYSQL_CONNECTION''' when a MySQL connection looses connectivity [[http://www.opensips.org/html/docs/modules/devel/db_mysql#id249964| more ...]]

!!!! PERLVDB module renamed

* renamed as '''db_perlvdb''' to respect the naming convention for DB modules.

!!!! RTPPROXY module

* '''rtpproxy_offer()''' / '''rtpproxy_answer()''' accepts variables in both parameters (IP and FLAGS).

!!!! SIPMSGOPS module

* '''remove_hf(pattern, flags)''' - extended to remove from a message all headers with name matching the pattern wildcard based (which is a shell wildcard pattern) or a pattern regexp based.
* '''sipmsg_validate()''' function takes two more flags: '''m''' to bypass the Max-Forward validation and '''r''' to also validate the Request URI of the message.
* '''stream_exists(media)''' and '''stream_delete(media)''' function added to search / delete entire streams from the SDP. They are really helpful when dealing with FAX or video networks.

!!!! PRESENCE and XCAP modules

* '''new module: XCAP''' - it contains common functionality for XCAP related tasks. It also contains the following XCAP related settings: '''db_url''', '''xcap_table''' and '''integrated_server'''. [[http://www.opensips.org/html/docs/modules/devel/xcap.html| Check the docs]]
* '''enhancements to RLS module''' - Removed configuration parameters which are now in the XCAP module. Added ability to follow external references. Added MI command to update subscriptions when the document has changed.
* '''enhancements to PRESENCE_XML module''' - Added OMA pres-rules support. OMA mode follows the pres-rules specification by the Open Mobile Alliance and can be selected with the [[http://www.opensips.org/html/docs/modules/devel/presence_xml.html#id249988 | pres_rules_auid]] setting.

----
!!! Devel Plan for next release (to be done)

|| border=1
||! Importance ||! Module ||! Description ||
||xxxxx || TCP ||non-blocking TCP operations - push the write/connect op into another process to avoid blocking ||
||xxxx || TM ||even if decide to "go stateful" very early in your script (via t_newtran), all changes you do later over the request (in request route, branch route, failure route) must be updated/pushed into transaction and remembered at later processing ||
||xxxx || new ||new module to drive SANGOMA cards in for transcoding (similar to driving the rtpproxy or mediaproxy) ||
||xxxx || DIALOG ||re-INVITE based in-dialog pinging (with proper SDP handling) ||
||xxx || REGISTRAR ||lookup() should have a flag to force '''lookup on all branches''' (and not only on RURI) ||
||xxx || USRLOC ||distributed storage via a NoSQL DB ||
||xxx || DIALOG ||distributed storage via a NoSQL DB ||
||xxx || USRLOC ||when db is updated based on timer, combine multiple deletes in a single query ||
||xxx || DIALOG ||new MI function to do a complete flush/resync of DB with the memory cache (recover after a DB desyncronization) ||
||xxx || SIPCAPTURE ||TCP support ||
||xx || TLS core ||add an internal API for TLS management to allow registration of certificates ; a new module to allow TLS certificates provisioning via DB (per domain, per IP, etc) ||
||xx || USRLOC ||use a single Primary Key (non SIP related) for DB ops ||
||xx || TM ||allow dynamic number of branches per transaction (on demand) ||
||xx || Statistics Interface ||replace the BIG LOCK (if other arch than i386) with multiple shared locks (to protect the values) ||
||xx || new ||new cachedb_virtual modules, similar to db_virtual, but for NoSQL databases ||
||xx || db_virtual ||Opensips should be able to start even if db_virtual was not able to connect to all databases. So long as it can connect to at least 1 it should still work ||
||xx|| B2B ||Support for attended transfers on B2BUA
||x || new ||new module to allow conversion from cacheDB to DB interface (NoSQL to SQL) ||
||x || new ||RFC6140 Registration for Multiple Phone Numbers

A [[Resources.DocsMigration182to190|manual for how to migrate/update from 1.8.x to 1.9.0 is now available on site]].

!!! Devel Plan for 1.9.x (TODO list)

To be done at Beta Release stage.

* A new accounting method has been introduced that can trigger events for each accounting message generated [[ http://www.opensips.org/html/docs/modules/devel/acc#ACC-events-id | more...]]

!!!! ACC module
* '''Multi-leg BYE support''' - When using automatic CDR accounting, this feature provides the possibility to store per leg information when the call is ended (BYE message is received) [[http://www.opensips.org/html/docs/modules/1.8.x/acc#multi-call-legs| more ...]]

||x || new ||RFC6140 Registration for Multiple Phone Numbers

||xx|| B2B ||Support for processing lumps in B2BUA: before b2b_init_request and in b2b_request/b2b_reply routes

* '''CouchBase Connector''' - New module implementing the CacheDB interface that allows communication with a CouchBase server/cluster

* '''MongoDB Connector''' - New module implementing the CacheDB interface that allows communication with a MongoDB server/replica set/cluster . The module also allows to run Raw queries on a MongoDB server

||xxx|| new ||new module for MongoDB backend for NoSQL ||

||xxx || cacheDB ||cacheDB raw query ||

||x || new ||RFC6140 Registration for Multiple Phone Numbers

* '''lb_count_call()''' - a function to count the current call as load (in LB) for a given destination (with some given resources).
[[http://www.opensips.org/html/docs/modules/devel/load_balancer.html#id250435 | See function docs...]]

||xxx || acc ||NoSQL support as a new acc interface (along log, db and aaa) ||
||xxx || LOAD-BALANCER ||Add a new function to add a call to a gateway's resource (maybe based on the IP address) without calling the load_balance() function; to count also the load generated by the inbound calls (from destinations) ||

!!!! Core

!!!! Scripting Enhancements

||xxx || new ||new module for couchbase backend for NoSQL ||

* '''futex lock support''' added support for fast userspace locks (new USE_FUTEX option available via make menuconfig)

!!!! Scripting enhancements

!!!! Cfgutils module

!!!! Dialog module

!!!! Dialplan module

!!!! Dispatcher module

!!!! Event_route module

* The new '''event_route''' module can now be used to process events raised by the Event Interface directly from the configuration script. It provides a new type of route, '''event_route''', that can be used to handle different types of events [[http://www.opensips.org/html/docs/modules/devel/event_route | more ...]]

!!!! Load balancer module

!!!! Nathelper module

!!!! WEB Provisioning interface module

* '''pi_http''' - Provides a simple web provisioning interface [[http://www.opensips.org/html/docs/modules/devel/pi_http.html| more ...]]

* '''sipmsg_validate()''' function take one more flag '''m''' to bypass the Max-Forward validation.

* '''natping_tcp flag''' - Enables SIP OPTIONS pinging on TCP/TLS connections
[[http://www.opensips.org/html/docs/modules/devel/nathelper.html| more ...]]

* '''named flags''' in script - message, script and branch flags have now alphanumerical names, instead of numerical ID (as so far) .

[[http://lists.opensips.org/pipermail/news/2013-January/000226.html | Read more ...]].

* new '''script_trace()''' function used to debug script execution flow and values of pseudo-variables in certain areas of the OpenSIPS script [[http://www.opensips.org/Resources/DocsCoreFcn#toc146 | Read more .... ]]

* '''$param()''' pseudo-variable can be used to retrieve parameters passed through the '''route()''' function [[http://www.opensips.org/Resources/DocsCoreFcn#toc145 | more...]]

* '''named flags''' in script - message, script and branch flags have now alphanumerical names, instead of numerical ID (as so far) . [[http://lists.opensips.org/pipermail/news/2013-January/000226.html | Read more ...]].

||xxxx|| CORE ||Named flags to replace the numerical ID flags ||

* new '''script_trace()''' function used to debug script execution flow and values of pseudo-variables in certain areas of the OpenSIPS script

* '''$var()''' script variables have now an explicit value of NULL, so values can be (a) interger, (b) string or (c) NULL. The NULL value can be tested in an "if" conditions

||xxxx || Event Interface ||new module to allow script to register routes to be triggered when a certain event is generated ||

* '''remove_hf_wildcard(pattern)''' - new function to remove from message all headers with name matching the pattern “wildcard_hname” (which is a shell wildcard pattern)

* new '''tcp_accept_backlog''' parameter to be able to control the backlogging of the TCP listeners in OpenSIPS (default value is 10).

||xxxx|| CORE ||Proper NULL support for $var ||

* '''new module''' - Provides a simple web provisioning interface [[http://www.opensips.org/html/docs/modules/devel/pi_http.html| more ...]]

||xxx || new ||new module to provide locks / critical regions for script (for doing different kind of atomica test-and-set operations) ||

||xx|| B2B||Support for attended transfers on B2BUA

||x || new||RFC6140 Registration for Multiple Phone Numbers

||xx || TLS core ||add an internal API for TLS management to allow registration of certificates ; a new module to allow TLS certificates provisioning via DB (per domain, per IP, etc) ||

||xx || USRLOC ||use a single Primary Key (non SIP related) for DB ops ||

||xx || TM ||allow dynamic number of branches per transaction (on demand) ||

||xx || Statistics Interface ||replace the BIG LOCK (if other arch than i386) with multiple shared locks (to protect the values) ||

||x || new ||new module to allow conversion from cacheDB to DB interface (NoSQL to SQL) ||

||xx || new ||new cachedb_virtual modules, similar to db_virtual, but for NoSQL databases ||
||xx || db_virtual ||Opensips should be able to start even if db_virtual was not able to connect to all databases. So long as it can connect to at least 1 it should still work ||

||xxx|| new ||new module for MongoDB backend for NoSQL

||xxx || REGISTRAR ||lookup() should have a flag to force '''lookup on all branches''' (and not only on RURI) ||

||xx || TLS core ||add an internal API for TLS management to allow registration of certificates ; a new module to allow TLS certificates provisioning via DB (per domain, per IP, etc) ||
||xxx || USRLOC ||distributed storage via a NoSQL DB ||
||xxx || DIALOG ||distributed storage via a NoSQL DB ||

||xx || USRLOC ||use a single Primary Key (non SIP related) for DB ops ||
||xxx || USRLOC ||when db is updated based on timer, combine multiple deletes in a single query ||

||xx || TM ||allow dynamic number of branches per transaction (on demand) ||
||xxx || DIALOG ||new MI function to do a complete flush/resync of DB with the memory cache (recover after a DB desyncronization) ||

||xxxxx || TCP ||non-blocking TCP operations - push the write/connect op into another process to avoid blocking ||

||xxxx|| CORE ||Named flags to replace the numerical ID flags ||

||xx|| B2B|| Support for attended transfers on B2BUA
||x || new|| RFC6140 Registration for Multiple Phone Numbers

||xxX || acc ||NoSQL support as a new acc interface (along log, db and aaa) ||

||xxx || cacheDB ||cacheDB row query ||

* '''Improved DB interaction''' : Dialog DB structure and usage was reworked, in order to only query by the primary key for all select/delete/update ops
* '''Improved DELAYED DB Mode''' : for the DLG_DELAYED db mode, the dialog deletion is done in the timer process ( old way was deleting on the spot, wherever that was, eg. SIP worker, MI process, etc )
* '''Own Timer Process''' : The dialog module can be configured to have it's own timer process [[http://www.opensips.org/html/docs/modules/devel/dialog.html#id293888| more ...]]
* '''Bulk DB Deletes''' : Added the option to do bulk dialog deletions in the dialog timer process, in order to reduce the number of DB queries [[http://www.opensips.org/html/docs/modules/devel/dialog.html#id293928| more ...]]

||xxxx || DIALOG ||re-INVITE based in-dialog pinging (with prooper SDP handling) ||

||xxx || URLOC ||when db is updated based on timer, combine multiple deletes in a single query ||

|| !Importance || !Module || !Description ||

|| xxx || REGISTRAR || lookup() should have a flag to force '''lookup on all branches''' (and not only on RURI) ||
|| xxxx || Event Interface || new module to allow script to register routes to be triggered when a certain event is generated ||
|| xx || TLS core || add an internal API for TLS management to allow registration of certificates ; a new module to allow TLS certificates provisioning via DB (per domain, per IP, etc) ||
|| xxx || USRLOC || distributed storage via a NoSQL DB ||
|| xxx || DIALOG || distributed storage via a NoSQL DB ||
|| xxxx || TM || even if decide to "go stateful" very early in your script (via t_newtran), all changes you do later over the request (in request route, branch route, failure route) must be updated/pushed into transaction and remembered at later processing ||

!!! What is new in 1.9.0

* '''IP Blacklisting''' - Load balancing groups of IPs can now be blacklisted [[http://www.opensips.org/html/docs/modules/devel/load_balancer.html#id250156| more ...]]

!! Main -> [[AvailableVersions|Available Versions]] -> [Main.Ver19x|1.9.x Releases] -> Release 1.9.0

!! Main -> [[AvailableVersions|Available Versions]] -> Release 1.9.0

!! Main -> [[Main.Releases|Releases]] -> Release 1.9.0

* '''IP Blacklisting''' - Dispatching sets of IPs can now be blacklisted [[http://www.opensips.org/html/docs/modules/devel/dispatcher.html#id250384| more ...]]
* '''Count active destinations''' - Counts the number of destinations in a given set that share the same properties (are all active / inactive / probing, or combinations of these states) [[http://www.opensips.org/html/docs/modules/devel/dispatcher#id293121| more ...]]

* '''New dispatching algorithm''' - The new algorithm allows you to specify the load of each destination using pseudovariables. The destinations will be tried in the ascending order of the loads. [[http://www.opensips.org/html/docs/modules/devel/dispatcher#id293121| more ...]]

* '''MI command: list_all_profiles''' - Displays all existing profiles [[http://www.opensips.org/html/docs/modules/devel/dialog.html#id295630| more ...]]

!!!! Dialog module

* '''MI command: list_all_profiles''' - Displays all existing profiles [[http://www.opensips.org/html/docs/modules/devel/dialog.html#id295630| more ...]]

* '''Multiple table support''' - The dialplan rules can now be organized in multiple tables, providing higher flexibility of rules management [[http://www.opensips.org/html/docs/modules/devel/dialplan.html#id292854| more ...]]

!!!! Load balancer & Dispatcher modules

* '''IP Blacklisting''' - Load balancing groups / Dispatching sets of IPs can now be blacklisted [[http://www.opensips.org/html/docs/modules/devel/dispatcher.html#id250384| more ...]]

* '''Removed match_len column / Added match_flags column''' - The match_flags integer is a bitmask which currently supports caseless comparison on both strings and regex. Set it to 1 to enable such a behaviour. [[http://www.opensips.org/html/docs/modules/devel/dialplan.html#id250408| more ...]]

* '''Multiple table support''' - The dialplan rules can now be organized in multiple tables, providing higher flexibility of rules management [[http://www.opensips.org/html/docs/modules/devel/dialplan.html#id292854| more ...]]

!!!! Dialplan

* '''Multiple table support''' - The dialplan rules can now be organized in multiple tables, in order to offer higher flexibility [[http://www.opensips.org/html/docs/modules/devel/dialplan.html#id292854| more ...]]