<html>
<head>
<base href="https://wiki.asterisk.org/wiki">
<link rel="stylesheet" href="/wiki/s/en/2176/18/9/_/styles/combined.css?spaceKey=AST&forWysiwyg=true" type="text/css">
</head>
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
<h2><a href="https://wiki.asterisk.org/wiki/display/AST/Upgrading+to+Asterisk+11">Upgrading to Asterisk 11</a></h2>
<h4>Page <b>edited</b> by <a href="https://wiki.asterisk.org/wiki/display/~mjordan">Matt Jordan</a>
</h4>
<br/>
<h4>Changes (16)</h4>
<div id="page-diffs">
<table class="diff" cellpadding="0" cellspacing="0">
<tr><td class="diff-snipped" >...<br></td></tr>
<tr><td class="diff-unchanged" >h3. Voicemail <br> <br></td></tr>
<tr><td class="diff-changed-lines" >All voicemails now have a <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">_msg_id_</span> <span class="diff-added-words"style="background-color: #dfd;">{{msg_id}}</span> included in their metadata which uniquely identifies a message. For users of file system and IMAP storage of voicemail, this should be transparent. For users of ODBC, you will need to add a <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">_msg_id_</span> <span class="diff-added-words"style="background-color: #dfd;">{{msg_id}}</span> column to your voice mail messages table. This should be a string capable of holding at least 32 characters. <br></td></tr>
<tr><td class="diff-unchanged" > <br>All messages created in old Asterisk installations will have a _msg_id_ added to them when required. This operation should be transparent as well. <br></td></tr>
<tr><td class="diff-snipped" >...<br></td></tr>
<tr><td class="diff-unchanged" >chan_gtalk has been deprecated in favour of the chan_motif channel driver. It is recommended that users switch to using it as it is a core supported module. <br> <br></td></tr>
<tr><td class="diff-changed-lines" >Please see [Calling Using <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">Google|https://wiki.asterisk.org/wiki/display/AST/Calling+using+Google]</span> <span class="diff-added-words"style="background-color: #dfd;">Google|AST:Calling using Google]</span> for more information. <br></td></tr>
<tr><td class="diff-unchanged" > <br>h3. chan_jingle <br></td></tr>
<tr><td class="diff-snipped" >...<br></td></tr>
<tr><td class="diff-unchanged" >chan_jingle has been deprecated in favour of the chan_motif channel driver. It is recommended that users switch to using it as it is a core supported module. <br> <br></td></tr>
<tr><td class="diff-changed-lines" >Please see [Calling Using <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">Google|https://wiki.asterisk.org/wiki/display/AST/Calling+using+Google]</span> <span class="diff-added-words"style="background-color: #dfd;">Google|AST:Calling using Google]</span> for more information. <br></td></tr>
<tr><td class="diff-unchanged" > <br>h3. chan_sip <br> <br>* SIP_CAUSE is now deprecated. It has been modified to use the same mechanism as the&nbsp;[HANGUPCAUSE|AST:Asterisk 11 Function_HANGUPCAUSE]&nbsp;function. Behaviour should not change, but performance should be vastly improved. The [HANGUPCAUSE|AST:Asterisk 11 Function_HANGUPCAUSE] function should now be used instead of SIP_CAUSE. Because of this, the _storesipcause_ option in sip.conf is also deprecated. Please see&nbsp;[AST:Hangup Cause]&nbsp;for more information. <br></td></tr>
<tr><td class="diff-changed-lines" >* ICE support has been added and is enabled by default. Some endpoints may have problems with the ICE candidates within the SDP. If this is the case ICE support can be disabled globally or on a per-endpoint basis using the <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">_icesupport_</span> <span class="diff-added-words"style="background-color: #dfd;">{{icesupport}}</span> configuration option. Symptoms of this include one way media or no media flow. <br></td></tr>
<tr><td class="diff-unchanged" > <br>h3. chan_unistim <br> <br></td></tr>
<tr><td class="diff-changed-lines" >Due to massive <span class="diff-changed-words">update<span class="diff-added-chars"style="background-color: #dfd;">s</span></span> in chan_unistim phone keys functions and on-screen information <span class="diff-added-words"style="background-color: #dfd;">has</span> changed. <br></td></tr>
<tr><td class="diff-unchanged" > <br>Please see the [Unistim Channel Improvements|https://wiki.asterisk.org/wiki/display/AST/Unistim+channel+improvements] for more information. <br></td></tr>
<tr><td class="diff-snipped" >...<br></td></tr>
<tr><td class="diff-unchanged" >h2. Dialplan Functions <br> <br></td></tr>
<tr><td class="diff-changed-lines" >* [MAILBOX_EXISTS|AST:Asterisk 11 Function_MAILBOX_EXISTS] has been deprecated. Use [VM_INFO|AST:Asterisk 11 Function_VM_INFO] with the <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">'_exists_'</span> <span class="diff-added-words"style="background-color: #dfd;">'{{exists}}'</span> parameter instead. <br></td></tr>
<tr><td class="diff-unchanged" >* [Macro|AST:Asterisk 11 Application_Macro] has been deprecated in favour of [Gosub|AST:Asterisk 11 Application_Gosub]. While Macro has been deprecated for some time, in Asterisk 11 all internal functions that relied on Macros have been transitioned to use GoSub. For redirecting and connected line purposes use the following variables instead of their macro equivalents: <br></td></tr>
<tr><td class="diff-changed-lines" >** <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">_REDIRECTING_SEND_SUB_</span> <span class="diff-added-words"style="background-color: #dfd;">{{REDIRECTING_SEND_SUB}}</span> <br></td></tr>
<tr><td class="diff-changed-lines" >** <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">_REDIRECTING_SEND_SUB_ARGS_</span> <span class="diff-added-words"style="background-color: #dfd;">{{REDIRECTING_SEND_SUB_ARGS}}</span> <br></td></tr>
<tr><td class="diff-changed-lines" >** <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">_CONNECTED_LINE_SEND_SUB_</span> <span class="diff-added-words"style="background-color: #dfd;">{{CONNECTED_LINE_SEND_SUB}}</span> <br></td></tr>
<tr><td class="diff-changed-lines" >** <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">_CONNECTED_LINE_SEND_SUB_ARGS_</span> <span class="diff-added-words"style="background-color: #dfd;">{{CONNECTED_LINE_SEND_SUB_ARGS}}</span> <br></td></tr>
<tr><td class="diff-unchanged" >* The [HANGUPCAUSE|AST:Asterisk 11 Function_HANGUPCAUSE] and [HANGUPCAUSE_KEYS|AST:Asterisk 11 Function_HANGUPCAUSE_KEYS] functions have been introduced to provide a replacement for the SIP_CAUSE hash. The [HangupCauseClear|AST:Asterisk 11 Application_HangupCauseClear]&nbsp;application has also been introduced to remove this data from the channel when necessary. Please see <br>* [ENUM|E.164 NUmber Mapping (ENUM)|AST:E.164 NUmber Mapping (ENUM)] query functions now return a count of \-1 on lookup error to differentiate between a failed query and a successful query with 0 results matching the specified type. <br></td></tr>
<tr><td class="diff-snipped" >...<br></td></tr>
<tr><td class="diff-unchanged" >h3. Logging <br> <br></td></tr>
<tr><td class="diff-changed-lines" >The <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">_verbose_</span> <span class="diff-added-words"style="background-color: #dfd;">{{verbose}}</span> setting in <span class="diff-changed-words"><span class="diff-added-chars"style="background-color: #dfd;">_</span>logger.conf<span class="diff-added-chars"style="background-color: #dfd;">_</span></span> now takes an optional argument specifying the verbosity level for each logging destination. The default, if not otherwise specified, is a verbosity of 3. <br></td></tr>
<tr><td class="diff-unchanged" > <br>h3. AMI <br> <br>* [DBdeltree|AST:Asterisk 11 Application_DBdeltree] now correctly returns an error when 0 rows are deleted just as the [DBdel|AST:Asterisk 11 Application_DBdel] action does. <br></td></tr>
<tr><td class="diff-changed-lines" >* The IAX2 PeerStatus event now sends a <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">_Port_</span> <span class="diff-added-words"style="background-color: #dfd;">{{Port}}</span> header. In Asterisk 10, this was erroneously being sent as a <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">_Post_</span> <span class="diff-added-words"style="background-color: #dfd;">{{Post}}</span> header. <br></td></tr>
<tr><td class="diff-unchanged" > <br>h3. CCSS <br> <br></td></tr>
<tr><td class="diff-changed-lines" >Macro is deprecated. Use <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">_cc_callback_sub_</span> <span class="diff-added-words"style="background-color: #dfd;">{{cc_callback_sub}}</span> instead of <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">_cc_callback_macro_</span> <span class="diff-added-words"style="background-color: #dfd;">{{cc_callback_macro}}</span> in channel configurations. <br></td></tr>
<tr><td class="diff-unchanged" > <br>h3. Parking <br> <br></td></tr>
<tr><td class="diff-changed-lines" >* The <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">_comebacktoorigin_</span> <span class="diff-added-words"style="background-color: #dfd;">{{comebacktoorigin}}</span> setting must now be set per parking lot. The setting in the general section will not be applied automatically to each parking lot. <br></td></tr>
<tr><td class="diff-changed-lines" >* The <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">_BLINDTRANSFER_</span> <span class="diff-added-words"style="background-color: #dfd;">{{BLINDTRANSFER}}</span> channel variable is deleted from a channel when it is bridged to prevent subtle bugs in the parking feature. The channel variable is used by Asterisk internally for the [Park|AST:Asterisk 11 Application_Park] application to work properly. If you were using it for your own purposes, copy it to your own channel variable before the channel is bridged. <br></td></tr>
<tr><td class="diff-unchanged" > <br>h3. users.conf <br> <br></td></tr>
<tr><td class="diff-changed-lines" >A defined user with <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">_hasvoicemail=yes_</span> <span class="diff-added-words"style="background-color: #dfd;">{{hasvoicemail=yes}}</span> now finally uses a Gosub to <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">_stdexten_</span> <span class="diff-added-words"style="background-color: #dfd;">{{stdexten}}</span> as documented in <span class="diff-changed-words"><span class="diff-added-chars"style="background-color: #dfd;">_</span>extensions.conf.sample<span class="diff-added-chars"style="background-color: #dfd;">_</span></span> since v1.6.0 instead of a Macro as documented in v1.4. Set the asterisk.conf <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">_stdexten=macro_</span> <span class="diff-added-words"style="background-color: #dfd;">{{stdexten=macro}}</span> parameter to invoke the <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">_stdexten_</span> <span class="diff-added-words"style="background-color: #dfd;">{{stdexten}}</span> the old way. <br></td></tr>
</table>
</div> <h4>Full Content</h4>
<div class="notificationGreySide">
<p>The following are changes made in Asterisk 11 that may affect your configuration when upgrading.</p>
<h2><a name="UpgradingtoAsterisk11-Applications"></a>Applications</h2>
<h3><a name="UpgradingtoAsterisk11-Voicemail"></a>Voicemail</h3>
<p>All voicemails now have a <tt>msg_id</tt> included in their metadata which uniquely identifies a message. For users of file system and IMAP storage of voicemail, this should be transparent. For users of ODBC, you will need to add a <tt>msg_id</tt> column to your voice mail messages table. This should be a string capable of holding at least 32 characters.</p>
<p>All messages created in old Asterisk installations will have a <em>msg_id</em> added to them when required. This operation should be transparent as well.</p>
<h3><a name="UpgradingtoAsterisk11-MeetMe"></a>MeetMe</h3>
<p>The '<b>c</b>' option (announce user count) will now work even if the '<b>q</b>' (quiet) option is enabled.</p>
<h3><a name="UpgradingtoAsterisk11-FollowMe"></a>FollowMe</h3>
<p>Answered outgoing calls no longer get cut off when the next step is started. You now have until the last step times out to decide if you want to accept the call or not before being disconnected.</p>
<h2><a name="UpgradingtoAsterisk11-ChannelDrivers"></a>Channel Drivers</h2>
<h3><a name="UpgradingtoAsterisk11-changtalk"></a>chan_gtalk</h3>
<p>chan_gtalk has been deprecated in favour of the chan_motif channel driver. It is recommended that users switch to using it as it is a core supported module.</p>
<p>Please see <a href="/wiki/display/AST/Calling+using+Google" title="Calling using Google">Calling Using Google</a> for more information.</p>
<h3><a name="UpgradingtoAsterisk11-chanjingle"></a>chan_jingle</h3>
<p>chan_jingle has been deprecated in favour of the chan_motif channel driver. It is recommended that users switch to using it as it is a core supported module.</p>
<p>Please see <a href="/wiki/display/AST/Calling+using+Google" title="Calling using Google">Calling Using Google</a> for more information.</p>
<h3><a name="UpgradingtoAsterisk11-chansip"></a>chan_sip</h3>
<ul>
<li>SIP_CAUSE is now deprecated. It has been modified to use the same mechanism as the <a href="/wiki/display/AST/Asterisk+11+Function_HANGUPCAUSE" title="Asterisk 11 Function_HANGUPCAUSE">HANGUPCAUSE</a> function. Behaviour should not change, but performance should be vastly improved. The <a href="/wiki/display/AST/Asterisk+11+Function_HANGUPCAUSE" title="Asterisk 11 Function_HANGUPCAUSE">HANGUPCAUSE</a> function should now be used instead of SIP_CAUSE. Because of this, the <em>storesipcause</em> option in sip.conf is also deprecated. Please see <a href="/wiki/display/AST/Hangup+Cause" title="Hangup Cause">Hangup Cause</a> for more information.</li>
<li>ICE support has been added and is enabled by default. Some endpoints may have problems with the ICE candidates within the SDP. If this is the case ICE support can be disabled globally or on a per-endpoint basis using the <tt>icesupport</tt> configuration option. Symptoms of this include one way media or no media flow.</li>
</ul>
<h3><a name="UpgradingtoAsterisk11-chanunistim"></a>chan_unistim</h3>
<p>Due to massive updates in chan_unistim phone keys functions and on-screen information has changed.</p>
<p>Please see the <a href="https://wiki.asterisk.org/wiki/display/AST/Unistim+channel+improvements" class="external-link" rel="nofollow">Unistim Channel Improvements</a> for more information.</p>
<h2><a name="UpgradingtoAsterisk11-ResourceModules"></a>Resource Modules</h2>
<h3><a name="UpgradingtoAsterisk11-resais"></a>res_ais</h3>
<p>Users of res_ais in versions of Asterisk prior to Asterisk 11 must change to use the res_corosync module, instead. OpenAIS is deprecated, but Corosync is still actively developed and maintained. Corosync came out of the OpenAIS project.</p>
<h3><a name="UpgradingtoAsterisk11-resjabber"></a>res_jabber</h3>
<p>This module has been deprecated in favor of the res_xmpp module. The res_xmpp module is backwards compatible with the res_jabber configuration file, dialplan functions, and AMI actions. The old CLI commands can also be made available using the res_clialiases template for Asterisk 11.</p>
<h2><a name="UpgradingtoAsterisk11-DialplanFunctions"></a>Dialplan Functions</h2>
<ul>
<li><a href="/wiki/display/AST/Asterisk+11+Function_MAILBOX_EXISTS" title="Asterisk 11 Function_MAILBOX_EXISTS">MAILBOX_EXISTS</a> has been deprecated. Use <a href="/wiki/display/AST/Asterisk+11+Function_VM_INFO" title="Asterisk 11 Function_VM_INFO">VM_INFO</a> with the '<tt>exists</tt>' parameter instead.</li>
<li><a href="/wiki/display/AST/Asterisk+11+Application_Macro" title="Asterisk 11 Application_Macro">Macro</a> has been deprecated in favour of <a href="/wiki/display/AST/Asterisk+11+Application_Gosub" title="Asterisk 11 Application_Gosub">Gosub</a>. While Macro has been deprecated for some time, in Asterisk 11 all internal functions that relied on Macros have been transitioned to use GoSub. For redirecting and connected line purposes use the following variables instead of their macro equivalents:
<ul>
<li><tt>REDIRECTING_SEND_SUB</tt></li>
<li><tt>REDIRECTING_SEND_SUB_ARGS</tt></li>
<li><tt>CONNECTED_LINE_SEND_SUB</tt></li>
<li><tt>CONNECTED_LINE_SEND_SUB_ARGS</tt></li>
</ul>
</li>
<li>The <a href="/wiki/display/AST/Asterisk+11+Function_HANGUPCAUSE" title="Asterisk 11 Function_HANGUPCAUSE">HANGUPCAUSE</a> and <a href="/wiki/display/AST/Asterisk+11+Function_HANGUPCAUSE_KEYS" title="Asterisk 11 Function_HANGUPCAUSE_KEYS">HANGUPCAUSE_KEYS</a> functions have been introduced to provide a replacement for the SIP_CAUSE hash. The <a href="/wiki/display/AST/Asterisk+11+Application_HangupCauseClear" title="Asterisk 11 Application_HangupCauseClear">HangupCauseClear</a> application has also been introduced to remove this data from the channel when necessary. Please see</li>
<li><a href="/wiki/display/AST/E.164+NUmber+Mapping+%28ENUM%29" title="AST:E.164 NUmber Mapping (ENUM)">ENUM</a> query functions now return a count of -1 on lookup error to differentiate between a failed query and a successful query with 0 results matching the specified type.</li>
</ul>
<h2><a name="UpgradingtoAsterisk11-Core"></a>Core</h2>
<h3><a name="UpgradingtoAsterisk11-Logging"></a>Logging</h3>
<p>The <tt>verbose</tt> setting in <em>logger.conf</em> now takes an optional argument specifying the verbosity level for each logging destination. The default, if not otherwise specified, is a verbosity of 3.</p>
<h3><a name="UpgradingtoAsterisk11-AMI"></a>AMI</h3>
<ul>
<li><a href="/wiki/display/AST/Asterisk+11+Application_DBdeltree" title="Asterisk 11 Application_DBdeltree">DBdeltree</a> now correctly returns an error when 0 rows are deleted just as the <a href="/wiki/display/AST/Asterisk+11+Application_DBdel" title="Asterisk 11 Application_DBdel">DBdel</a> action does.</li>
<li>The IAX2 PeerStatus event now sends a <tt>Port</tt> header. In Asterisk 10, this was erroneously being sent as a <tt>Post</tt> header.</li>
</ul>
<h3><a name="UpgradingtoAsterisk11-CCSS"></a>CCSS</h3>
<p>Macro is deprecated. Use <tt>cc_callback_sub</tt> instead of <tt>cc_callback_macro</tt> in channel configurations.</p>
<h3><a name="UpgradingtoAsterisk11-Parking"></a>Parking</h3>
<ul>
<li>The <tt>comebacktoorigin</tt> setting must now be set per parking lot. The setting in the general section will not be applied automatically to each parking lot.</li>
<li>The <tt>BLINDTRANSFER</tt> channel variable is deleted from a channel when it is bridged to prevent subtle bugs in the parking feature. The channel variable is used by Asterisk internally for the <a href="/wiki/display/AST/Asterisk+11+Application_Park" title="Asterisk 11 Application_Park">Park</a> application to work properly. If you were using it for your own purposes, copy it to your own channel variable before the channel is bridged.</li>
</ul>
<h3><a name="UpgradingtoAsterisk11-users.conf"></a>users.conf</h3>
<p>A defined user with <tt>hasvoicemail=yes</tt> now finally uses a Gosub to <tt>stdexten</tt> as documented in <em>extensions.conf.sample</em> since v1.6.0 instead of a Macro as documented in v1.4. Set the asterisk.conf <tt>stdexten=macro</tt> parameter to invoke the <tt>stdexten</tt> the old way.</p>
</div>
<div id="commentsSection" class="wiki-content pageSection">
<div style="float: right;" class="grey">
<a href="https://wiki.asterisk.org/wiki/users/removespacenotification.action?spaceKey=AST">Stop watching space</a>
<span style="padding: 0px 5px;">|</span>
<a href="https://wiki.asterisk.org/wiki/users/editmyemailsettings.action">Change email notification preferences</a>
</div>
<a href="https://wiki.asterisk.org/wiki/display/AST/Upgrading+to+Asterisk+11">View Online</a>
|
<a href="https://wiki.asterisk.org/wiki/pages/diffpagesbyversion.action?pageId=20840460&revisedVersion=2&originalVersion=1">View Changes</a>
|
<a href="https://wiki.asterisk.org/wiki/display/AST/Upgrading+to+Asterisk+11?showComments=true&showCommentArea=true#addcomment">Add Comment</a>
</div>
</div>
</div>
</div>
</div>
</body>
</html>