Upgrade Callisto to Deneb¶
In this section is listed the manual steps to do when migrating from Callisto to Deneb.
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 Interface
- the 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:- Install
xivo-dist
:
# Update XiVO sources list echo "deb http://mirror.xivo.solutions/debian xivo-deneb main" > /etc/apt/sources.list.d/xivo-dist.list 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
- Install
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