Navigation

The upgrade to XiVO 15.20 or later will take longer than usual, because the whole Debian system will
be upgraded.

The database management system (postgresql) will also be upgraded from version 9.1 to version 9.4 at
the same time. This will upgrade the database used by XiVO. This operation should take at most a
few minutes.

Check that customization to your configuration files is still effective.

During the upgrade, new version of configuration files are going to be installed, and these might
override your local customization. For example, the vim package provides a new /etc/vim/vimrc
file. If you have customized this file, after the upgrade you’ll have both a /etc/vim/vimrc and
/etc/vim/vimrc.dpkg-old file, the former containing the new version of the file shipped by the vim
package while the later is your customized version. You should merge back your customization into
the new file, then delete the .dpkg-old file.

You can see a list of affected files by running find/etc-name'*.dpkg-old'. If some files
shows up that you didn’t modify by yourself, you can ignore them.

Purge removed packages. You can see the list of packages in this state by running dpkg-l|awk'/^rc/{print$2}' and purge all of them with apt-getpurge$(dpkg-l|awk'/^rc/{print$2}')

If you had customizations in one of these files:

/etc/default/asterisk

/etc/default/consul

/etc/default/xivo-ctid

Then you’ll need to review your customizations to make sure they still work with systemd. This is
necessary since these 3 files aren’t read under systemd.

For /etc/default/asterisk, only the CONFD_* options are automatically migrated to
/etc/systemd/system/asterisk.service.d/auto-sysv-migration.conf.

For /etc/default/consul, only the WAIT_FOR_LEADER and CONFIG_DIR options are automatically
migrated to /etc/systemd/system/consul.service.d/auto-sysv-migration.conf.

For /etc/default/xivo-ctid, only the XIVO_CTID_AMI_PROXY option is automatically migrated
to /etc/systemd/system/xivo-ctid.service.d/auto-sysv-migration.conf.

Reboot your system. It is necessary for the upgrade to the Linux kernel and init system
(systemd) to be effective.

Here’s a non-exhaustive list of changes that comes with XiVO on Debian 8:

In Debian 7, the halt command powered off the machine. In Debian 8, the command halts the
system, but does not power off the machine. To halt the machine and turn it off, use the
poweroff or shutdown command.

With the init system switch from SysV to systemd, you should now use the systemctl command to
manage services (i.e. start/stop/status) instead of the service command or
/etc/init.d/<service>, although these two methods should still work fine.

The bootlogd package is not installed by default anymore, since it is not needed with systemd. If
you want to see the boot messages, use the journalctl-b command instead.

The virtual terminals (tty1 to tty6) now shows up earlier during the boot, before all services have
been started.

The way the ami-proxy is configured for xivo-ctid has changed. If your XiVO
was using the ami-proxy, the configuration will be automatically upgraded.

Customization to asterisk and consul startup is now done by customizing the systemd unit file (by
creating a drop-in file for example) instead of editing the /etc/default/asterisk and
/etc/default/consul files. These files are not used anymore.

If your system is using a swap partition or file and is using more memory than it can fit in
the RAM, then system power-off or reboot might hangs indefinitely. This is due to a limitation in
the current systemd version.

If you find yourself in this case, you should try allocating more RAM to your system. Otherwise,
you can try stopping the xivo services using wazo-servicestop before rebooting to lessen the
likelihood of this problem.