Archived Upgrade Notes¶

2015¶

15.20¶

Consult the 15.20 Roadmap

Debian has been upgraded from version 7 (wheezy) to 8 (jessie).
CSV webservices in the web interface have been removed. Please use the xivo-confd REST API instead.
The CSV import format has been changed. Consult CSV Migration for further details.
xivo-ctid now uses STARTTLS for the client connections.
- For users already using the CTIS protocol the client can be configured to use the default port (5003)

Please consult the following detailed upgrade notes for more information:

15.19¶

Consult the 15.19 Roadmap

The sound file /usr/share/asterisk/sounds/fr_FR/une.wav has been moved to /usr/share/asterisk/sounds/fr_FR/digits/1F.wav.
If you would like to use the new “transfer to voicemail” feature from the People Xlet, you’ll need to update your directory definition and your directory display, i.e.:
- edit your “internal” directory definition (Services / CTI server / Directories / Definitions) and add a field “voicemail” with value “voicemail_number”
- edit your display (Services / CTI server / Directories / Display filters) and add a row with title “Voicemail”, field type “voicemail” and field name “voicemail”
- restart xivo-dird
It is now possible to send an email to a user with a configured email address in the people xlet. See Views to add the appropriate field to your configured displays.
The Contacts xlet (aka. Search) has been removed in favor of the People Xlet. You may need to do some manual configuration in the directories for the People Xlet to be fully functional. See the detailed upgrade notes for more details.
If you need context separation in the People Xlet, you will have to manually configure xivo-dird to keep it working, see Context separation. This procedure is only temporary, later versions will handle the context separation automatically.
xivo-agentd now uses mandatory token authentication for its REST API. If you have custom development using this service, update your program accordingly.
Some actions that used to be available in the contact xlets are not implemented in the people xlet yet.
- Cancel transfer is only available using the switchboard xlet
- Hanging up a call is only possible using the switchboard xlet
- Call interception is not available anymore
- Conference room invitation is not available anymore

Please consult the following detailed upgrade notes for more information:

15.18¶

Consult the 15.18 Roadmap

The provd_pycli command (deprecated in 15.06) has been removed in favor of xivo-provd-cli. If you have custom scripts referencing provd_pycli, you’ll need to update them.
The xivo-agentctl command (deprecated in 15.06) has been removed in favor of xivo-agentd-cli. If you have custom scripts referencing xivo-agentctl, you’ll need to update them.
xivo-agentd now uses HTTPS. If you have custom development using this service, update your configuration accordingly. The xivo-agentd-client library, used to interact with xivo-agentd, has also been updated to use HTTPS by default.
xivo-confd ports 50050 and 50051 have been removed. Please use 9486 and 9487 instead

Configuration File Upgrade Notes

The file format of configuration files for daemons exposing an HTTP/S API has changed. The following services have been affected :

xivo-agentd

xivo-amid

xivo-auth

xivo-confd

xivo-ctid

xivo-dird

xivo-dird-phoned

Ports and listening addresses are now organised in the following fashion:

rest_api:
  https:
    enabled: true
    port: 9486
    listen: 0.0.0.0
    certificate: /usr/share/xivo-certs/server.crt
    private_key: /usr/share/xivo-certs/server.key
    ciphers: "ALL:!aNULL:!eNULL:!LOW:!EXP:!RC4:!3DES:!SEED:+HIGH:+MEDIUM"
  http:
    enabled: true
    port: 9487
    listen: 127.0.0.1

If you have any custom configuration files for these daemons, please modify them accordingly. Consult Network for further details on which network services are available for each daemon.

15.17¶

Consult the 15.17 Roadmap

Online call recording is now done via automixmon instead of automon. This has no impact unless you have custom dialplan that is passing directly the “w” or “W” option to the Dial or Queue application. In these cases, you should modify your dialplan to pass the “x” or “X” option instead.
The remote directory service available from supported phones is now provided by the new unified directory service, i.e. xivo-dird. Additional upgrade steps are required to get the full benefit of the new directory service; see the detailed upgrade notes.
The field enableautomon has been renamed to enableonlinerec in the users web services provided by the web-interface (these web services are deprecated).
The agent status dashboard now shows that an agent is calling or receiving a non ACD call while in wrapup or paused.
SIP endpoints created through the REST API will not appear in the web interface until they have been associated with a line
Due to limitations in the database, only a limited number of optional parameters can be configured on a SIP endpoint. Consult the xivo-confd REST API changelog for further details

Please consult the following detailed upgrade notes for more information:

Phone Remote Directory Upgrade Notes

15.16¶

Consult the 15.16 Roadmap

The directory column type “mobile” was removed in favor of the new “callable” type. If you have hand-written configuration files for xivo-dird, in section “views”, subsection “displays”, all keys “type” with value “mobile” must be changed to value “callable”.
The xivo-auth backend interface has changed, get_acls is now get_consul_acls. All unofficial back ends must be adapted and updated. No action is required for “normal” installations.
Voicemails can now be deleted even if they are associated to a user.

15.15¶

Consult the 15.15 Roadmap

Voicemail Upgrade Notes

Voicemail webservices in the web interface have been removed. Please use the xivo-confd REST API instead.

Voicemail IMAP configuration has been migrated to the new Advanced tab.

Voicemail option Disable password checking has been converted to Ask password. The value has also been inverted. (e.g. If Disable password checking was false, Ask password is true.) Ask password is activated by default.

After an upgrade, if ever you have errors when searching for voicemails, please try clearing cookies in your web browser.

A voicemail must be dissociated from any user prior to being deleted. Voicemail are dissociated by editing the user and clicking on the Delete voicemail button in the Voicemail tab. This constraint will disappear in future versions.

Deleting a user will dissociate any voicemail that was attached, but will not delete it nor any messages.

Creating a line is no longer necessary when attaching a voicemail to a user.

The following fields have been modified when importing a CSV file:

Old name	New name	Required ?	New default value
voicemailmailbox	voicemailnumber	yes
voicemailskippass	voicemailaskpassword	no	1
	voicemailcontext	yes

Directories

Concatenated fields in directories are now done in the directory definitions instead of the displays

The field column in directory displays are now field names from the directory definition. No more {db-*} are required

In the directory definitions fields can be modified using a python format string with the fields comming from the source.

Most of the configuration for xivo-dird is now generated from xivo-confgen using the values in the web interface.

The remote directory xlet has been removed in favor of the new people xlet.

See Directories and Integration of xivo-dird with the rest of Wazo for more details

15.14¶

Consult the 15.14 Roadmap
Default password for xivo-polycom-4.0.4 plugin version >= 1.3 is now 9486 (i.e. the word “xivo” on a telephone keypad).
Default password for xivo-polycom-5.3.0 plugin version >= 1.4 is now 9486.
Caller id management for users in confd has changed. Consult the xivo-confd REST API changelog.
The Local Directory Xlet is replaced with the People Xlet. Contacts are automatically migrated to the server. Note that the CSV format for importing contacts has changed (see People Xlet for more information).

15.13¶

Consult the 15.13 Roadmap
Asterisk has been upgraded from version 11.17.1 to 13.4.0, which is a major Asterisk upgrade.
An ARI user has been added to /etc/asterisk/ari.conf. If you have configured Asterisk HTTP server to bind on a publicly reachable address (in /etc/asterisk/http.conf), then you should update your configuration to prevent unauthorized access on your Asterisk.
The xivo-dird configuration option source_to_display_columns has been removed in favor of the new option format_columns. All source configuration using the source_to_display_columns must be updated. A migration script will automatically modify source configuration in the /etc/xivo-dird/sources.d directory.

Please consult the following detailed upgrade notes for more information:

Asterisk 11 to 13 Upgrade Notes

15.12¶

Consult the 15.12 Roadmap
The certificate used for HTTPS in the web interface will be regenerated if the default certificate was used. Your browser will complain about the new certificate, and it is safe to accept it (see #3656). See also HTTPS certificate.
If you have an HA configuration, then you should run xivo-sync -i on the master node to setup file synchronization between the master and the slave. File synchronization will then be done automatically every hour via rsync and ssh.
xivo-auth and xivo-dird now use HTTPS, if you have custom development using these services, update your configuration accordingly.

15.11¶

Consult the 15.11 Roadmap
The call records older than 365 days will be periodically removed. The first automatic purge will occur in the night after the upgrade. See xivo-purge-db for more details.

15.10¶

Consult the 15.10 Roadmap

15.09¶

Consult the 15.09 Roadmap

15.08¶

Consult the 15.08 Roadmap
The Dialer Xlet has been integrated in Identity Xlet.

15.07¶

Consult the 15.07 Roadmap

15.06¶

Consult the 15.06 Roadmap
The provd client has been moved into a new python package, xivo_provd_client. If you have custom scripts using this client, you’ll need to update them. See http://projects.wazo.community/issues/5469 for more information.
The provd_pycli command name has been deprecated in favor of xivo-provd-cli. These 2 commands do the same thing, the only difference being the name of the command. The provd_pycli command name will be removed in 15.18, so if you have custom scripts referencing provd_pycli, you’ll need to update them.
The xivo-agentctl command name has been deprecated in favor of xivo-agentd-cli. These 2 commands do the same thing, the only difference being the name of the command. The xivo-agentctl command name will be removed in 15.18, so if you have custom scripts referencing xivo-agentctl, you’ll need to update them.

15.05¶

Consult the 15.05 Roadmap
The Xlet identity has been modified to follow the new XiVO Client design which implies the removal of some details.

15.01¶

Consult the 15.01 Roadmap
The confd REST API is now more restrictive on HTTP headers. Particularly, the headers Accept and Content-Type must be set to (typically) application/json.
The following configuration files have been created:
- /etc/xivo-agid/config.yml
- /etc/xivo-call-logd/config.yml
- /etc/xivo-amid/config.yml
- /etc/xivo-agentd/config.yml

2014¶

14.24¶

Consult the 14.24 Roadmap

The following security vulnerability has been fixed:

XIVO-2014-01: Queues and groups permit callers to make unwanted calls

14.23¶

Consult the 14.23 Roadmap
The “waiting calls / logged agents ratio” queue diversion scenario has been renamed to “number of waiting calls per logged agents”.
A new community section was added to the official documentation for all user-contributed documentation.

14.22¶

Consult the 14.22 Roadmap
The sheet event Dial on queues is now only sent to the ringing agent. The sheet is also sent a little later during the call, when the ringing agent is known.

14.21¶

Consult the 14.21 Roadmap
The confd REST API is now accessible via HTTPS on port 9486 and via HTTP on port 9487 (localhost only). These ports are replacing the 50051 and 50050 ports respectively. It will still be possible to access the confd REST API via the 50051 and 50050 ports for the next year, but you are advised to update your confd REST API clients as soon as possible.
The old (unsupported) ami-proxy is now replaced by an ami-proxy built in xivo-ctid. You must uninstall the old ami-proxy before activating the built-in version. See troubleshooting xivo-ctid to learn how to activate.

14.20¶

Consult the 14.20 Roadmap
Default parameters for all Cisco SPA ATA plugins have changed to be better suited for european faxes.
Following the POODLE attack (CVE-2014-3566), SSL 3.0 has been disabled for the web interface and the xivo-confd REST API.

If you have Aastra phones and are using the remote directory on them, consult the following detailed upgrade notes:

Aastra Remote Directory Upgrade Notes

14.19¶

Consult the 14.19 Roadmap

14.18¶

Consult the 14.18 Roadmap
xivo-fai packages were replaced with xivo-dist : a new tool to handle repositories sources. Upon upgrade, xivo-dist is installed and run and all xivo-fai packages are purged. Consult xivo-dist use cases

14.17¶

Consult the 14.17 Roadmap
DAHDI configuration file /etc/dahdi/modules is no more created by default and must now be maintained manually. No action is needed upon upgrade but be aware that the upstream sample file is now available in /usr/share/dahdi/modules.sample. See dahdi modules documentation for detailed info.
The new CCSS feature will not be enabled upon upgrade, you must explicitly enable it in the IPBX ‣ IPBX Services ‣ Extensions menu.

14.16¶

Consult the 14.16 Roadmap
See the changelog for xivo-confd’s REST API
DAHDI is upgraded to 2.10.0. If the upgrade process asks about /etc/dahdi/modules, we recommend that you keep the old version of the file.
Asterisk now inserts CEL and queue log entries via the ODBC asterisk modules instead of the pgsql modules.

14.15¶

Consult the 14.15 Roadmap
Duplicate function keys will be deleted upon upgrade. If multiple function keys pointing to the same destination are detected for a given user, only the one with the lowest position will be kept. To see the list of deleted function keys, check the xivo-upgrade log file such as:
```
grep MIGRATE_FK /var/log/xivo-upgrade.log
```

DAHDI 2.9.2 Upgrade Notes

14.14¶

Consult the 14.14 Roadmap
See the changelog for REST API
Upon an important freeze of Asterisk, Asterisk will be restarted. See the associated ticket for more information.

14.13¶

Consult the 14.13 Roadmap
See the changelog for REST API
Skills-based routing: for an agent which doesn’t have the skill X, the rule X < 10 was previously evaluated to true, since not having the skill X was equivalent to having it with a value of 0. This behaviour has changed, and the same expression is now evaluated to false. If you are using skills-based routing, you’ll need to check that your rules are still doing what you expect. See skill evaluation for more information.

14.12¶

Consult the 14.12 Roadmap
All provisioning plugins were modified. Although not mandatory, it is strongly advised to update all used plugins.
The function key ‘Activate voicemail’ was removed as it was a duplicate of existing function key ‘Enable voicemail’. All users having the ‘Activate voicemail’ function key will have to be reconfigured with a ‘Enable voicemail’ function key in order to keep the equivalent feature.
Log files have changed for the following daemons (previously in /var/log/daemon.log):
- xivo-provd: /var/log/xivo-provd.log
- xivo-agid: /var/log/xivo-agid.log
- xivo-sysconfd: /var/log/xivo-sysconfd.log

14.11¶

Consult the 14.11 Roadmap
The API URL /lines/<id>/extension is now deprecated. Use /lines/<id>/extensions instead.

14.10¶

Consult the 14.10 Roadmap
Custom MOH have been fixed, but can not be used for playing uploaded files anymore. See Music on Hold.

14.09¶

Consult the 14.09 Roadmap
REST API 1.0 is no more. All code, tests and documentation was removed from XiVO. All code developped for REST API 1.0 must now be adapted to use REST API 1.1.

14.08¶

Consult the 14.08 Roadmap
The xivo database has been merged into the asterisk database. The database schema has also been altered in a way that it might make the upgrade longer than usual.

Please consult the following detailed updated notes for more information:

Databases Merge Upgrade Notes

14.07¶

Consult the 14.07 Roadmap
Configuration for phones used for the switchboard has changed.

Please consult the following detailed updated notes for more information:

Switchboard Phone Configuration Upgrade Notes

14.06¶

Consult the 14.06 Roadmap
The XiVO client now uses Qt 5 instead of Qt 4. There is nothing to be aware of unless you are building your own version of it.

14.05¶

Consult the 14.05 Roadmap
The CTI Protocol has been updated.
The specification of the ‘answered-rate’ queue statistic has changed to exclude calls on a closed queue
The switchboard can now choose which incoming call to answer
The package versions do not necessarily contain the current XiVO version, it may contain older versions. Only the package xivo is guaranteed to have the current XiVO version.

Please consult the following detailed updated notes for more information:

14.04¶

Consult the 14.04 Roadmap
Live reload of the configuration can be enabled and disabled using the REST API
The generation of call logs for unanswered calls from the XiVO client have been improved.

14.03¶

Consult the 14.03 Roadmap
A migration script adds an index on the linkedid field in the cel table. Tests have shown that this operation can last up to 11.5 minutes on a XiVO Corporate with 18 millions CELs. xivo-upgrade will thus be slightly longer.
Two new daemons are now operationnal, xivo-amid and xivo-call-logd:
- xivo-amid constantly reads the AMI and sends AMI events to the RabbitMQ bus
- xivo-call-logd generates call-logs in real time based on AMI LINKEDID_END events read on the bus
An increase in load average is expected with the addition of these two new daemons.
The cron job calling xivo-call-logs now runs once a day at 4:25 instead of every 5 minutes.

14.02¶

Consult the 14.02 Roadmap
PHP Web services has been removed from documentation
REST API 1.0 Web services has been removed from documentation
REST API 1.1 User-Line-Extension service is replaced by User-Line and Line-Extension services

14.01¶

Consult the 14.01 Roadmap
The following paths have been renamed:
- /etc/pf-xivo to /etc/xivo
- /var/lib/pf-xivo to /var/lib/xivo
- /usr/share/pf-xivo to /usr/share/xivo

You must update any dialplan or configuration file using these paths

2013¶

13.25¶

Consult the 13.25 Roadmap
Debian has been upgraded from version 6 (squeeze) to 7 (wheezy).

Please consult the following detailed upgrade notes for more information:

Debian 7 (wheezy) Upgrade Notes

13.24¶

Consult the 13.24 Roadmap
Default Quality of Service (QoS) settings have been changed for SCCP. The IP packets containing audio media are now marked with the EF DSCP.

13.23¶

Consult the 13.23 Roadmap
The New call softkey has been removed from SCCP phones in connected state. To start a new call, the user will have to press Hold then New call. This is the same behavior as a Call Manager.
Some softkeys have been moved on SCCP phones. We tried to keep the keys in the same position at any given time. As an example, the transfer key will not become End call while transfering a call. Note that this is a work in progress and some models still need some tweaking.

13.22¶

Consult the 13.22 Roadmap
PostgreSQL will be upgraded from 9.0 to 9.1. The upgrade of XiVO will take longer than usual, depending on the size of the database. Usually, the database grows with the number of calls processed by XiVO. The upgrade will be stopped if not enough space is available on the XiVO server.

13.21¶

Consult the 13.21 Roadmap
It is no more possible to delete a device associated to a line using REST API.

13.20¶

Consult the 13.20 Roadmap
xivo-libsccp now supports direct media on wifi phone 7920 and 7921
xivo-confd now implements a voicemail list

13.19¶

Since XiVO 13.18 was not released, the 13.19 release contains all developments of both 13.18 and 13.19, therefore please consult both Roadmaps :

Consult the 13.19 Roadmap

Consult the 13.18 Roadmap

Call logs are now generated automatically, incrementally and regularly. Call logs generated before 13.19 will be erased one last time.
The database was highly modified for everything related to devices : table devicefeatures does not exist anymore and now relies on information from xivo-provd.

13.17¶

Consult the 13.17 Roadmap
There is a major change to call logs. They are no longer available as a web report but only as a csv export. See the call logs documentation. Furthermore, call logs are now fetched from xivo-confd REST API.
Paging group numbers are now exclusively numeric. All non-numeric paging group numbers are converted to their numeric-only equivalent while upgrading to XiVO 13.17 ( *58 becomes 58, for example).

13.16¶

Consult the 13.16 Roadmap
A migration script modifies the user and line related-tables and the way users, lines and extensions are associated. As a consequence of this script, it is not possible any more to associate a user and a line without extensions. Existing associations between users and one or more lines having no extensions will be removed. Users and lines will still exist unassociated.
The call logs page is able to display partial results of big queries, instead of displaying a blank page.
Two new CEL messages are now enabled : LINKEDID_END and BRIDGE_UPDATE. Those events will only exist in CEL for calls passed after upgrading to XiVO 13.16.
The new REST API now makes possible to associate multiple user to a given line and/or extension. There are currently some limitations on how those users and lines can be manipulated using the web interface.

13.15¶

There was no production release of XiVO 13.15. All 13.15 developments are included in the official 13.16 release.

13.14¶

Consult the 13.14 Roadmap
The latest Polycom plugin enables the phone lock feature with a default user password of ‘123’. All Polycom phones used with XiVO also have a default admin password. In order for the phone lock feature to be secure, one should change every phone’s admin AND user passwords.
WebServices for SIP trunks/lines: field nat: value yes changed to force_rport,comedia
The database has beed updated in order to remove deprecated tables (generalfeatures, extenumbers, extenhash, cost_center).

13.13¶

Consult the 13.13 Roadmap

13.12¶

Consult the 13.12 Roadmap
CTI protocol: Modified values of agent availability. Read CTI Protocol changelog
Clean-up was made related to the minimization of the XiVO Client. Some visual differences have been observed on Mac OS X that do not affect the XiVO Client in a functional way.

13.11¶

Consult the 13.11 Roadmap
Asterisk has been upgraded from version 11.3.0 to 11.4.0

API changes:

Dialplan variable XIVO_INTERFACE_0 is now XIVO_INTERFACE
Dialplan variable XIVO_INTERFACE_NB and XIVO_INTERFACE_COUNT have been removed
The following fields have been removed from the lines and users web services
- line_num
- roles_group
- rules_order
- rules_time
- rules_type

13.10¶

Consult the 13.10 Roadmap

API changes:

CTI protocol: for messages of class getlist and function updateconfig, the config object/dictionary does not have a rules_order key anymore.

13.09¶

Consult the 13.09 Roadmap
The Restart CTI server link has been moved from Services ‣ CTI Server ‣ Control to Services ‣ IPBX ‣ Control.
The Agent Status Dashboard has been optimized.
The Directory xlet can now be used to place call.

13.08¶

Consult the 13.08 Roadmap
asterisk has been upgraded from version 1.8.21.0 to 11.3.0, which is a major asterisk upgrade.
The switchboard’s queue now requires the xivo_subr_switchboard preprocess subroutine.
A fix to bug #4296 introduced functional changes due to the order in which sub-contexts are included. Please refer to ticket for details.

Please consult the following detailed upgrade notes for more information:

13.07¶

Consult the 13.07 Roadmap
Agent Status Dashboard has more features and less limitations. See related agent status dashboard documentation
XiVO call centers have no more notion of ‘disabled agents’. All previously disabled agents in web interface will become active agents after upgrading.
asterisk has been upgraded from version 1.8.20.1 to 1.8.21.0. Please note that in XiVO 13.08, asterisk will be upgraded to version 11.
DAHDI has been upgraded from version 2.6.1 to 2.6.2.
libpri has been upgraded from version 1.4.13 to 1.4.14.
PostgreSQL upgraded from version 9.0.4 to 9.0.13

13.06¶

Consult the 13.06 Roadmap
The new Agent Status Dashboard has a few known limitations. See related dashboard xlet known issues section
Status Since counter in xlet list of agents has changed behavior to better reflect states of agents in queues as seen by asterisk. See Ticket #4254 for more details.

13.05¶

Consult the 13.05 Roadmap
The bug #4228 concerning BS filter only applies to 13.04 servers installed from scratch. Please upgrade to 13.05.
The order of softkeys on SCCP phones has changed, e.g. the Bis button is now at the left.

13.04¶

Consult the 13.04 Roadmap
Upgrade procedure for HA Cluster has changed. Refer to Specific Procedure : Upgrading a Cluster.
Configuration of switchboards has changed. Since the directory xlet can now display any column from the lookup source, a display filter has to be configured and assigned to the __switchboard_directory context. Refer to Directory xlet documenttion.
There is no more context field directly associated with a call filter. Boss and secretary users associated with a call filter must necessarily be in the same context.

Archived Upgrade Notes¶

2015¶

15.20¶

15.19¶

15.18¶

15.17¶

15.16¶

15.15¶

15.14¶

15.13¶

15.12¶

15.11¶

15.10¶

15.09¶

15.08¶

15.07¶

15.06¶

15.05¶

15.04¶

15.03¶

15.02¶

15.01¶

2014¶

14.24¶

14.23¶

14.22¶

14.21¶

14.20¶

14.19¶

14.18¶

14.17¶

14.16¶

14.15¶

14.14¶

14.13¶

14.12¶

14.11¶

14.10¶

14.09¶

14.08¶

14.07¶

14.06¶

14.05¶

14.04¶

14.03¶

14.02¶

14.01¶

2013¶

13.25¶

13.24¶

13.23¶

13.22¶

13.21¶

13.20¶

13.19¶

13.17¶

13.16¶

13.15¶

13.14¶

13.13¶

13.12¶

13.11¶

13.10¶

13.09¶

13.08¶

13.07¶

13.06¶

13.05¶

13.04¶