XiVO UC/CC Debian 9 (Stretch) Upgrade Procedure

This page describes what to do to upgrade your XiVO UC/CC to Debian 9 (Stretch).

Important

Upgrade your XiVO UC/CC to Debian 9 (Stretch) is a mandatory step when upgrading to Electra because system freezes were detected during test of Electra version with kernel 3.16. Problem was solved with kernel 4.9 and higher.

Warning

In Debian 9 (Stretch) docker storage driver changed from aufs to overlay2. Therefore all containers and images need to be recreated. Note that overlay2 is incompatible with XFS partition created without ftype=1 option. If the partition is XFS, you MUST check if the option is enabled with the xfs_info command.

Checks

What to check before upgrading to Debian 9 (Stretch):

  • your XiVO UC/CC MUST be in Deneb version otherwise all the database data will be lost !

  • the partition where docker data is stored must not be using XFS file system with ftype different from 1. You can use e.g. this command to check file system:

    docker info 2> /dev/null | grep "Backing Filesystem"
    

    If it is XFS, you can check ftype with the following command (assuming that docker data dir is /var/lib/docker):

    apt-get install xfsprogs
    xfs_info /var/lib/ 2> /dev/null | grep ftype
    

When

The upgrade to Debian 9 (Stretch) should be done before upgrading to Electra (if you are already in Deneb).

It can be done after upgrading to Electra, but it should be done just after. Otherwise your system won’t be stable.

Backups

During upgrade all Kibana configuration (including the dashboard) will be lost (they are stored in elasticsearch container).

You MUST backup Kibana configuration before the upgrade.

Since Deneb version, the database data was exported to the host. Therefore no data loss should happen even when removing the pgxivocc container.

Though we strongly advise to backup the database for safety.

Upgrade

After having backup your configuration you’re ready to upgrade the host to Debian 9 (Stretch). We don’t cover the Debian upgrade procedure itself here, this can be found on Debian 9 release notes.

Here we’ll only give the main steps and where specific actions are to be performed in a XiVO UC/CC context.

The upgrade consist of:

  1. Updating the host to latest Debian 8 (Jessie) version

  2. Switching the sources list to Debian 9 (Stretch). Specifically on a XiVO UC/CC you must also update the sources list of the docker repo:

    sed -i 's/jessie/stretch/' /etc/apt/sources.list /etc/apt/sources.list.d/docker.list
    
  3. Launch the Debian 8 to Debian 9 upgrade

  4. Specifically on a XiVO UC/CC and before rebooting you MUST remove the aufs dir. All docker data will be removed - it is safe only in Deneb version:

    xivocc-dcomp stop
    xivocc-dcomp rm
    systemctl stop docker
    rm -rf /var/lib/docker/aufs
    
  5. Reboot the machine

  6. Check if the docker storage driver was changed to overlay2:

    docker info 2> /dev/null | grep "Storage Driver"
    
  7. If overlay2 is not used yet, you must repeat the previous steps to remove (again) the aufs dir

  8. Specifically on a XiVO UC/CC and after the reboot you must pull the images again:

    xivocc-dcomp pull
    xivocc-dcomp up -d
    

Restore

At last you must restore the Kibana configuration.