1 =========================================================
2 === Information for upgrading from Asterisk 1.4 to 1.6
5 === UPGRADE-1.2.txt -- Upgrade info for 1.0 to 1.2
6 === UPGRADE-1.4.txt -- Upgrade info for 1.2 to 1.4
7 === UPGRADE.txt -- Upgrade info for 1.4 to 1.6
8 =========================================================
12 * Macros are now implemented underneath with the Gosub() application.
13 Heaven Help You if you wrote code depending on any aspect of this!
14 Previous to 1.6, macros were implemented with the Macro() app, which
15 provided a nice feature of auto-returning. The compiler will do its
16 best to insert a Return() app call at the end of your macro if you did
17 not include it, but really, you should make sure that all execution
18 paths within your macros end in "return;".
20 * The conf2ael program is 'introduced' in this release; it is in a rather
21 crude state, but deemed useful for making a first pass at converting
22 extensions.conf code into AEL. More intelligence will come with time.
26 * The 'languageprefix' option in asterisk.conf is now deprecated, and
27 the default sound file layout for non-English sounds is the 'new
28 style' layout introduced in Asterisk 1.4 (and used by the automatic
29 sound file installer in the Makefile).
31 * The ast_expr2 stuff has been modified to handle floating-point numbers.
32 Numbers of the format D.D are now acceptable input for the expr parser,
33 Where D is a string of base-10 digits. All math is now done in "long double",
34 if it is available on your compiler/architecture. This was half-way between
35 a bug-fix (because the MATH func returns fp by default), and an enhancement.
36 Also, for those counting on, or needing, integer operations, a series of
37 'functions' were also added to the expr language, to allow several styles
38 of rounding/truncation, along with a set of common floating point operations,
39 like sin, cos, tan, log, pow, etc. The ability to call external functions
40 like CDR(), etc. was also added, without having to use the ${...} notation.
42 * The delimiter passed to applications has been changed to the comma (','), as
43 that is what people are used to using within extensions.conf. If you are
44 using realtime extensions, you will need to translate your existing dialplan
45 to use this separator. To use a literal comma, you need merely to escape it
46 with a backslash ('\'). Another possible side effect is that you may need to
47 remove the obscene level of backslashing that was necessary for the dialplan
48 to work correctly in 1.4 and previous versions. This should make writing
49 dialplans less painful in the future, albeit with the pain of a one-time
52 * The logger.conf option 'rotatetimestamp' has been deprecated in favor of
53 'rotatestrategy'. This new option supports a 'rotate' strategy that more
54 closely mimics the system logger in terms of file rotation.
56 * The concise versions of various CLI commands are now deprecated. We recommend
57 using the manager interface (AMI) for application integration with Asterisk.
59 * The silencethreshold used for various applications is now settable via a
60 centralized config option in dsp.conf.
64 * The voicemail configuration values 'maxmessage' and 'minmessage' have
65 been changed to 'maxsecs' and 'minsecs' to clarify their purpose and
66 to make them more distinguishable from 'maxmsgs', which sets folder
67 size. The old variables will continue to work in this version, albeit
68 with a deprecation warning.
69 * If you use any interface for modifying voicemail aside from the built in
70 dialplan applications, then the option "pollmailboxes" *must* be set in
71 voicemail.conf for message waiting indication (MWI) to work properly. This
72 is because Voicemail notification is now event based instead of polling
73 based. The channel drivers are no longer responsible for constantly manually
74 checking mailboxes for changes so that they can send MWI information to users.
75 Examples of situations that would require this option are web interfaces to
76 voicemail or an email client in the case of using IMAP storage.
80 * ChanIsAvail() now has a 't' option, which allows the specified device
81 to be queried for state without consulting the channel drivers. This
82 performs mostly a 'ChanExists' sort of function.
83 * ChannelRedirect() will not terminate the channel that fails to do a
84 channelredirect as it has done previously. Instead CHANNELREDIRECT_STATUS
85 will reflect if the attempt was successful of not.
86 * SetCallerPres() has been replaced with the CALLERPRES() dialplan function
87 and is now deprecated.
88 * DISA()'s fifth argument is now an options argument. If you have previously
89 used 'NOANSWER' in this argument, you'll need to convert that to the new
91 * Macro() is now deprecated. If you need subroutines, you should use the
92 Gosub()/Return() applications. To replace MacroExclusive(), we have
93 introduced dialplan functions LOCK(), TRYLOCK(), and UNLOCK(). You may use
94 these functions in any location where you desire to ensure that only one
95 channel is executing that path at any one time. The Macro() applications
96 are deprecated for performance reasons. However, since Macro() has been
97 around for a long time and so many dialplans depend heavily on it, for the
98 sake of backwards compatibility it will not be removed . It is also worth
99 noting that using both Macro() and GoSub() at the same time is _heavily_
101 * Read() now sets a READSTATUS variable on exit. It does NOT automatically
102 return -1 (and hangup) anymore on error. If you want to hangup on error,
103 you need to do so explicitly in your dialplan.
104 * Privacy() no longer uses privacy.conf, so any options must be specified
105 directly in the application arguments.
106 * MusicOnHold application now has duration parameter which allows specifying
108 * WaitMusicOnHold application is now deprecated in favor of extended MusicOnHold.
109 * SetMusicOnHold is now deprecated. You should use Set(CHANNEL(musicclass)=...)
111 * While app_directory has always relied on having a voicemail.conf or users.conf file
112 correctly set up, it now is dependent on app_voicemail being compiled as well.
113 * The arguments in ExecIf changed a bit, to be more like other applications.
114 The syntax is now ExecIf(<cond>?appiftrue(args):appiffalse(args)).
118 * QUEUE_MEMBER_COUNT() has been deprecated in favor of the QUEUE_MEMBER() function. For
119 more information, issue a "show function QUEUE_MEMBER" from the CLI.
123 * The cdr_sqlite module has been marked as deprecated in favor of
124 cdr_sqlite3_custom. It will potentially be removed from the tree
125 after Asterisk 1.6 is released.
127 * The cdr_odbc module now uses res_odbc to manage its connections. The
128 username and password parameters in cdr_odbc.conf, therefore, are no
129 longer used. The dsn parameter now points to an entry in res_odbc.conf.
133 * format_wav: The GAIN preprocessor definition and source code that used it
134 is removed. This change was made in response to user complaints of
135 choppiness or the clipping of loud signal peaks. To increase the volume
136 of voicemail messages, use the 'volgain' option in voicemail.conf
140 * SIP: a small upgrade to support the "Record" button on the SNOM360,
141 which sends a sip INFO message with a "Record: on" or "Record: off"
142 header. If Asterisk is set up (via features.conf) to accept "One Touch Monitor"
143 requests (by default, via '*1'), then the user-configured dialpad sequence
144 is generated, and recording can be started and stopped via this button. The
145 file names and formats are all controlled via the normal mechanisms. If the
146 user has not configured the automon feature, the normal "415 Unsupported media type"
147 is returned, and nothing is done.
148 * SIP: The "call-limit" option is marked as deprecated. It still works in this version of
149 Asterisk, but will be removed in the following version. Please use the groupcount functions
150 in the dialplan to enforce call limits. The "limitonpeer" configuration option is
151 now renamed to "counteronpeer".
152 * SIP: The "username" option is now renamed to "defaultuser" to match "defaultip".
153 These are used only before registration to call a peer with the uri
154 sip:defaultuser@defaultip
155 The "username" setting still work, but is deprecated and will not work in
156 the next version of Asterisk.
158 * chan_local.c: the comma delimiter inside the channel name has been changed to a
159 semicolon, in order to make the Local channel driver compatible with the comma
160 delimiter change in applications.
161 * H323: The "tos" setting has changed name to "tos_audio" and "cos" to "cos_audio"
162 to be compatible with settings in sip.conf. The "tos" and "cos" configuration
163 is deprecated and will stop working in the next release of Asterisk.
165 * Console: A new console channel driver, chan_console, has been added to Asterisk.
166 This new module can not be loaded at the same time as chan_alsa or chan_oss. The
167 default modules.conf only loads one of them (chan_oss by default). So, unless you
168 have modified your modules.conf to not use the autoload option, then you will need
169 to modify modules.conf to add another "noload" line to ensure that only one of
170 these three modules gets loaded.
172 * Zap: The "msdstrip" option has been deprecated, as it provides no value over
173 the method of stripping digits in the dialplan using variable substring syntax.
177 * pbx_dundi.c: tos parameter changed to use new values. Old values like lowdelay,
178 lowcost and other is not acceptable now. Look into qos.tex for description of
181 * queues.conf: the queue-lessthan sound file option is no longer available, and the
182 queue-round-seconds option no longer takes '1' as a valid parameter.
186 * Manager has been upgraded to version 1.1 with a lot of changes.
187 Please check doc/manager_1_1.txt for information
189 * The IAXpeers command output has been changed to more closely resemble the
190 output of the SIPpeers command.
192 * cdr_manager now reports at the "cdr" level, not at "call" You may need to
193 change your manager.conf to add the level to existing AMI users, if they
194 want to see the CDR events generated.
196 * The Originate command now requires the Originate write permission. For
197 Originate with the Application parameter, you need the additional System
198 privilege if you want to do anything that calls out to a subshell.
202 * Previously, the Asterisk source code distribution included the iLBC
203 encoder/decoder source code, from Global IP Solutions
204 (http://www.gipscorp.com). This code is not licensed for
205 distribution, and thus has been removed from the Asterisk source
206 code distribution. If you wish to use codec_ilbc to support iLBC
207 channels in Asterisk, you can run the contrib/scripts/get_ilbc_source.sh
208 script to download the source and put it in the proper place in
209 the Asterisk build tree. Once that is done you can follow your normal
210 steps of building Asterisk. You will need to run 'menuselect' and enable
211 the iLBC codec in the 'Codec Translators' category.