Make --with-pjproject-bundled the default for Asterisk 15
[asterisk/asterisk.git] / UPGRADE-15.txt
1 ===========================================================
2 ===
3 === Information for upgrading between Asterisk versions
4 ===
5 === These files document all the changes that MUST be taken
6 === into account when upgrading between the Asterisk
7 === versions listed below. These changes may require that
8 === you modify your configuration files, dialplan or (in
9 === some cases) source code if you have your own Asterisk
10 === modules or patches. These files also include advance
11 === notice of any functionality that has been marked as
12 === 'deprecated' and may be removed in a future release,
13 === along with the suggested replacement functionality.
14 ===
15 === UPGRADE-1.2.txt -- Upgrade info for 1.0 to 1.2
16 === UPGRADE-1.4.txt -- Upgrade info for 1.2 to 1.4
17 === UPGRADE-1.6.txt -- Upgrade info for 1.4 to 1.6
18 === UPGRADE-1.8.txt -- Upgrade info for 1.6 to 1.8
19 === UPGRADE-10.txt  -- Upgrade info for 1.8 to 10
20 === UPGRADE-11.txt  -- Upgrade info for 10 to 11
21 === UPGRADE-12.txt  -- Upgrade info for 11 to 12
22 === UPGRADE-13.txt  -- Upgrade info for 12 to 13
23 === UPGRADE-14.txt  -- Upgrade info for 13 to 14
24 === UPGRADE-15.txt  -- Upgrade info for 14 to 15
25 ===========================================================
26
27 New in 15.0.0:
28
29 Core:
30  - The 'Data Retrieval API' has been removed. This API was not actively
31    maintained, was not added to new modules (such as res_pjsip), and there
32    exist better alternatives to acquire the same information, such as the
33    ARI. As a result, the 'DataGet' AMI action as well as the 'data get'
34    CLI command have been removed.
35
36 Build System:
37  - '--with-pjproject-bundled' is now the default when running ./configure
38    It can be disabled with '--without-pjproject-bundled'.
39
40 From 14.6.0 to 14.7.0:
41
42 Core:
43  - ast_app_parse_timelen now returns an error if it encounters extra characters
44    at the end of the string to be parsed.
45
46 From 14.4.0 to 14.5.0:
47
48 Core:
49  - Support for embedded modules has been removed.  This has not worked in
50    many years.  LOADABLE_MODULES menuselect option is also removed as
51    loadable module support is now always enabled.
52
53 From 14.3.0 to 14.4.0:
54
55 res_rtp_asterisk:
56  - The RTP layer of Asterisk now has support for RFC 5761: "Multiplexing RTP
57    Data and Control Packets on a Single Port." For the PJSIP channel driver,
58    chan_pjsip, you can set "rtcp_mux = yes" on a PJSIP endpoint in pjsip.conf
59    to enable the feature. For chan_sip you can set "rtcp_mux = yes" either
60    globally or on a per-peer basis in sip.conf.
61
62 New in 14.0.0
63
64 ARI:
65  - The policy for when to send "Dial" events has changed. Previously, "Dial"
66    events were sent on the calling channel's topic. However, starting in Asterisk
67    14, if there is no calling channel on which to send the event, the event is
68    instead sent on the called channel's topic. Note that for the ARI channels
69    resource's dial operation, this means that the "Dial" events will always be
70    sent on the called channel's topic.
71
72 Queue:
73  - When reloading the members of a queue, the members added dynamically (i.e.
74    added via the CLI command "queue add" or the AMI action "QueueAdd") now have
75    their ringinuse value updated to the value of the queue. Previously, the
76    ringinuse value for dynamic members was not updated on reload.
77
78 Queue log:
79  - New RINGCANCELED event is logged when the caller hangs up while ringing.
80    The data1 field contains number of miliseconds since start of ringing.
81
82 Channel Drivers:
83
84 chan_dahdi:
85  - Support for specifying a DAHDI channel using a path under /dev/dahdi
86    ("by name") has been removed. It was never used. Instead you should
87    use kernel-level channel number allocation using span assignments.
88    See the documentation of dahdi-linux and dahdi-tools.
89