Document installation changes for BSD users.
[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 SIP channel:
39
40 * The "incominglimit" setting is replaced by the "call-limit" setting in sip.conf.
41
42 Installation:
43
44 * 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
45 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:
46         ASTLIBDIR       /usr/local/lib/asterisk
47         ASTVARLIBDIR    /usr/local/share/asterisk
48         ASTETCDIR       /usr/local/etc/asterisk
49         ASTBINDIR       /usr/local/bin/asterisk
50         ASTSBINDIR      /usr/local/sbin/asterisk