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.

  1. Edit the xivo sources list file /etc/apt/sources.list.d/xivo-dist.list and add the xivo-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
    
  2. Update the packages list:

    apt-get update
    
  3. 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
    
  4. Install the new version (install also asterisk-dbg package if applicable):

    apt-get -t xivo-VERSION-candidate install asterisk
    
  5. 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.

  1. Edit the xivo sources list file /etc/apt/sources.list.d/xivo-dist.list and add the xivo-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
    
  2. Update the sources list:

    apt-get update
    
  3. 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
    
  4. 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'
    
  5. 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.

  1. Change the source lists with xivo-VERSION-latest:

    xivo-dist xivo-2017.03-latest
    
  2. 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
    
  3. And install the version. With the example below (do the same with asterisk-dbg if applicable):

    apt-get install asterisk
    
  4. Restart the services (if you have a XiVO CC, you should restart its services too):

    xivo-service restart