UPGRADE.txt

   1 =========================================================
   2 === Information for upgrading from Asterisk 1.4 to 1.6
   3 ===
   4 ===
   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 =========================================================
   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 * 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.
  23
  24 Core:
  25
  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).
  30
  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.
  41
  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
  50   conversion.
  51
  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.
  55
  56 * The concise versions of various CLI commands are now deprecated. We recommend
  57   using the manager interface (AMI) for application integration with Asterisk.
  58
  59 Voicemail:
  60
  61 * The voicemail configuration values 'maxmessage' and 'minmessage' have
  62   been changed to 'maxsecs' and 'minsecs' to clarify their purpose and
  63   to make them more distinguishable from 'maxmsgs', which sets folder
  64   size.  The old variables will continue to work in this version, albeit
  65   with a deprecation warning.
  66 * If you use any interface for modifying voicemail aside from the built in
  67   dialplan applications, then the option "pollmailboxes" *must* be set in
  68   voicemail.conf for message waiting indication (MWI) to work properly.  This
  69   is because Voicemail notification is now event based instead of polling
  70   based.  The channel drivers are no longer responsible for constantly manually
  71   checking mailboxes for changes so that they can send MWI information to users.
  72   Examples of situations that would require this option are web interfaces to
  73   voicemail or an email client in the case of using IMAP storage.
  74
  75 Applications:
  76
  77 * ChanIsAvail() now has a 't' option, which allows the specified device
  78   to be queried for state without consulting the channel drivers. This
  79   performs mostly a 'ChanExists' sort of function.
  80 * SetCallerPres() has been replaced with the CALLERPRES() dialplan function
  81   and is now deprecated.
  82 * DISA()'s fifth argument is now an options argument.  If you have previously
  83   used 'NOANSWER' in this argument, you'll need to convert that to the new
  84   option 'n'.
  85 * Macro() is now deprecated.  If you need subroutines, you should use the
  86   Gosub()/Return() applications.  To replace MacroExclusive(), we have
  87   introduced dialplan functions LOCK(), TRYLOCK(), and UNLOCK().  You may use
  88   these functions in any location where you desire to ensure that only one
  89   channel is executing that path at any one time.
  90 * Read() now sets a READSTATUS variable on exit.  It does NOT automatically
  91   return -1 (and hangup) anymore on error.  If you want to hangup on error,
  92   you need to do so explicitly in your dialplan.
  93 * Privacy() no longer uses privacy.conf, so any options must be specified
  94   directly in the application arguments.
  95 * MusicOnHold application now has duration parameter which allows specifying
  96   timeout in seconds.
  97 * WaitMusicOnHold application is now deprecated in favor of extended MusicOnHold.
  98 * SetMusicOnHold is now deprecated. You should use Set(CHANNEL(musicclass)=...)
  99   instead.
 100
 101 Dialplan Functions:
 102
 103 * QUEUE_MEMBER_COUNT() has been deprecated in favor of the QUEUE_MEMBER() function. For
 104   more information, issue a "show function QUEUE_MEMBER" from the CLI.
 105
 106 CDR:
 107
 108 * The cdr_sqlite module has been marked as deprecated in favor of
 109   cdr_sqlite3_custom.  It will potentially be removed from the tree
 110   after Asterisk 1.6 is released.
 111
 112 * The cdr_odbc module now uses res_odbc to manage its connections.  The
 113   username and password parameters in cdr_odbc.conf, therefore, are no
 114   longer used.  The dsn parameter now points to an entry in res_odbc.conf.
 115
 116 Formats:
 117
 118 * format_wav: The GAIN preprocessor definition and source code that used it
 119   is removed.  This change was made in response to user complaints of
 120   choppiness or the clipping of loud signal peaks.  To increase the volume
 121   of voicemail messages, use the 'volgain' option in voicemail.conf
 122
 123 Channel Drivers:
 124
 125 * SIP: a small upgrade to support the "Record" button on the SNOM360,
 126   which sends a sip INFO message with a "Record: on" or "Record: off"
 127   header. If Asterisk is set up (via features.conf) to accept "One Touch Monitor"
 128   requests (by default, via '*1'), then the user-configured dialpad sequence
 129   is generated, and recording can be started and stopped via this button. The
 130   file names and formats are all controlled via the normal mechanisms. If the
 131   user has not configured the automon feature, the normal "415 Unsupported media type"
 132   is returned, and nothing is done.
 133 * SIP: The "call-limit" option is marked as deprecated. It still works in this version of
 134   Asterisk, but will be removed in the following version. Please use the groupcount functions
 135   in the dialplan to enforce call limits. The "limitonpeer" configuration option is
 136   now renamed to "counteronpeer".
 137 * SIP: The "username" option is now renamed to "defaultuser" to match "defaultip".
 138   These are used only before registration to call a peer with the uri
 139         sip:defaultuser@defaultip
 140   The "username" setting still work, but is deprecated and will not work in
 141   the next version of Asterisk.
 142
 143 * chan_local.c: the comma delimiter inside the channel name has been changed to a
 144   semicolon, in order to make the Local channel driver compatible with the comma
 145   delimiter change in applications.
 146 * H323: The "tos" setting has changed name to "tos_audio" and "cos" to "cos_audio"
 147   to be compatible with settings in sip.conf. The "tos" and "cos" configuration
 148   is deprecated and will stop working in the next release of Asterisk.
 149
 150 * Console: A new console channel driver, chan_console, has been added to Asterisk.
 151   This new module can not be loaded at the same time as chan_alsa or chan_oss.  The
 152   default modules.conf only loads one of them (chan_oss by default).  So, unless you
 153   have modified your modules.conf to not use the autoload option, then you will need
 154   to modify modules.conf to add another "noload" line to ensure that only one of
 155   these three modules gets loaded.
 156
 157 Configuration:
 158
 159 * pbx_dundi.c: tos parameter changed to use new values. Old values like lowdelay,
 160   lowcost and other is not acceptable now. Look into qos.tex for description of
 161   this parameter.
 162
 163 * queues.conf: the queue-lessthan sound file option is no longer available, and the
 164   queue-round-seconds option no longer takes '1' as a valid parameter.
 165
 166 Manager:
 167
 168 * Manager has been upgraded to version 1.1 with a lot of changes.
 169   Please check doc/manager_1_1.txt for information
 170
 171 * The IAXpeers command output has been changed to more closely resemble the
 172   output of the SIPpeers command.
 173
 174 * cdr_manager now reports at the "cdr" level, not at "call"  You may need to
 175    change your manager.conf to add the level to existing AMI users, if they
 176    want to see the CDR events generated.
 177