3. Upgrading the sip:provider PRO

3.1. Preparation
3.2. Upgrade from previous release
3.3. Upgrade from 2.8 LTS

3.1. Preparation

Make sure you’re prepared to spend two hours or so upgrading the system. There will be service interruptions, so also notify the customer and get their approval.

Check the system for locally modified files (move them to appropriate customtt.tt2 files if necessary):

ngcp-status --integrity

Try to find local changes to the template files by issuing:

find /etc/ngcp-config -name \*customtt.tt2

You will also need to find the dpkg-dist files under the templates files because people sometimes forget about creating customtt files and edit tt2 files directly. That makes upgrades not to replace the tt2 files. If so, you need to treat the tt2 files as if they were customtt files and make sure you merge the new templates with the changes of the old ones.

find /etc/ngcp-config -name \*.tt2.dpkg-dist

Also, please check/clean old dpkg backup files (just in case if previous person did the previous step not carefully enough). Normally the list should be empty:

find /etc/ngcp-config -name \*.tt2.dpkg\*

You will have to understand why the changes are there and if they are still needed after the upgrade. You should create a ticket in the bugtracker if there isn’t one yet.

Log into the two servers. Use their real IPs so you can switch the cluster forth and back later on. Make sure the cluster status is ok - on both nodes issue:

monit summary - one should be running all services, the other all but rtpengine, lb, proxy, sbc, mediator and rate-o-mat
cl_status rscstatus - one (with all services running) should print "all", the other "none"
mysql -e "show slave status\G" - look for the following:

Slave_IO_Running: Yes
Slave_SQL_Running: Yes
Seconds_Behind_Master: 0

ngcpcfg status - should print OK three times
ngcp-collective-check - should not report any problems.

A cluster fail-over could be a good idea to see if everything works on the second node too. On the standby node issue:

/usr/share/heartbeat/hb_takeover

Afterwards again check monit, cl_status and ngcp-collective-check.

Create two test subscribers, or retrieve the credentials for two of them. Register a client to the platform and perform a test call between the two to ensure call routing works.

3.2. Upgrade from previous release


	Make sure you have finished with general Section 3.1, “Preparation” before continue.

The sip:provider PRO system upgrade to mr3.8.4 will perform a couple of fundamental tasks:

Update DB schema
Upgrade yml config schema

So assuming you have a running sip:provider PRO system and want to upgrade it, start on the inactive node by upgrading software, then take over from the other node and then upgrade the other (now inactive) node, as detailed in the steps below.

Switch to new repositories

For upgrading the sip:provider PRO to the latest mr3.8.4 release, execute the following commands on both nodes:

NGCP_CURRENT_VERSION=$(cat /etc/ngcp_version)
sed -i "s/$NGCP_CURRENT_VERSION/mr3.8.4/" /etc/apt/sources.list.d/sipwise.list
apt-get update
apt-get install ngcp-upgrade-mr3.8.4-pro

Execute ngcp-upgrade in inactive node.

ngcp-upgrade


	If there is an error during DB schema update, the ngcp-upgrade script will request you to solve it. Once you’ve fixed the problem just re-execute `ngcp-upgrade` again. When all finishes successfully check that replication is running.

Merge/add the custom configuration templates if needed. Apply the changes to configuration templates if any and send them to the shared storage and the other node:
```
ngcpcfg apply
ngcpcfg push --nobuild --noapply
```
Promote inactive node to active.
```
/usr/share/heartbeat/hb_takeover
```

Go to the new inactive node. Run ngcp-upgrade.

ngcp-upgrade

When all finishes successfully check that replication is running. Check monit summary, ngcpcfg status and ngcp-collective-check. Finally, do a basic functionality test. Check web interface, register two test subscribers and perform a test call between the two to ensure call routing works.


	You can find a backup of some important configuration files of your existing installation under /var/backup/ngcp-mr3.8.4- (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-mr3.8.4-/upgrade.log.

3.3. Upgrade from 2.8 LTS


	Make sure you have finished with general Section 3.1, “Preparation” before continue.

The system upgrade from sip:provider PRO 2.8 LTS to mr3.8.4 will perform a couple of fundamental tasks:

Upgrade Debian from 6.0 to 7.0
Update DB schema
Upgrade yml config schema

be sure you are using the latest 2.8 LTS version before upgrading to mr3.8.4 LTS version. mr3.8.4 LTS version uses new repository GPG key which should be installed in 2.8 LTS version before further upgrade to mr3.8.4 LTS version. For upgrading the 2.8 LTS version to the latest 2.8 packages version, execute the following commands as root (on both nodes, using switchover and executing commands on inactive pair):

apt-get update && apt-get upgrade && \
ngcp-update-db-schema && ngcp-update-cfg-schema && \
ngcpcfg apply

So assuming you have a running the latest sip:provider PRO 2.8 LTS system and want to upgrade it, start on the inactive node by upgrading software, then take over from the other node and then upgrade the other (now inactive) node, as detailed in the steps below.

Switch to new repositories

For upgrading the sip:provider PRO from 2.8 LTS to the latest mr3.8.4 release, execute the following commands on both nodes:

NGCP_CURRENT_VERSION=$(cat /etc/ngcp_version)
sed -i "s/$NGCP_CURRENT_VERSION/mr3.8.4/" /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-mr3.8.4-pro

Execute ngcp-upgrade in inactive node.

ngcp-upgrade


	If there is an error during DB schema update, the ngcp-upgrade script will request you to solve it. Once you’ve fixed the problem just re-execute `ngcp-upgrade` again. When all finishes successfully check that replication is running.

Merge/add the custom configuration templates if needed. Apply the changes to configuration templates if any and send them to the shared storage and the other node:
```
ngcpcfg apply
ngcpcfg push --nobuild --noapply
```
Promote inactive node to active.
```
/usr/lib64/heartbeat/hb_takeover
```

Go to the new inactive node. Run ngcp-upgrade.

ngcp-upgrade


	You can find a backup of some important configuration files of your existing 2.8 LTS installation under /var/backup/ngcp-mr3.8.4- (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-mr3.8.4-/upgrade.log.


	mr3.8.4 LTS release has several major changes comparing to previous 2.8 LTS release:

Upgrade Debian from 6.0 to 7.0
sip:provider PRO mr3.8.4 requires at least 2GB of RAM available as the minimum requirements for new WEB interface, otherwise certain features won’t work and you will run into arbitrary issues.
Migrated from SOAP to REST API. SOAP API is disabled by default after upgrade and will be completely removed in mr4.0+
Migrated from Apache to Nginx. Apache and related packages will NOT be deleted during upgrade. However it is highly recommended to migrate customer specific VirtualHosts (if any) from Apache to Nginx and remove Apache and related packages from sip:provider PRO system after upgrade manually. You can use the following command as root (on both nodes):

apt-get purge apache2 apache2.2-common apache2-utils apache2.2-bin && apt-get autoremove