2275580cabd988c86f54413f790c1c873f1b91d1
[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 From 14.3.0 to 14.4.0:
27
28 res_rtp_asterisk:
29  - The RTP layer of Asterisk now has support for RFC 5761: "Multiplexing RTP
30    Data and Control Packets on a Single Port." So far, the only channel driver
31    that supports this feature is chan_pjsip. You can set "rtcp_mux = yes" on
32    a PJSIP endpoint in pjsip.conf to enable the feature.
33
34 New in 14.0.0
35
36 ARI:
37  - The policy for when to send "Dial" events has changed. Previously, "Dial"
38    events were sent on the calling channel's topic. However, starting in Asterisk
39    14, if there is no calling channel on which to send the event, the event is
40    instead sent on the called channel's topic. Note that for the ARI channels
41    resource's dial operation, this means that the "Dial" events will always be
42    sent on the called channel's topic.
43
44 Queue:
45  - When reloading the members of a queue, the members added dynamically (i.e.
46    added via the CLI command "queue add" or the AMI action "QueueAdd") now have
47    their ringinuse value updated to the value of the queue. Previously, the
48    ringinuse value for dynamic members was not updated on reload.
49
50 Queue log:
51  - New RINGCANCELED event is logged when the caller hangs up while ringing.
52    The data1 field contains number of miliseconds since start of ringing.
53
54 Channel Drivers:
55
56 chan_dahdi:
57  - Support for specifying a DAHDI channel using a path under /dev/dahdi
58    ("by name") has been removed. It was never used. Instead you should
59    use kernel-level channel number allocation using span assignments.
60    See the documentation of dahdi-linux and dahdi-tools.
61