XiVO UC/CC Debian 9 (Stretch) Upgrade Procedure¶
This page describes what to do to upgrade your XiVO UC/CC to Debian 9 (Stretch).
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.
In Debian 9 (Stretch) docker storage driver changed from
Therefore all containers and images need to be recreated.
overlay2 is incompatible with XFS partition created without
If the partition is XFS, you MUST check if the option is enabled with the
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
apt-get install xfsprogs xfs_info /var/lib/ 2> /dev/null | grep ftype
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.
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.
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:
Updating the host to latest Debian 8 (Jessie) version
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
Launch the Debian 8 to Debian 9 upgrade
Specifically on a XiVO UC/CC and before rebooting you MUST remove the
aufsdir. 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
Reboot the machine
Check if the docker storage driver was changed to overlay2:
docker info 2> /dev/null | grep "Storage Driver"
If overlay2 is not used yet, you must repeat the previous steps to remove (again) the aufs dir
Specifically on a XiVO UC/CC and after the reboot you must pull the images again:
xivocc-dcomp pull xivocc-dcomp up -d