Upgrade

Overview

The following components will be upgraded :

  • Docker images
  • xivocc-installer package

Warning

This upgrade procedure applies only to XiVO CC installed via the xivocc-installer package.

Prerequisites

Before upgrading you have to check or change your sources list. It should be located in the file /etc/apt/sources.list.d/xivo-solutions.list.

There are two cases :

  1. Upgrade to latest version,
  2. Upgrade to a specific version (or an archive version)

Upgrade to latest version

To upgrade to the latest version the sources list must point towards debian URI and xivo-solutions suite:

deb http://mirror.xivo.solutions/debian/ xivo-solutions main

Upgrade to specific version

To upgrade to a specific version the sources list must point towards archive URI and xivo-solutions-VERSION suite.

For example if you want to upgrade to 2016.03 version you should have:

deb http://mirror.xivo.solutions/archive/ xivo-solutions-2016.03 main

Note the /archive/ and -2016.03 above.

Upgrade

When you have checked the sources.list you can upgrade with the following commands:

apt-get update
apt-get install xivocc-installer

The current docker-compose.yml file will be renamed to docker-compose.yml.dpkg-old and new template downloaded. A new docker-compose.yml file will be rendered from the template using the current xivocc version.

Then you run the new version by dcomp up -d eventually preceded by the dcomp pull to download the new images.

Upgrade notes

2016.04

Consult the 2016.04 Roadmap

System

  • Parameters for /etc/docker/compose/docker-xivocc.yml are now stored in /etc/docker/compose/.env file. Important parameter is XIVO_AMI_SECRET, which holds Ami password.

  • To be able to use the /etc/docker/compose/.env file, a new dcomp alias is generated in .bashrc. You must run:

    source .bashrc

    before running dcomp again.

Note

If you are using docker-compose instead of recommended alias dcomp, make sure your current directory is /etc/docker/compose, otherwise /etc/docker/compose/.env won’t be used. i.e.:

cd /etc/docker/compose
docker-compose ...

Web/Desktop Assistant

  • For displaying search result, compatibility with xivo-dird of XiVO PBX has been enhanced. After upgrade you must verify the configuration of your CTI directory Display in XiVO PBX as described in Directories and Views.

Note

Integration note: the Web and Desktop Assistant support only the display of

  • 1 field for name (the one of type name in the directory display)
  • 3 numbers (the one of type number and the first two of type callable)
  • and 1 email

Callbacks (CCManager)

  • Default csv separator has been changed from pipe ‘|’ to comma ‘,’ for the callback export.

2016.03

No behavior changes.