1 Information for Upgrading From Asterisk 1.0
2 ===========================================
6 * The Asterisk 1.2 source code now uses C language features
7 supported only by 'modern' C compilers. Generally, this means GCC
8 version 3.0 or higher, although some GCC 2.96 releases will also
9 work. Some non-GCC compilers that support C99 and the common GCC
10 extensions (including anonymous structures and unions) will also
11 work. All releases of GCC 2.95 do _not_ have the requisite feature
12 support; systems using that compiler will need to be upgraded to
13 a more recent compiler release.
17 * The dialplan expression parser (which handles $[ ... ] constructs)
18 has gone through a major upgrade, but has one incompatible change:
19 spaces are no longer required around expression operators, including
20 string comparisons. However, you can now use quoting to keep strings
21 together for comparison. For more details, please read the
22 doc/README.variables file, and check over your dialplan for possible
27 * The default for ackcall has been changed to "no" instead of "yes"
28 because of a bug which caused the "yes" behavior to generally act like
29 "no". You may need to adjust the value if your agents behave
30 differently than you expect with respect to acknowledgement.
34 * The Caller*ID of the outbound leg is now the extension that was
35 called, rather than the Caller*ID of the inbound leg of the call. The
36 "o" flag for Dial can be used to restore the original behavior if
37 desired. Note that if you are looking for the originating callerid
38 from the manager event, there is a new manager event "Dial" which
39 provides the source and destination channels and callerid.
43 * The naming convention for IAX channels has changed in a minor way such
44 that the call number follows a "-" rather than a "/" character.
48 * The global option "port" in 1.0.X that is used to set which port to
49 bind to has been changed to "bindport" to be more consistent with
50 the other channel drivers and to avoid confusion with the "port"
51 option for users/peers.
53 * The "Registry" event now uses "Username" rather than "User" for
58 * With the addition of dialplan functions (which operate similarly
59 to variables), the SetVar application has been renamed to Set.
61 * The CallerPres application has been removed. Use SetCallerPres
62 instead. It accepts both numeric and symbolic names.
64 * The applications GetGroupCount, GetGroupMatchCount, SetGroup, and
65 CheckGroup have been deprecated in favor of functions. Here is a
66 table of their replacements:
68 GetGroupCount([groupname][@category] GROUP_COUNT([groupname][@category]) Set(GROUPCOUNT=${GROUP_COUNT()})
69 GroupMatchCount(groupmatch[@category]) GROUP_MATCH_COUNT(groupmatch[@category]) Set(GROUPCOUNT=${GROUP_MATCH_COUNT(SIP/.*)})
70 SetGroup(groupname[@category]) GROUP([category])=groupname Set(GROUP()=test)
71 CheckGroup(max[@category]) N/A GotoIf($[ ${GROUP_COUNT()} > 5 ]?103)
73 Note that CheckGroup does not have a direct replacement. There is
74 also a new function called GROUP_LIST() which will return a space
75 separated list of all of the groups set on a channel. The GROUP()
76 function can also return the name of the group set on a channel when
77 used in a read environment.
79 * The applications DBGet and DBPut have been deprecated in favor of
80 functions. Here is a table of their replacements:
82 DBGet(foo=family/key) Set(foo=${DB(family/key)})
83 DBPut(family/key=${foo}) Set(DB(family/key)=${foo})
85 * The application SetLanguage has been deprecated in favor of the
88 SetLanguage(fr) Set(LANGUAGE()=fr)
90 The LANGUAGE function can also return the currently set language:
92 Set(MYLANG=${LANGUAGE()})
94 * The applications AbsoluteTimeout, DigitTimeout, and ResponseTimeout
95 have been deprecated in favor of the function TIMEOUT(timeouttype):
97 AbsoluteTimeout(300) Set(TIMEOUT(absolute)=300)
98 DigitTimeout(15) Set(TIMEOUT(digit)=15)
99 ResponseTimeout(15) Set(TIMEOUT(response)=15)
101 The TIMEOUT() function can also return the currently set timeouts:
103 Set(DTIMEOUT=${TIMEOUT(digit)})
105 * The applications SetCIDName, SetCIDNum, and SetRDNIS have been
106 deprecated in favor of the CALLERID(datatype) function:
108 SetCIDName(Joe Cool) Set(CALLERID(name)=Joe Cool)
109 SetCIDNum(2025551212) Set(CALLERID(number)=2025551212)
110 SetRDNIS(2024561414) Set(CALLERID(RDNIS)=2024561414)
112 * The application Record now uses the period to separate the filename
113 from the format, rather than the colon.
115 * The application VoiceMail now supports a 'temporary' greeting for each
116 mailbox. This greeting can be recorded by using option 4 in the
117 'mailbox options' menu, and 'change your password' option has been
122 * A queue is now considered empty not only if there are no members but if
123 none of the members are available (e.g. agents not logged on). To
124 restore the original behavior, use "leavewhenempty=strict" or
125 "joinwhenempty=strict" instead of "=yes" for those options.
127 * It is now possible to use multi-digit extensions in the exit context
128 for a queue (although you should not have overlapping extensions,
129 as there is no digit timeout). This means that the EXITWITHKEY event
130 in queue_log can now contain a key field with more than a single
135 * By default, there is a new option called "autofallthrough" in
136 extensions.conf that is set to yes. Asterisk 1.0 (and earlier)
137 behavior was to wait for an extension to be dialed after there were no
138 more extensions to execute. "autofallthrough" changes this behavior
139 so that the call will immediately be terminated with BUSY,
140 CONGESTION, or HANGUP based on Asterisk's best guess. If you are
141 writing an extension for IVR, you must use the WaitExten application
142 if "autofallthrough" is set to yes.
146 * AGI scripts did not always get SIGHUP at the end, previously. That
147 behavior has been fixed. If you do not want your script to terminate
148 at the end of AGI being called (e.g. on a hangup) then set SIGHUP to
149 be ignored within your application.
153 * The preferred format for musiconhold.conf has changed; please see the
154 sample configuration file for the new format. The existing format
155 is still supported but will generate warnings when the module is loaded.
159 * All the chan_modem channel drivers (aopen, bestdata and i4l) are deprecated
160 in this release, and will be removed in the next major Asterisk release.
161 Please migrate to chan_misdn for ISDN interfaces; there is no upgrade
162 path for aopen and bestdata modem users.