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.

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 three cases:

  1. Upgrade to the latest XiVO CC version,
  2. Upgrade to a specific version (or archive version),
  3. Upgrade to the latest subversion of your current installed 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-latest suite.

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

deb http://mirror.xivo.solutions/archive/ xivo-solutions-2017.03-latest main

Note the /archive/ and -2017.03-latest above.

Upgrade to latest subversion

After the release of a version (e.g. 2017.03) we may backport some bugfixes in this version. We will then create a subversion (e.g. 2017.03 .01) shipping these bugfixes. To upgrade to the latest subversion of your current installed version you need to:

XiVO CC >= 2017.03 :

  1. Verify that the /etc/docker/compose/factory.env file has
    1. XIVOCC_TAG=VERSION (where VERSION is your current installed version - e.g. 2017.03)
    2. and XIVOCC_DIST=latest
  2. Then update the images with xivocc-dcomp pull command,
  3. And upgrade the containers with xivocc-dcomp up -d command.

XiVO CC >= 2016.04 :

  1. Verify that the /etc/docker/compose/.env file has
    1. XIVOCC_TAG=VERSION (where VERSION is your current installed version - e.g. 2016.04)
    2. and XIVOCC_DIST=latest
  2. Then update the images with dcomp pull command,
  3. And upgrade the containers with dcomp up -d command.

XiVO CC = 2016.03 :

  1. Verify that the file /etc/docker/compose/docker-compose.yml contains the tag 2016.03 .latest for the appropriate containers,
  2. Then update the images with dcomp pull command,
  3. And upgrade the containers with dcomp up -d command.

Preparing the upgrade

To prepare the upgrade you should:

  1. Read XiVO Solutions Release Notes starting from your version to the version you target.

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 have to:

  1. Download the new images:

    xivocc-dcomp pull

  2. And run the new container (All XiVO CC services will be restarted):

    xivocc-dcomp up -d

Note

Please, ensure your server date is correct before starting. If system date differs too much from correct date, you may get an authentication error preventing download of the docker images.

Post Upgrade

Check your upgrade through Post Installation Check List.

Upgrade notes

See XiVO Solutions Release Notes for version specific informations.