Upgrade Deneb to Electra

In this section is listed the manual steps to do when migrating from Deneb to Electra.

Warning

XiVO UC/CC: before upgrading to Electra you MUST upgrade the host to Debian 9 (Stretch). See XiVO UC/CC Debian 9 (Stretch) Upgrade Procedure.

Before Upgrade

  • Custom container configurations
    • Compose file version was upgraded to version 3.7. See the Compose file version 3 reference. If you have custom configurations, you should update them before starting the upgrade. Some of the previously used options, like volumes_from, can’t be used anymore. To share data between containers, suggested procedure is:
      • use named volume (see the Volume configuration reference)
      • to init the volume with data from the container, remove the container before starting it with the new configuration
      • to customize data in the volume, copy them with docker cp to the target container

On XiVO PBX

  • XDS:
    • All media servers must be stopped with xivo-service stop all before upgrading XiVO. The rabbitmq exchange “xivo” was changed from “topic” to “x-delayed-message” type. If any media server is running, the exchange type may not be changed and XiVO will fail to start. If this happens, the rabbitmq container on XiVO must be stopped, removed and created again.

On XiVO CC

Warning

before upgrading to Electra

  • you MUST upgrade the host to Debian 9 (Stretch). See XiVO UC/CC Debian 9 (Stretch) Upgrade Procedure.
  • you MUST be using Kibana in version 7 (the version that was released with Deneb LTS). If you did not yet upgrade Kibana to version 7 and remained using v3 you MUST upgrade it before upgrading to Electra.

After Upgrade

Important

After upgrade, you HAVE TO manually install the xivo-chat-backend package. It must be done on your XiVO CC/UC server (or on UC Addon if you are in this setup).

Follow instructions in Chat Backend section.

If you don’t do it the whole Chat feature won’t work properly.

Note that you can also completely disable the Chat - see Disabling chat in UC Assistant and Switchboard.

On XiVO PBX

  • With UC Addon installed on your XiVO PBX: for the Chat feature to work properly you have to manually install the xivo-chat-backend package. See note above.
  • Switchboard: to be able to use the new Switchboard application you MUST replace your old switchboard configuration with the new configuration.

On XiVO CC/UC

  • For the Chat feature to work properly you have to manually install the xivo-chat-backend package. See note above.
  • Reporting: the last 7 days of data will be re-replicated to Elasticsearch, see Data flow. It may take some time if you have a huge amout of calls per week (more than 1 hour if you have 2 million of queue_log per week).

On MDS