Asterisk upgrade procedure¶
Introduction¶
There are three distributions available for each release (since release 2017.03).
For XiVO archive repositories
deb http://mirror.xivo.solutions/archive/ xivo-VERSION-latest main
deb http://mirror.xivo.solutions/archive/ xivo-VERSION-candidate main
deb http://mirror.xivo.solutions/archive/ xivo-VERSION-oldstable main
Alike for XiVO production repositories
deb http://mirror.xivo.solutions/debian/ xivo-five main
deb http://mirror.xivo.solutions/debian/ xivo-five-candidate main
deb http://mirror.xivo.solutions/debian/ xivo-five-oldstable main
The distribution latest contains the current stable version of XiVO PBX and Asterisk.
The distribution candidate contains only Asterisk in higher version than the current.
The distribution oldstable contains only Asterisk in the previous stable version.
Example¶
Repository |
Distribution |
Section |
Content |
---|---|---|---|
mirror.xivo.solutions/archive |
xivo-2017.03-candidate |
main |
latest-built-and-tested-version (e.g. asterisk-13.14.0) |
mirror.xivo.solutions/archive |
xivo-2017.03-latest |
main |
most-stable-known-version (e.g. asterisk-13.13.1) |
mirror.xivo.solutions/archive |
xivo-2017.03-previous |
main |
old-most-stable-known-version (e.g. asterisk-13.10.0) |
Upgrade to asterisk candidate¶
Before integrating a new version of asterisk in XiVO PBX, we first build it and deliver it in the xivo-VERSION-candidate
distribution of our
repository.
The goal is to make it available for specific cases (e.g. urgent bugfixes) before shipping it as the default version. This page explains how to upgrade/downgrade to/from this candidate version.
Warning
This is a specific procedure. You should know what you are doing.
Upgrade to candidate version¶
Warning
This will upgrade your asterisk version and trigger a restart of asterisk. You should know what you are doing.
Edit the xivo sources list file
/etc/apt/sources.list.d/xivo-dist.list
and add thexivo-VERSION-candidate
distribution (see last line entry below):# xivo-2017.03-latest deb http://mirror.xivo.solutions/archive/ xivo-VERSION-latest main # deb-src http://mirror.xivo.solutions/archive/ xivo-VERSION-latest main deb http://mirror.xivo.solutions/archive/ xivo-VERSION-candidate main
Update the packages list:
apt-get update
Check the proposed versions with
apt-cache policy asterisk
. For example it will give you the following result:# apt-cache policy asterisk asterisk: Installed: 8:13.13.1-1~xivo9+13.13.1+20170105.165406.d2ff9a5 Candidate: 8:13.13.1-1~xivo9+13.13.1+20170105.165406.d2ff9a5 Version table: 8:13.14.0-1~xivo9+13.13.1+20170105.165406.d2ff9a5 0 100 http://mirror.xivo.solutions/archive/ xivo-2017.03-candidate/main amd64 Packages *** 8:13.13.1-1~xivo9+20170321.182632.9ad94c7 0 500 http://mirror.xivo.solutions/archive/ xivo-2017.03-latest/main amd64 Packages
Install the new version (install also
asterisk-dbg
package if applicable):apt-get -t xivo-VERSION-candidate install asterisk
Restart the services (if you have a XiVO CC, you should restart its services too):
xivo-service restart
Note: The priority will prevent installing asterisk from xivo-VERSION-candidate
whenever running apt-get upgrade or xivo-upgrade.
Downgrade to oldstable version¶
Warning
This will downgrade your asterisk version and trigger a restart of asterisk. You should know what you are doing.
Edit the xivo sources list file
/etc/apt/sources.list.d/xivo-dist.list
and add thexivo-VERSION-oldstable
distribution (see last line entry below):# xivo-2017.03-latest deb http://mirror.xivo.solutions/archive/ xivo-2017.03-latest main # deb-src http://mirror.xivo.solutions/archive/ xivo-2017.03-latest main deb http://mirror.xivo.solutions/archive/ xivo-2017.03-oldstable main
Update the sources list:
apt-get update
Check the proposed versions with
apt-cache policy asterisk
. For example it will give you the following result:# apt-cache policy asterisk asterisk: Installed: 8:13.13.1-1~xivo9+20170321.130355.9ad94c7 Candidate: 8:13.13.1-1~xivo9+20170321.130355.9ad94c7 Version table: *** 8:13.13.1-1~xivo9+20170321.130355.9ad94c7 1 100 http://mirror.xivo.solutions/archive/ xivo-2017.03-latest/main amd64 Packages 8:13.10.0-1~xivo9+2017.01+master+20170208.085934.3b143b7 0 1 http://mirror.xivo.solutions/archive/ xivo-2017.03-oldstable/main amd64 Packages
And downgrade the version by giving the version in the oldstable distribution of the repository. With the example below (do the same with
asterisk-dbg
if applicable):apt-get install asterisk='8:13.10.0-1~xivo9+2017.01+master+20170208.085934.3b143b7'
Restart the services (if you have a XiVO CC, you should restart its services too):
xivo-service restart
Return to the current version¶
Warning
This will return your asterisk version to the current most stable version and trigger a restart of asterisk. You should know what you are doing.
Change the source lists with
xivo-VERSION-latest
:xivo-dist xivo-2017.03-latest
Check the proposed versions with
apt-cache policy asterisk
. For example it will give you the following result:# apt-cache policy asterisk asterisk: Installed: 8:13.10.0-1~xivo9+2017.02+master+20170301.144142.3b143b7 Candidate: 8:13.13.1-1~xivo9+20170321.182632.9ad94c7 Version table: 8:13.13.1-1~xivo9+20170321.182632.9ad94c7 0 500 http://mirror.xivo.solutions/archive/ xivo-2017.03-latest/main amd64 Packages *** 8:13.10.0-1~xivo9+2017.02+master+20170301.144142.3b143b7 0 100 /var/lib/dpkg/status
And install the version. With the example below (do the same with
asterisk-dbg
if applicable):apt-get install asterisk
Restart the services (if you have a XiVO CC, you should restart its services too):
xivo-service restart