diff --git a/CHANGES b/CHANGES index 4d47191605..07e5f2c4f8 100644 --- a/CHANGES +++ b/CHANGES @@ -87,22 +87,65 @@ Debugging --- Functionality changes from Asterisk 12.0.0 to Asterisk 12.1.0 ------------ ------------------------------------------------------------------------------ +AMI +------------------ + * Added a new module that provides AMI control over MWI within Asterisk, + res_mwi_external_ami. Note that this module depends on res_mwi_external; + for more information on enabling this module, see res_mwi_external. + This module provides the MWIGet/MWIUpdate/MWIDelete actions, as well as + the MWIGet/MWIGetComplete events. + + * The DialStatus field in the DialEnd event can now contain additional + statuses that convey how the dial operation terminated. This includes + ABORT, CONTINUE, and GOTO. + ARI ------------------ * Added a new ARI resource 'mailboxes' which allows the creation and modification of mailboxes managed by external MWI. Modules res_mwi_external - and res_stasis_mailbox must be enabled to use this resource. + and res_stasis_mailbox must be enabled to use this resource. For more + information on external MWI control, see res_mwi_external. + + * Added new events for externally initiated transfers. The event + BridgeBlindTransfer is now raised when a channel initiates a blind transfer + of a bridge in the ARI controlled application to the dialplan; the + BridgeAttendedTransfer event is raised when a channel initiates an + attended transfer of a bridge in the ARI controlled application to the + dialplan. + + * Channel variables may now be specified as a body parameter to the + POST /channels operation. The 'variables' key in the JSON is interpreted + as a sequence of key/value pairs that will be added to the created channel + as channel variables. Other parameters in the JSON body are treated as + query parameters of the same name. -chan_pjsip +res_pjsip ------------------ * Path support has been added with the 'support_path' option in registration and aor sections. -res_pjsip ------------------- * A 'debug' option has been added to the globals section that will allow sip messages to be logged. + * A 'set_var' option has been added to endpoints that will automatically + set the desired variable(s) on a channel created for that endpoint. + + * Several new tables and columns have been added to the realtime schema for + the res_pjsip related modules. See the UPGRADE.txt notes for updating + the database schema. + +res_mwi_external +------------------ + * A new module, res_mwi_external, has been added to Asterisk. This module + acts as a base framework that other modules can build on top of to allow + an external system to control MWI within Asterisk. For implementations + that make use of res_mwi_external, see res_mwi_external_ami and + res_ari_mailboxes. Note that res_mwi_external canflicts with other modules + that may produce MWI themselves, such as app_voicemail. res_mwi_external + and other modules that depend on it cannot be built or loaded with + app_voicemail present. + + ------------------------------------------------------------------------------ --- Functionality changes from Asterisk 11 to Asterisk 12 -------------------- ------------------------------------------------------------------------------ diff --git a/UPGRADE.txt b/UPGRADE.txt index d0460fbb29..fa27e9d264 100644 --- a/UPGRADE.txt +++ b/UPGRADE.txt @@ -32,6 +32,39 @@ From 12 to 13: an older version of rasterisk connects to the new version then the "core set verbose" command will have no effect. +ARI: + - The ARI version has been changed from 1.0.0 to 1.1.0. This is to reflect + the backwards compatible changes listed below. + + - Added a new ARI resource 'mailboxes' which allows the creation and + modification of mailboxes managed by external MWI. Modules res_mwi_external + and res_stasis_mailbox must be enabled to use this resource. + + - Added new events for externally initiated transfers. The event + BridgeBlindTransfer is now raised when a channel initiates a blind transfer + of a bridge in the ARI controlled application to the dialplan; the + BridgeAttendedTransfer event is raised when a channel initiates an + attended transfer of a bridge in the ARI controlled application to the + dialplan. + + - Channel variables may now be specified as a body parameter to the + POST /channels operation. The 'variables' key in the JSON is interpreted + as a sequence of key/value pairs that will be added to the created channel + as channel variables. Other parameters in the JSON body are treated as + query parameters of the same name. + +AMI: + - The AMI version has been changed from 2.0.0 to 2.1.0. This is to reflect + the backwards compatible changes listed below. + + - The DialStatus field in the DialEnd event can now have additional values. + This includes ABORT, CONTINUE, and GOTO. + + - The res_mwi_external_ami module can, if loaded, provide additional AMI + actions and events that convey MWI state within Asterisk. This includes + the MWIGet, MWIUpdate, and MWIDelete actions, as well as the MWIGet and + MWIGetComplete events that occur in response to an MWIGet action. + CDRs: - The "endbeforehexten" setting now defaults to "yes", instead of "no". When set to "no", yhis setting will cause a new CDR to be generated when a @@ -59,24 +92,30 @@ Configuration Files: instead of a "basic" one. Realtime Configuration: + - WARNING: The database migration script that adds the 'extensions' table for + realtime had to be modified due to an error when installing for MySQL. The + 'extensions' table's 'id' column was changed to be a primary key. This could + potentially cause a migration problem. If so, it may be necessary to + manually alter the affected table/column to bring it back in line with the + migration scripts. + - New columns have been added to realtime tables for 'support_path' on ps_registrations and ps_aors and for 'path' on ps_contacts for the new SIP Path support in chan_pjsip. + - The following new tables have been added for pjsip realtime: 'ps_systems', 'ps_globals', 'ps_tranports', 'ps_registrations'. + - The following columns were added to the 'ps_aors' realtime table: 'maximum_expiration', 'outbound_proxy', and 'support_path'. + - The following columns were added to the 'ps_contacts' realtime table: 'outbound_proxy' and 'path'. + - New columns have been added to the ps_endpoints realtime table for the 'media_address', 'redirect_method' and 'set_var' options. Also the 'mwi_fromuser' column was renamed to 'mwi_from_user'. - - WARNING: The database migration script that adds the 'extensions' table for - realtime had to be modified due to an error when installing for MySQL. The - 'extensions' table's 'id' column was changed to be a primary key. This could - potentially cause a migration problem. If so, it may be necessary to - manually alter the affected table/column to bring it back in line with the - migration scripts. + - A new column was added to the 'ps_globals' realtime table for the 'debug' option. diff --git a/include/asterisk/manager.h b/include/asterisk/manager.h index 347da6fb2d..e7990bd736 100644 --- a/include/asterisk/manager.h +++ b/include/asterisk/manager.h @@ -54,7 +54,7 @@ - \ref manager.c Main manager code file */ -#define AMI_VERSION "2.0.0" +#define AMI_VERSION "2.1.0" #define DEFAULT_MANAGER_PORT 5038 /* Default port for Asterisk management via TCP */ #define DEFAULT_MANAGER_TLS_PORT 5039 /* Default port for Asterisk management via TCP */ diff --git a/rest-api/api-docs/applications.json b/rest-api/api-docs/applications.json index 32ee3c4582..f976e554a8 100644 --- a/rest-api/api-docs/applications.json +++ b/rest-api/api-docs/applications.json @@ -2,7 +2,7 @@ "_copyright": "Copyright (C) 2013, Digium, Inc.", "_author": "David M. Lee, II ", "_svn_revision": "$Revision$", - "apiVersion": "1.0.0", + "apiVersion": "1.1.0", "swaggerVersion": "1.1", "basePath": "http://localhost:8088/stasis", "resourcePath": "/api-docs/applications.{format}", diff --git a/rest-api/api-docs/asterisk.json b/rest-api/api-docs/asterisk.json index 2f1ca7344e..9c54fc02b8 100644 --- a/rest-api/api-docs/asterisk.json +++ b/rest-api/api-docs/asterisk.json @@ -2,7 +2,7 @@ "_copyright": "Copyright (C) 2012 - 2013, Digium, Inc.", "_author": "David M. Lee, II ", "_svn_revision": "$Revision$", - "apiVersion": "1.0.0", + "apiVersion": "1.1.0", "swaggerVersion": "1.1", "basePath": "http://localhost:8088/stasis", "resourcePath": "/api-docs/asterisk.{format}", diff --git a/rest-api/api-docs/bridges.json b/rest-api/api-docs/bridges.json index 025781c9bf..b259ca8f3a 100644 --- a/rest-api/api-docs/bridges.json +++ b/rest-api/api-docs/bridges.json @@ -2,7 +2,7 @@ "_copyright": "Copyright (C) 2012 - 2013, Digium, Inc.", "_author": "David M. Lee, II ", "_svn_revision": "$Revision$", - "apiVersion": "1.0.0", + "apiVersion": "1.1.0", "swaggerVersion": "1.1", "basePath": "http://localhost:8088/stasis", "resourcePath": "/api-docs/bridges.{format}", diff --git a/rest-api/api-docs/channels.json b/rest-api/api-docs/channels.json index 3ab6080cb4..0cfe90e5f2 100644 --- a/rest-api/api-docs/channels.json +++ b/rest-api/api-docs/channels.json @@ -2,7 +2,7 @@ "_copyright": "Copyright (C) 2012 - 2013, Digium, Inc.", "_author": "David M. Lee, II ", "_svn_revision": "$Revision$", - "apiVersion": "1.0.0", + "apiVersion": "1.1.0", "swaggerVersion": "1.1", "basePath": "http://localhost:8088/stasis", "resourcePath": "/api-docs/channels.{format}", diff --git a/rest-api/api-docs/deviceStates.json b/rest-api/api-docs/deviceStates.json index 1f18ac29b6..fa21ed5713 100644 --- a/rest-api/api-docs/deviceStates.json +++ b/rest-api/api-docs/deviceStates.json @@ -2,7 +2,7 @@ "_copyright": "Copyright (C) 2012 - 2013, Digium, Inc.", "_author": "Kevin Harwell ", "_svn_revision": "$Revision$", - "apiVersion": "1.0.0", + "apiVersion": "1.1.0", "swaggerVersion": "1.1", "basePath": "http://localhost:8088/stasis", "resourcePath": "/api-docs/deviceStates.{format}", diff --git a/rest-api/api-docs/endpoints.json b/rest-api/api-docs/endpoints.json index d9021fb386..7c5447ad45 100644 --- a/rest-api/api-docs/endpoints.json +++ b/rest-api/api-docs/endpoints.json @@ -2,7 +2,7 @@ "_copyright": "Copyright (C) 2012 - 2013, Digium, Inc.", "_author": "David M. Lee, II ", "_svn_revision": "$Revision$", - "apiVersion": "1.0.0", + "apiVersion": "1.1.0", "swaggerVersion": "1.1", "basePath": "http://localhost:8088/stasis", "resourcePath": "/api-docs/endpoints.{format}", diff --git a/rest-api/api-docs/events.json b/rest-api/api-docs/events.json index e26eaa6c6f..a5c7a763a0 100644 --- a/rest-api/api-docs/events.json +++ b/rest-api/api-docs/events.json @@ -2,7 +2,7 @@ "_copyright": "Copyright (C) 2012 - 2013, Digium, Inc.", "_author": "David M. Lee, II ", "_svn_revision": "$Revision$", - "apiVersion": "1.0.0", + "apiVersion": "1.1.0", "swaggerVersion": "1.2", "basePath": "http://localhost:8088/stasis", "resourcePath": "/api-docs/events.{format}", diff --git a/rest-api/api-docs/mailboxes.json b/rest-api/api-docs/mailboxes.json index 40c83b0a9a..6824c4f331 100644 --- a/rest-api/api-docs/mailboxes.json +++ b/rest-api/api-docs/mailboxes.json @@ -2,7 +2,7 @@ "_copyright": "Copyright (C) 2013, Digium, Inc.", "_author": "Jonathan Rose ", "_svn_revision": "$Revision$", - "apiVersion": "1.0.0", + "apiVersion": "1.1.0", "swaggerVersion": "1.1", "basePath": "http://localhost:8088/stasis", "resourcePath": "/api-docs/mailboxes.{format}", diff --git a/rest-api/api-docs/playbacks.json b/rest-api/api-docs/playbacks.json index 0b7146c8ea..848957dc11 100644 --- a/rest-api/api-docs/playbacks.json +++ b/rest-api/api-docs/playbacks.json @@ -2,7 +2,7 @@ "_copyright": "Copyright (C) 2012 - 2013, Digium, Inc.", "_author": "David M. Lee, II ", "_svn_revision": "$Revision$", - "apiVersion": "1.0.0", + "apiVersion": "1.1.0", "swaggerVersion": "1.1", "basePath": "http://localhost:8088/stasis", "resourcePath": "/api-docs/playbacks.{format}", diff --git a/rest-api/api-docs/recordings.json b/rest-api/api-docs/recordings.json index 6a51753a3f..665df4d059 100644 --- a/rest-api/api-docs/recordings.json +++ b/rest-api/api-docs/recordings.json @@ -2,7 +2,7 @@ "_copyright": "Copyright (C) 2012 - 2013, Digium, Inc.", "_author": "David M. Lee, II ", "_svn_revision": "$Revision$", - "apiVersion": "1.0.0", + "apiVersion": "1.1.0", "swaggerVersion": "1.1", "basePath": "http://localhost:8088/stasis", "resourcePath": "/api-docs/recordings.{format}", diff --git a/rest-api/api-docs/sounds.json b/rest-api/api-docs/sounds.json index f54ac042d1..8c57a31b69 100644 --- a/rest-api/api-docs/sounds.json +++ b/rest-api/api-docs/sounds.json @@ -2,7 +2,7 @@ "_copyright": "Copyright (C) 2012 - 2013, Digium, Inc.", "_author": "David M. Lee, II ", "_svn_revision": "$Revision$", - "apiVersion": "1.0.0", + "apiVersion": "1.1.0", "swaggerVersion": "1.1", "basePath": "http://localhost:8088/stasis", "resourcePath": "/api-docs/sounds.{format}", diff --git a/rest-api/resources.json b/rest-api/resources.json index 3b197c369a..5479fc7cac 100644 --- a/rest-api/resources.json +++ b/rest-api/resources.json @@ -2,7 +2,7 @@ "_copyright": "Copyright (C) 2012 - 2013, Digium, Inc.", "_author": "David M. Lee, II ", "_svn_revision": "$Revision$", - "apiVersion": "1.0.0", + "apiVersion": "1.1.0", "swaggerVersion": "1.1", "basePath": "http://localhost:8088/ari", "apis": [