e74835960982f4538c8054bbf053dadcd8ff5962
[asterisk/asterisk.git] / UPGRADE.txt
1 Information for Upgrading From Previous Asterisk Releases
2 =========================================================
3
4 Applications:
5
6 * In previous Asterisk releases, many applications would jump to priority n+101
7   to indicate some kind of status or error condition.  This functionality was
8   marked deprecated in Asterisk 1.2.  An option to disable it was provided with
9   the default value set to 'on'.  The default value for the global priority
10   jumping option is now 'off'.
11
12 * The applications Cut, Sort, DBGet, DBPut, SetCIDNum, SetCIDName, SetRDNIS,
13   AbsoluteTimeout, DigitTimeout, ResponseTimeout, SetLanguage, GetGroupCount,
14   and GetGroupMatchCount were all deprecated in version 1.2, and therefore have
15   been removed in this version.  You should use the equivalent dialplan
16   function in places where you have previously used one of these applications.
17
18 * The application SetVar has been renamed to Set.  The syntax SetVar was marked
19   deprecated in version 1.2 and is no longer recognized in this version.
20
21 * app_read has been updated to use the newer options codes, using "skip" or
22   "noanswer" will not work.  Use s or n.  Also there is a new feature i, for
23   using indication tones, so typing in skip would give you unexpected results.
24
25 Variables:
26
27 * The builtin variables ${CALLERID}, ${CALLERIDNAME}, ${CALLERIDNUM},
28   ${CALLERANI}, ${DNID}, ${RDNIS}, ${DATETIME}, ${TIMESTAMP}, ${ACCOUNTCODE},
29   and ${LANGUAGE} have all been deprecated in favor of their related dialplan
30   functions.  You are encouraged to move towards the associated dialplan
31   function, as these variables will be removed in a future release.
32
33 Functions:
34
35 * The function ${CHECK_MD5()} has been deprecated in favor of using an
36   expression: $[${MD5(<string>)} = ${saved_md5}].
37
38 * The 'builtin' functions that used to be combined in pbx_functions.so are
39   now built as separate modules. If you are not using 'autoload=yes' in your
40   modules.conf file then you will need to explicitly load the modules that
41   contain the functions you want to use.
42
43 * The ENUMLOOP() function no longer supplies a default zone for searching; instead,
44   it uses the default zone(s) defined in enum.conf. In addition, when the 'c'
45   option (for counting the number of records is specified), but the lookup fails
46   to match any records, the returned value will now be "0" instead of blank.
47
48 The SIP channel:
49
50 * The "incominglimit" setting is replaced by the "call-limit" setting in sip.conf.
51
52 Installation:
53
54 * On BSD systems, the installation directories have changed to more "FreeBSDish" directories. On startup, Asterisk will look for the main configuration in /usr7local/etc/asterisk/asterisk.conf
55 If you have an old installation, you might want to remove the binaries and move the configuration files to the new locations. The following directories are now default:
56         ASTLIBDIR       /usr/local/lib/asterisk
57         ASTVARLIBDIR    /usr/local/share/asterisk
58         ASTETCDIR       /usr/local/etc/asterisk
59         ASTBINDIR       /usr/local/bin/asterisk
60         ASTSBINDIR      /usr/local/sbin/asterisk