Merge "chan_ooh323: fix h323 log file path"
[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 === UPGRADE-15.txt  -- Upgrade info for 14 to 15
25 === UPGRADE-16.txt  -- Upgrade info for 15 to 16
26 ===========================================================
27
28 New in 17.0.0:
29
30 chan_sip:
31  - The chan_sip module is now deprecated, users should migrate to the
32    replacement module chan_pjsip.  See guides at the Asterisk Wiki:
33      https://wiki.asterisk.org/wiki/x/tAHOAQ
34      https://wiki.asterisk.org/wiki/x/hYCLAQ
35
36 func_callerid:
37  - The CALLERPRES() dialplan function, deprecated in Asterisk 1.8, has been
38    removed.
39
40 res_parking:
41  - The PARKINGSLOT channel variable, deprecated in Asterisk 12 in favor of the
42    PARKING_SPACE channel variable, will no longer be set.
43
44 res_xmpp:
45  - The JabberStatus application, deprecated in Asterisk 12, has been removed.
46
47 Channels:
48  - The core no longer uses the stasis cache for channels snapshots.
49    The following APIs are no longer available:
50        ast_channel_topic_cached()
51        ast_channel_topic_all_cached()
52    The ast_channel_cache_all() and ast_channel_cache_by_name() functions
53    now returns an ao2_container of ast_channel_snapshots rather than a
54    container of stasis_messages therefore you can't call stasis_cache
55    functions on it.
56    The ast_channel_topic_all() function now returns a normal topic,
57    not a cached one so you can't use stasis cache functions on it either.
58    The ast_channel_snapshot_type() stasis message now has the
59    ast_channel_snapshot_update structure as it's data.
60    ast_channel_snapshot_get_latest() still returns the latest snapshot.
61
62 Applications
63  - The JabberStatus application, deprecated in Asterisk 12, has been removed.
64
65 Bridging
66  - The bridging core no longer uses the stasis cache for bridge
67    snapshots.  The latest bridge snapshot is now stored on the
68    ast_bridge structure itself.
69  - The following APIs are no longer available since the stasis cache
70    is no longer used:
71      ast_bridge_topic_cached()
72      ast_bridge_topic_all_cached()
73  - A topic pool is now used for individual bridge topics.
74  - The ast_bridge_cache() function was removed since there's no
75    longer a separate container of snapshots.
76  - A new function "ast_bridges()" was created to retrieve the
77    container of all bridges.  Users formerly calling
78    ast_bridge_cache() can use the new function to iterate over
79    bridges and retrieve the latest snapshot directly from the
80    bridge.
81  - The ast_bridge_snapshot_get_latest() function was renamed to
82    ast_bridge_get_snapshot_by_uniqueid().
83  - A new function "ast_bridge_get_snapshot()" was created to retrieve
84    the bridge snapshot directly from the bridge structure.
85  - The ast_bridge_topic_all() function now returns a normal topic
86    not a cached one so you can't use stasis cache functions on it
87    either.
88  - The ast_bridge_snapshot_type() stasis message now has the
89    ast_bridge_snapshot_update structure as it's data.  It contains
90    the last snapshot and the new one.
91