Upgrade Callisto to Deneb¶
In this section is listed the manual steps to do when migrating from Callisto to Deneb.
Contents
Before Upgrade¶
On XiVO PBX¶
Warning
In this release the XiVO Reporting was removed from the solution. The only supported Reporting solution is the XiVO CC Reporting.
XiVO Reporting was removed, including:
the menu
in the Web Interfacethe statistics generation (the xivo-stat script)
Note that the computed stats were not removed from the database. If you need, you can backup the following tables:
stat_call_on_queue
stat_queue_periodic
stat_agent
stat_queue
On XiVOCC¶
Warning
You MUST upgrade to
docker-ce
with the manual procedure below.Postgres database data will be moved outside the docker volume to the host.
When installing the new
xivocc-installer
package the XiVOCC services will be stopped.Totem panels will be lost during upgrade. Please check ELK 7 Upgrade Notes page.
Postgres: database data will be moved from the docker volume to the host in
/var/lib/postgresql/data
. This data migration will be almost instantaneous if the volume data is in the same partition. To check if the volume data is on the same partition as the host destination/var/lib/postgresql/data
:Retrieve the pgxivocc volume data dir:
docker inspect xivocc_pgxivocc_1 -f '{{range .Mounts}}{{if (eq .Destination "/var/lib/postgresql/data")}}{{.Source}}{{end}}{{end}}'
Then check if it in the same partition as
/var/lib/postgresql/data
dir.
Docker: you MUST upgrade to
docker-ce
before upgradingxivocc-installer
.Check if you have docker-engine installed:
dpkg -l |grep '^ii' |grep docker-engine -q && echo -e "\n\tDocker is installed via docker-engine.\n\tYou MUST upgrade it, BEFORE updating xivocc-installer.\n"
If docker-engine is installed, you must upgrade to
docker-ce
before updating xivocc-installer: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
Install
xivo-dist
:
# Update APT sources apt-get update # Install xivo-dist (to prepare docker installation) apt-get install xivo-dist # Fix docker sources list if needed [ $(lsb_release -cs) == "jessie" ] && echo "deb https://download.docker.com/linux/debian $(lsb_release -cs) stable" > /etc/apt/sources.list.d/docker.list apt-get update
Install
docker-ce
:
Warning
if you are upgrading from Aldebaran or lower, this step will trigger the upgrade of
xivocc-installer
package. You MUST NOT do it if the XiVO IPBX upgrade is not finished - as stated in Aldebaran to Boréalis Upgrade notes in Manual steps for LTS upgrade.apt-get install docker-ce
Then, you can follow the normal Upgrade process.
Totem panels: during upgrade the ELK stack will be upgraded.
Old Elasticsearch/Kibana containers will be removed.
Previous data/dashboard won’t be upgraded to new version. Therefore they are saved in a folder
/var/local/elasticsearch-1.7
.Be sure to have enough disk space in this folder partition. You should need at most 1GB of free disk space. The upgrade script checks the real required space and stops if the space is not available.
See also ELK 7 Upgrade Notes page.
After Upgrade¶
On XiVO PBX¶
WebRTC accounts: lines created with webrtc option set to something else than
yes
will be set toyes
. Previously, whatever the value of the webrtc option, the line was created with the appropriate WebRTC option. To see which lines were changed, check the migration output in postgresql logs:zgrep "MIGRATE_WEBRTC" /var/log/postgresql/postgresql-11-main.log*
On XiVOCC¶
Totem panels: during upgrade the ELK stack was upgraded.
You MUST import the Kibana configuration and demo dashboard in the new Kibana - see Import Default Configuration and Demo Dashboards
Old data/dashboard were saved in folder
/var/local/elasticsearch-1.7
.If you had custom Dashboard/Totem panel you must follow the procedure described in ELK 7 Upgrade Notes