Merge "res_rtp_asterisk: Add ice_blacklist option"
[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 ARI:
26  - The policy for when to send "Dial" events has changed. Previously, "Dial"
27    events were sent on the calling channel's topic. However, starting in Asterisk
28    14, if there is no calling channel on which to send the event, the event is
29    instead sent on the called channel's topic. Note that for the ARI channels
30    resource's dial operation, this means that the "Dial" events will always be
31    sent on the called channel's topic.
32
33 Channel Drivers:
34
35 chan_dahdi:
36  - For users using the FXO port (FXS signaling) distinctive ring detection
37    feature, you will need to adjust the dringX count values.  The count
38    values now only record ring end events instead of any DAHDI event.  A
39    ring-ring-ring pattern would exceed the pattern limits and stop
40    Caller-ID detection.
41
42 chan_sip:
43  - The SIP dial string has been extended past the [!dnid] option by another
44    exclamation mark: [!dnid[!fromuri].  An exclamation mark in the To-URI
45    will now mean changes to the From-URI.
46
47 Core:
48  - The REF_DEBUG compiler flag is now used to enable refdebug by default.
49    The setting can be overridden in asterisk.conf by setting refdebug in
50    the options category.  No recompile is required to enable/disable it.
51
52  - Modified processing of command-line options to first parse only what
53    is necessary to read asterisk.conf. Once asterisk.conf is fully loaded,
54    the remaining options are processed.  The -X option now applies to
55    asterisk.conf only.  To enable #exec for other config files you must
56    set execincludes=yes in asterisk.conf.  Any other option set on the
57    command-line will now override the equivalent setting from asterisk.conf.
58
59 AMI:
60  - The 'ModuleCheck' Action's Version key will no longer show the module
61    version. The value will always be blank.
62
63 CLI:
64  - The 'core show file version' command has been removed. When Asterisk
65    moved to Git, the source control version support was removed. As a
66    result, the CLi command was no longer useful and was removed as well.
67
68 Logging:
69  - The first callid created is now 1 instead of 0.  The value 0
70    is now reserved to represent a lack of callid.
71
72 AMI:
73  - The Command action now sends the output from the CLI command as a series
74    of Output headers for each line instead of as a block of text with the
75    --END COMMAND-- delimiter to match the output from other actions.
76
77    Commands that fail to execute (no such command, invalid syntax etc.) now
78    return an Error response instead of Success.
79
80 app_amd:
81  - The 'maximum_number_of_words' configuration option and parameter to the AMD
82    application previously did not match the documented functionality + variable
83    name.  In Asterisk 13, a value of '3' would mean that if '3' words were detected,
84    the result would be detection as a 'MACHINE'.  As of this version, the value
85    reflects the maximum words that if EXCEEDED (rather than reached), would
86    result in detection as a machine.  This means that you should update this
87    value to be one higher than your previos value, if your previous value
88    was working well for you.
89
90 ===========================================================
91 ===========================================================