Upgrade Aldebaran to Borealis

In this section is listed the manual steps to do when migrating from Aldebaran to Borealis.


For XiVO PBX Debian was upgraded to Debian 9 (stretch). Therefore:

  • the upgrade to Borealis will take longer than usual

  • upgrade from older version than XiVO 15.20 are not supported.

Please read carefully Debian 9 (stetch) upgrade notes page.


Known Upgrade Limitations: as of Borealis release these are the known limitations for upgrade. These should be removed during the next bugfix releases of Borealis.

  • XiVO PBX / UC / CC is not installable or upgradable on XFS partition created without ftype=1 option. If the partition is XFS, you MUST check if the option is enabled with the xfs_info command.

  • Upgrade for XiVO CC to Debian 9 is currently not supported.

Before Upgrade


If you have a XiVO CC or XiVO UC you MUST follow this upgrade order:

  1. Stop XiVO CC / UC services,

  2. Upgrade XiVO PBX

  3. Upgrade XiVO CC / UC: during the upgrade it will again restart the XiVO PBX services (to install the db_replic container)


  • Debian system will be upgraded to Debian 9 (stretch)


    Please read carefully the Before the upgrade section in the Debian 9 (stretch) upgrade notes.

  • UC Add-on: during upgrade, UC database (pgxivocc container) will be removed.


    Thus all call history (in UC Assistant) will be lost.

    The history will be computed again starting from the last call processed before the upgrade. If you want to recompute all the calls present in the XiVO PBX database you must follow a manual procedure which is not described here.


  • Before launching upgrade, you MUST verify that replication (of tables cel, queue_log, callback_request and qualification_answers) was completed. You can use these SQL commands to compare asterisk and xivo_stats databases:

    select * from cel order by eventtime desc limit 1;
    select * from queue_log order by time desc limit 1;
    select * from callback_request order by reference_number desc limit 1;
    select * from qualification_answers order by time desc limit 1;

After Upgrade


  • Debian system will be upgraded to Debian 9 (stretch)


    Please read carefully the After the upgrade section in the Debian 9 (stretch) upgrade notes.

  • Recording: recording for queues was entirely modified

    • The xivocc-recording package will be automatically installed or upgraded with XiVO if you don’t have xivo-gateway-recording installed (to record on external server). These two packages are conflicting because they use the same dialplan subroutine names. If you are using gateway recording and your XiVO is capable to record internally, you should replace the old package by running apt-get install xivocc-recording. Then follow the Recording page. These features are available only with xivocc-recording:

      Gateway recording was also removed from documentation and it is not available in XiVO repository.

    • If you are upgrading from older version than 2017.03.02 with recording installed, you must follow the XiVOCC Recording upgrade procedure.

    • In the file /etc/asterisk/extensions_extra.d/xivocc-recording.conf the ipbx_name was reset to its default value. You need to set it back to its previous value.

    • You MUST edit the queues configuration and (1) remove the subroutine used to start the recording, (2) and replace them by the correct configuration in the queue (see Recording).

  • Callbacks: callback API URL was changed. It is now prefixed with configmgt. If you have any AGI calling the callbacks API (for example api/1.0/callback_lists) you MUST add the prefix configmgt to it : configmgt/api/1.0/callback_lists.

  • HTTPS certificate: it is required to have subjectAltName defined in the HTTPS certificate. If you use the default HTTPS certificate, you must regenerate it. See Default Backend Certificate.

  • APT keyring lookup hashtable troubleshooting: this error can appear at the end of the upgrade before starting xivo services:

    gpg: lookup_hashtable failed: Unknown system error
    gpg: trustdb: searching trust record failed: Unknown system error
    gpg: Error: The trustdb is corrupted.
    gpg: You may try to re-create the trustdb using the commands:
    gpg:   cd ~/.gnupg
    gpg:   gpg --export-ownertrust > otrust.tmp
    gpg:   rm trustdb.gpg
    gpg:   gpg --import-ownertrust < otrust.tmp

    If this error appears, follow the printed procedure to recreate the lookup hashtable.


Nothing specific, follow the Upgrade page.