res_ari_events: Fix use after free / double-free of JSON message.
[asterisk/asterisk.git] / UPGRADE-14.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 ===========================================================
24
25 From 14.6.0 to 14.7.0:
26
27 Core:
28  - ast_app_parse_timelen now returns an error if it encounters extra characters
29    at the end of the string to be parsed.
30
31 From 14.4.0 to 14.5.0:
32
33 Core:
34  - Support for embedded modules has been removed.  This has not worked in
35    many years.  LOADABLE_MODULES menuselect option is also removed as
36    loadable module support is now always enabled.
37
38 From 14.3.0 to 14.4.0:
39
40 res_rtp_asterisk:
41  - The RTP layer of Asterisk now has support for RFC 5761: "Multiplexing RTP
42    Data and Control Packets on a Single Port." For the PJSIP channel driver,
43    chan_pjsip, you can set "rtcp_mux = yes" on a PJSIP endpoint in pjsip.conf
44    to enable the feature. For chan_sip you can set "rtcp_mux = yes" either
45    globally or on a per-peer basis in sip.conf.
46
47 New in 14.0.0
48
49 ARI:
50  - The policy for when to send "Dial" events has changed. Previously, "Dial"
51    events were sent on the calling channel's topic. However, starting in Asterisk
52    14, if there is no calling channel on which to send the event, the event is
53    instead sent on the called channel's topic. Note that for the ARI channels
54    resource's dial operation, this means that the "Dial" events will always be
55    sent on the called channel's topic.
56
57 Channel Drivers:
58
59 chan_dahdi:
60  - For users using the FXO port (FXS signaling) distinctive ring detection
61    feature, you will need to adjust the dringX count values.  The count
62    values now only record ring end events instead of any DAHDI event.  A
63    ring-ring-ring pattern would exceed the pattern limits and stop
64    Caller-ID detection.
65
66 chan_sip:
67  - The SIP dial string has been extended past the [!dnid] option by another
68    exclamation mark: [!dnid[!fromuri].  An exclamation mark in the To-URI
69    will now mean changes to the From-URI.
70
71 Core:
72  - The REF_DEBUG compiler flag is now used to enable refdebug by default.
73    The setting can be overridden in asterisk.conf by setting refdebug in
74    the options category.  No recompile is required to enable/disable it.
75
76  - Modified processing of command-line options to first parse only what
77    is necessary to read asterisk.conf. Once asterisk.conf is fully loaded,
78    the remaining options are processed.  The -X option now applies to
79    asterisk.conf only.  To enable #exec for other config files you must
80    set execincludes=yes in asterisk.conf.  Any other option set on the
81    command-line will now override the equivalent setting from asterisk.conf.
82
83 AMI:
84  - The 'ModuleCheck' Action's Version key will no longer show the module
85    version. The value will always be blank.
86
87 CLI:
88  - The 'core show file version' command has been removed. When Asterisk
89    moved to Git, the source control version support was removed. As a
90    result, the CLi command was no longer useful and was removed as well.
91
92 Logging:
93  - The first callid created is now 1 instead of 0.  The value 0
94    is now reserved to represent a lack of callid.
95
96 AMI:
97  - The Command action now sends the output from the CLI command as a series
98    of Output headers for each line instead of as a block of text with the
99    --END COMMAND-- delimiter to match the output from other actions.
100
101    Commands that fail to execute (no such command, invalid syntax etc.) now
102    return an Error response instead of Success.
103
104 app_amd:
105  - The 'maximum_number_of_words' configuration option and parameter to the AMD
106    application previously did not match the documented functionality + variable
107    name.  In Asterisk 13, a value of '3' would mean that if '3' words were detected,
108    the result would be detection as a 'MACHINE'.  As of this version, the value
109    reflects the maximum words that if EXCEEDED (rather than reached), would
110    result in detection as a machine.  This means that you should update this
111    value to be one higher than your previos value, if your previous value
112    was working well for you.
113
114 ===========================================================
115 ===========================================================