Upgrading

Upgrading a XiVO PBX is done by executing commands through a terminal on the server. You can connect to the server either through SSH or with a physical console.

Overview

To upgrade your XiVO PBX, you have to use both xivo-dist and xivo-upgrade tools. These tools handle the process of upgrading:

• the system (Debian packages)
• and the XiVO PBX packages

Warning

The following applies to XiVO PBX >= 2016.03. For older version, see Version-specific upgrade procedures section.

There are two cases:

1. Upgrade to an LTS version of XiVO PBX,
2. Upgrade to an Intermediate version of XiVO PBX,

Warning

Note that it is not possible to downgrade to any version.

Upgrade to an LTS version

To upgrade to a XiVO PBX LTS version you have to update the sources list by using the xivo-dist command:

xivo-dist <XiVO LTS VERSION>

Currently there are two XiVO PBX LTS versions:

1. (latest) XiVO Polaris (2017.11) - released 2017/10/09:

   xivo-dist xivo-polaris
   

2. (old) XiVO Five (2017.03) - released 2017/04/03: see XiVO Five documentation.

Upgrade to an Intermediate version

Note

Intermediate versions have a limited support. You should install LTS version only.

Between XiVO PBX LTS versions we release Intermediate versions (to which is given a limited support). To upgrade to a specific Intermediate version, you have to update the sources to point to this specific version. You have to do it with the xivo-dist command. For example, if you want to upgrade to 2017.06:

xivo-dist xivo-2017.06-latest

Preparing the upgrade

To prepare the upgrade you should:

1. Read carefully the Release Notes starting from your current version to the version you target.
2. Check if you are in a specific setup that requires a specific procedure to be followed (e.g. Upgrading a cluster).
3. Finally, you can download the packages beforehand by running xivo-upgrade -d. This is not mandatory, but it does not require stopping any service, so it may be useful to reduce the downtime of the server while upgrading.

Upgrade

Note

About xivo-upgrade script see:

• xivo-upgrade script
  • Usage
  • Troubleshooting

1. For custom setups, follow the required procedures described below (e.g. Upgrading a cluster).

2. When ready, launch the upgrade process. All XiVO PBX services will be stopped during the process:

   xivo-upgrade
   

3. When finished, check that all services are running (the list is displayed at the end of the upgrade).

4. Check that services are correctly working like SIP registration, ISDN link status, internal/incoming/outgoing calls, XiVO Client connections etc.

Specific procedures

• Upgrading a cluster
• Migrate XiVO from i386 (32 bits) to amd64 (64 bits)
• Asterisk upgrade procedure
• XiVOCC Recording upgrade procedure

Version-specific upgrade procedures

Note

If your XiVO PBX is below 2016.03 you have first to Switch to xivo.solutions mirrors.

• Switch to xivo.solutions
• Other Version Specific Procedures
  • Upgrading from XiVO 14.11 and before
  • Upgrading from XiVO 14.01, 14.02, 14.03, 14.04 installed from the ISO
  • Upgrading from XiVO 13.24 and before
  • Upgrading from XiVO 13.03 and before
  • Upgrading from XiVO 12.13 and before
  • Upgrading from XiVO 1.2.1 and before

Upgrading to/from an archive version

• Upgrade involving archive version of XiVO

Upgrade Notes

See Release Notes for version specific informations.

Archives

See Archived Upgrade Notes for old release notes information.