3. Upgrading from previous versions

3.1. Upgrade from v2.8 to v3.0

3.1. Upgrade from v2.8 to v3.0

The system upgrade from sip:provider CE v2.8 to 3.0 will perform a couple of tasks:

  1. Upgrade Debian from 6.0 to 7.0.
  2. Upgrade NGCP software packages
  3. Upgrade NGCP configuration templates
  4. Upgrade base system within Debian (v7) to latest package versions

For upgrading the sip:provider CE from v2.8 to the latest 3.0 release, execute the following commands:

sed -i 's/2.8/3.0/' /etc/apt/sources.list.d/sipwise.list
sed -i '/squeeze-lts/d'     /etc/apt/sources.list.d/sipwise.list
sed -i 's/squeeze/wheezy/g' /etc/apt/sources.list.d/sipwise.list
apt-get update
apt-get install ngcp-upgrade-3.0-ce

Run the upgrade script as root like this:

ngcp-upgrade

The upgrade script will ask you to confirm that you want to start. Read the given information carefully, and if you agree, proceed with y.

The upgrade process will take several minutes, depending on your network connection and server performance. After everything has been updated successfully, it will finally ask you to reboot your system. Confirm to let the system reboot (it will boot with an updated kernel).

Once up again, double-check your config file /etc/ngcp-config/config.yml (sections will be rearranged now and will contain more parameters) and your domain/subscriber/peer configuration and test the setup. You can find a backup of some important configuration files of your existing 2.8 installation under /var/backup/ngcp-3.0-* (where * is a place holder for a timestamp) in case you need to roll back something at any time. A log file of the upgrade procedure is available at /var/backup/ngcp-3.0-*/upgrade.log.

[Warning]

sip:provider CE v3.0 uses significantly more RAM than previous versions. Make sure to have at least 2GB of RAM on the system as stated in the minimum requirements of the installation section, otherwise certain features won’t work and you will run into arbitrary issues.