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 Voicemail:
  28
  29 * The voicemail configuration values 'maxmessage' and 'minmessage' have
  30   been changed to 'maxsecs' and 'minsecs' to clarify their purpose and
  31   to make them more distinguishable from 'maxmsgs', which sets folder
  32   size.  The old variables will continue to work in this version, albeit
  33   with a deprecation warning.
  34 * If you use any interface for modifying voicemail aside from the built in
  35   dialplan applications, then the option "pollmailboxes" *must* be set in
  36   voicemail.conf for message waiting indication (MWI) to work properly.  This
  37   is because Voicemail notification is now event based instead of polling
  38   based.  The channel drivers are no longer responsible for constantly manually
  39   checking mailboxes for changes so that they can send MWI information to users.
  40   Examples of situations that would require this option are web interfaces to
  41   voicemail or an email client in the case of using IMAP storage.
  42
  43 Applications:
  44
  45 * ChanIsAvail() now has a 't' option, which allows the specified device
  46   to be queried for state without consulting the channel drivers. This
  47   performs mostly a 'ChanExists' sort of function.
  48 * SetCallerPres() has been replaced with the CALLERPRES() dialplan function
  49   and is now deprecated.
  50 * DISA()'s fifth argument is now an options argument.  If you have previously
  51   used 'NOANSWER' in this argument, you'll need to convert that to the new
  52   option 'n'.
  53
  54 CDR:
  55
  56 * The cdr_sqlite module has been marked as deprecated in favor of
  57   cdr_sqlite3_custom.  It will potentially be removed from the tree
  58   after Asterisk 1.6 is released.
  59
  60 * The cdr_manager module has a [mappings] feature, like cdr_custom,
  61   to add fields to the manager event from the CDR variables.
  62
  63 Formats:
  64
  65 * format_wav: The GAIN preprocessor definition and source code that used it
  66   is removed.  This change was made in response to user complaints of
  67   choppiness or the clipping of loud signal peaks.  To increasing the volume
  68   of voicemail messages, use the 'volgain' option in voicemail.conf
  69
  70 Channel Drivers:
  71
  72 * chan_sip.c: a small upgrade to support the "Record" button on the SNOM360,
  73   which sends a sip INFO message with a "Record: on" or "Record: off"
  74   header. If asterisk is set up (via features.conf) to accept "One Touch Monitor"
  75   requests (by default, via '*1'), then the user-configured dialpad sequence
  76   is generated, and recording can be started and stopped via this button. The
  77   file names and formats are all controlled via the normal mechanisms. If the
  78   user has not configured the automon feature, the normal "415 Unsupported media type"
  79   is returned, and nothing is done.
  80
  81 * chan_zap.c: In India, some carriers transmit CID via dtmf. Some code has been added
  82   that will handle some situations. The cidstart=polarity_IN choice has been added for
  83   those carriers that transmit CID via dtmf after a polarity change.
  84