Upgrading a XiVO CC is done by executing commands through a terminal on the server.
Downgrade is not supported
The upgrade consists of the following steps:
- switch/verify the version in the debian sources list
- update of the
- update of the Docker images
This upgrade procedure applies only to XiVO CC installed via the
Preparing the upgrade¶
There are two cases:
- Upgrade to another LTS XiVO CC version,
- Upgrade to the latest Bugfix release of your current installed LTS version.
Upgrade to another LTS version¶
To upgrade to another XiVO Solution LTS:
Switch the debian sources to the targetted LTS version (it should be located in the file
/etc/apt/sources.list.d/xivo-dist.list). For example, to switch to Deneb LTS version:
deb http://mirror.xivo.solutions/debian/ xivo-deneb main
Read carefully the Release Notes starting from your current version to the version you target (read even more carefully the New features and Behavior changes between LTS)
Check the specific instructions and manual steps from your current LTS to your targetted LTS and all intermediate LTS: see Manual steps for LTS upgrade
Check also if you are in a specific setup that requires a specific procedure
And then upgrade, see Upgrading
Upgrade to latest Bugfix release of an LTS version¶
For version older than Five (2017.03), see XiVO Five documentation
After the release of a version (e.g. Polaris (2017.11)) we may backport some bugfixes in this version. We will then create a subversion (e.g. Polaris .04 (2017.11 .04)) shipping these bugfixes. These bugfix version does not contain any behavior change.
To upgrade to the latest subversion of your current installed version you need to:
- Read carefully the Release Notes starting from your installed version (e.g. Polaris.00) to the latest bugfix release (e.g. Polaris.04).
- Verify that the debian sources list corresponds to your installed LTS (it should be located in the file
- Verify that the
VERSIONis your current installed version - e.g. 2017.11)
- And then upgrade, see Upgrading
After having prepared your upgrade (see above), you can upgrade:
When you have checked the sources.list you can upgrade with the following commands:
apt-get update apt-get install xivo-dist apt-get update # needed only if you are also upgrading Debian apt-get install xivocc-installer xivo-chat-backend
If there is any change, you should accept the new
docker-compose.ymlfile. Then compare it with the old
docker-compose.yml.dpkg-oldfile and report in the new any specific configuration.
Then download the new docker images:
And run the new containers (Corresponding XiVO CC services will be restarted):
xivocc-dcomp up -d --remove-orphans
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.