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.
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
The following applies to XiVO PBX >= 2016.03. For older version, see Version-specific upgrade procedures section.
There are two cases:
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:
(latest) XiVO Polaris (2017.11) - released 2017/10/09:
(old) XiVO Five (2017.03) - released 2017/04/03: see XiVO Five documentation.
Upgrade to an Intermediate version¶
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:
Preparing the upgrade¶
To prepare the upgrade you should:
- Read carefully the Release Notes starting from your current version to the version you target.
- Check if you are in a specific setup that requires a specific procedure to be followed (e.g. Upgrading a cluster).
- 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.
For custom setups, follow the required procedures described below (e.g. Upgrading a cluster).
When ready, launch the upgrade process. All XiVO PBX services will be stopped during the process:
When finished, check that all services are running (the list is displayed at the end of the upgrade).
Check that services are correctly working like SIP registration, ISDN link status, internal/incoming/outgoing calls, XiVO Client connections etc.
Version-specific upgrade procedures¶
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