json.c: Add backtrace log to find 'Invalid UTF-8 string' errors
[asterisk/asterisk.git] / UPGRADE.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 ===========================================================
25
26 New in 15.0.0:
27
28 Core:
29  - The 'Data Retrieval API' has been removed. This API was not actively
30    maintained, was not added to new modules (such as res_pjsip), and there
31    exist better alternatives to acquire the same information, such as the
32    ARI. As a result, the 'DataGet' AMI action as well as the 'data get'
33    CLI command have been removed.
34
35 From 14.4.0 to 14.5.0:
36
37 Core:
38  - Support for embedded modules has been removed.  This has not worked in
39    many years.  LOADABLE_MODULES menuselect option is also removed as
40    loadable module support is now always enabled.
41
42 From 14.3.0 to 14.4.0:
43
44 res_rtp_asterisk:
45  - The RTP layer of Asterisk now has support for RFC 5761: "Multiplexing RTP
46    Data and Control Packets on a Single Port." For the PJSIP channel driver,
47    chan_pjsip, you can set "rtcp_mux = yes" on a PJSIP endpoint in pjsip.conf
48    to enable the feature. For chan_sip you can set "rtcp_mux = yes" either
49    globally or on a per-peer basis in sip.conf.
50
51 New in 14.0.0
52
53 ARI:
54  - The policy for when to send "Dial" events has changed. Previously, "Dial"
55    events were sent on the calling channel's topic. However, starting in Asterisk
56    14, if there is no calling channel on which to send the event, the event is
57    instead sent on the called channel's topic. Note that for the ARI channels
58    resource's dial operation, this means that the "Dial" events will always be
59    sent on the called channel's topic.
60
61 Queue:
62  - When reloading the members of a queue, the members added dynamically (i.e.
63    added via the CLI command "queue add" or the AMI action "QueueAdd") now have
64    their ringinuse value updated to the value of the queue. Previously, the
65    ringinuse value for dynamic members was not updated on reload.
66
67 Queue log:
68  - New RINGCANCELED event is logged when the caller hangs up while ringing.
69    The data1 field contains number of miliseconds since start of ringing.
70
71 Channel Drivers:
72
73 chan_dahdi:
74  - Support for specifying a DAHDI channel using a path under /dev/dahdi
75    ("by name") has been removed. It was never used. Instead you should
76    use kernel-level channel number allocation using span assignments.
77    See the documentation of dahdi-linux and dahdi-tools.
78