1e76c4130e7ae479b5df80c254b5d4f4155f6ccd
[asterisk/asterisk.git] / UPGRADE.txt
1 Information for Upgrading From Previous Asterisk Releases
2 =========================================================
3
4 Manager:
5
6 * The CallerID fields across Manager events have now been made more
7   consistent. CallerID Number will be sent as CallerIDNum and CallerID
8   Name will be sent as CallerIDName wherever used.
9
10 AEL:
11
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;".
19
20 Core:
21
22 * The 'languageprefix' option in asterisk.conf is now deprecated, and
23   the default sound file layout for non-English sounds is the 'new
24   style' layout introduced in Asterisk 1.4 (and used by the automatic
25   sound file installer in the Makefile).
26
27 * The ast_expr2 stuff has been modified to handle floating-point numbers.
28   Numbers of the format D.D are now acceptable input for the expr parser, 
29   Where D is a string of base-10 digits. All math is now done in "long double",
30   if it is available on your compiler/architecture. This was half-way between
31   a bug-fix (because the MATH func returns fp by default), and an enhancement.
32   Also, for those counting on, or needing, integer operations, a series of
33   'functions' were also added to the expr language, to allow several styles
34   of rounding/truncation, along with a set of common floating point operations,
35   like sin, cos, tan, log, pow, etc. The ability to call external functions
36   like CDR(), etc. was also added, without having to use the ${...} notation.
37  
38 * The delimiter passed to applications has been changed to the comma (','), as
39   that is what people are used to using within extensions.conf.  If you are
40   using realtime extensions, you will need to translate your existing dialplan
41   to use this separator.  To use a literal comma, you need merely to escape it
42   with a backslash ('\').  Another possible side effect is that you may need to
43   remove the obscene level of backslashing that was necessary for the dialplan
44   to work correctly in 1.4 and previous versions.  This should make writing
45   dialplans less painful in the future, albeit with the pain of a one-time
46   conversion.
47
48 Voicemail:
49
50 * The voicemail configuration values 'maxmessage' and 'minmessage' have
51   been changed to 'maxsecs' and 'minsecs' to clarify their purpose and
52   to make them more distinguishable from 'maxmsgs', which sets folder
53   size.  The old variables will continue to work in this version, albeit
54   with a deprecation warning.
55 * If you use any interface for modifying voicemail aside from the built in
56   dialplan applications, then the option "pollmailboxes" *must* be set in
57   voicemail.conf for message waiting indication (MWI) to work properly.  This
58   is because Voicemail notification is now event based instead of polling
59   based.  The channel drivers are no longer responsible for constantly manually
60   checking mailboxes for changes so that they can send MWI information to users.
61   Examples of situations that would require this option are web interfaces to
62   voicemail or an email client in the case of using IMAP storage.
63
64 Applications:
65
66 * ChanIsAvail() now has a 't' option, which allows the specified device
67   to be queried for state without consulting the channel drivers. This
68   performs mostly a 'ChanExists' sort of function.
69 * SetCallerPres() has been replaced with the CALLERPRES() dialplan function
70   and is now deprecated.
71 * DISA()'s fifth argument is now an options argument.  If you have previously
72   used 'NOANSWER' in this argument, you'll need to convert that to the new
73   option 'n'.
74
75 CDR:
76
77 * The cdr_sqlite module has been marked as deprecated in favor of
78   cdr_sqlite3_custom.  It will potentially be removed from the tree
79   after Asterisk 1.6 is released.
80
81 Formats:
82
83 * format_wav: The GAIN preprocessor definition and source code that used it
84   is removed.  This change was made in response to user complaints of
85   choppiness or the clipping of loud signal peaks.  To increasing the volume
86   of voicemail messages, use the 'volgain' option in voicemail.conf
87
88 Channel Drivers:
89
90 * chan_sip.c: a small upgrade to support the "Record" button on the SNOM360,
91   which sends a sip INFO message with a "Record: on" or "Record: off" 
92   header. If asterisk is set up (via features.conf) to accept "One Touch Monitor"
93   requests (by default, via '*1'), then the user-configured dialpad sequence
94   is generated, and recording can be started and stopped via this button. The
95   file names and formats are all controlled via the normal mechanisms. If the
96   user has not configured the automon feature, the normal "415 Unsupported media type"
97   is returned, and nothing is done.
98