Upgrade¶
The XiVO Centralized User Management (XCU) upgrade.
Prepare sources list¶
Before upgrading you have to create or change your sources list.
It should be located in the file /etc/apt/sources.list.d/xivo-dist.list
.
Set sources list for upgrade to latest version¶
To upgrade to the latest version the sources list must point towards debian URI and xivo-polaris suite:
deb http://mirror.xivo.solutions/debian/ xivo-polaris main
Set sources list for upgrade to specific version¶
To upgrade to a specific version the sources list must point towards archive URI and xivo-VERSION-latest suite.
For example if you want to upgrade to 2017.11 version you should have:
deb http://mirror.xivo.solutions/archive/ xivo-2017.11-latest main
Note the /archive/
and -2017.11-latest
above.
Upgrade steps¶
Preparing the upgrade¶
Read Release Notes starting from your version to the version you target.
Read Version specific XCU upgrade procedures starting from your version to the version you target.
Upgrade¶
When you have checked the sources.list you can upgrade:
Execute with the following commands:
apt-get update apt-get install gcu-installer
If are using postgresql installed using sources from Postgresql Wiki, upgrading
gcu-installer
may trigger installing new version of PostgreSQL (in parallel to curent one). Suggested action is to disable this new version. If for example GCU use postgresql 9.5 and new version 9.6 was added:- stop postgresql 9.6 manually by:
service postgresql stop 9.6
- disable postgresql 9.6 autostart: in
/etc/postgresql/9.6/main/start.conf
replaceauto
withdisabled
- ensure postgresql 9.5 is running by:
service postgresql start 9.5
- stop postgresql 9.6 manually by:
Download the new images:
docker-compose -p icdu -f /etc/docker/compose/icdu.yml pull
And run the new container (All XCU services will be restarted):
docker-compose -p icdu -f /etc/docker/compose/icdu.yml 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.
Version specific XCU upgrade procedures¶
Upgrade from versions before 2018.04¶
Docker-CE must be installed instead of Docker Engine. Follow these manual steps to upgrade it: Install Docker-CE.
Upgrade from versions before 2017.06¶
If you installed GCU version older than 2017.06, you can upgrade it by following Installation instructions. Further instructions and notices:
- It is strongly recommended you backup your PostgreSQL
icx
database and SSH keys before proceeding. - Installation will install new version of configuration files (like
/etc/docker/compose/icdu.yml
). If some file already exists with different content, you be prompted to choose correctly version or merge differences. Unless you are sure you need special version, use choice: install the package maintainer’s version. - Installation will reuse your SSH certificate stored in
/etc/docker/interface-centralisee/ssh_key
if exists. - Installation will reuse PostgreSQL user
icx
if exists - make sure it has passwordicx
and access to databaseicx
. - Installation will reuse PostgreSQL database
icx
if exists.
Check carefully output of apt-get install gcu-installer
, you will be informed about each component reused and about any
manual checks or actions needed, if necessary.