Upgrading dSIPRouter

Auto Upgrade Feature

The dSIPRouter auto upgrade feature was released in 0.72 but was not feature complete until 0.73. It allows you to upgrade dSIPRouter from the User Interface (UI) and the command line (CLI). If you are upgrading from 0.70, 0.72, or 0.721 you can boostrap to the latest release to get the auto-upgrade feature.

Upgrading to 0.73 doesn’t require a dSIPRouter Core Subscription license because the auto-upgrade framework was not yet feature complete. However, future releases of dSIPRouter will require a Core Subscription License to use the auto-upgrade feature. A core license can be purchased from the dSIPRouter Marketplace.

_images/upgrade_up_to_date.png

Upgrade 0.72x to 0.73

Upgrading to 0.73 can be done from 0.72 or 0.721 by doing the following

  1. SSH to your dSIPRouter Instance

  2. Run the following command

curl -s https://raw.githubusercontent.com/dOpensource/dsiprouter/v0.73/resources/upgrade/v0.73/scripts/bootstrap.sh | bash
  1. Login to the dSIPRouter UI to validate that the upgrade was successful.

Note, if you are upgrading from a debian 9 system you must first upgrade OS versions to a supported version. See the debian upgrade documentation for more information.

Note, if the upgrade fails you can purchase a dSIPRouter Core Subscription from the dSIPRouter Marketplace. This will provide you with support hours so that we can help with the upgrade.

Upgrade 0.70 to 0.721

You can upgrade from 0.70 by doing the following

  1. SSH to your dSIPRouter Instance

  2. Run the following command

curl -s https://raw.githubusercontent.com/dOpensource/dsiprouter/v0.721/resources/upgrade/v0.721/scripts/bootstrap.sh | bash
  1. Login to the dSIPRouter UI to validate that the upgrade was successful.

Note, if the upgrade fails you can purchase a dSIPRouter Core Subscription which can be purchased from the dSIPRouter Marketplace. This will provide you with support hours so that we can help with the upgrade.

Upgrade 0.70 to 0.72

This upgrade path is deprecated. Upgrade to the 0.721 release instead.

Upgrade 0.644 to 0.70

There is no automated upgrade available from 0.644 to 0.70. Support is available via a dSIPRouter Core Subscription which can be purchased from the dSIPRouter Marketplace.This will provide you with support hours so that we can help with the upgrade.

Upgrade 0.621 to 0.63

In this section we will show you how to upgrade from 0.621 to 0.63. This is the first release to contain our new upgrade approach.

The following steps will upgrade your Kamailio configuration from 0.621 to 0.63.

cd /opt/dsiprouter
git stash
git checkout v0.63
dsiprouter upgrade -rel 0.63

You should now be able to login to dSIPRouter and see that the new release has been applied.

Upgrade 0.522 to 0.523

In this section we will show you how to upgrade from 0.522 to 0.523.

Before starting the upgrade process you will need to backup your kamailio database using the following command:

cd /opt/
mysqldump kamailio > kamailio-bk.sql

After you’ve backed up your database you can now uninstall dsiprouter v0.50 by running the following commands:

cd /opt/dsiprouter
./dsiprouter.sh uninstall

Once the uninstall is complete you will need to either move or delete the /dsiprouter directory using the following command.

mv /dsiprouter /usr/local/src (moving directory)

Alternatively:

rm -r /dsiprouter (removing directory)

Installing dsiprouter v0.523

cd /opt/
apt-get update
apt-get install -y git curl
cd /opt
git clone -b v0.523 https://github.com/dOpensource/dsiprouter.git
cd dsiprouter
./dsiprouter.sh install

Note: please take note of the credentials given after the script has completed.

After the install is completed you can now restore your kamailio database using the following command:

cd /opt/
mysql  kamailio < kamailio-bk.sql
mysql kamailio -e "alter table dsip_multidomain_mapping add column domain_list_hash varchar(255) after domain_list;"

Now please restart dsiprouter using the following commands:

cd /opt/disprouter/
./dsiprouter.sh restart

After the install is complete and the dsiprouter service has been restarted, the login screen should now reflect v0.51 and you should be able to login with the dsiprouter credentials provided after the install completed.

_images/dsip_v51.png

Upgrade 0.50 to 0.51

In this section we will show you how to upgrade from 0.50 to 0.51.

Before starting the upgrade process you will need to backup your kamailio database using the following command:

cd /opt/
mysqldump kamailio > kamailio-bk.sql

After you’ve backed up your database you can now uninstall dsiprouter v0.50 by running the following commands:

cd /opt/dsiprouter
./dsiprouter.sh uninstall

Once the uninstall is complete you will need to either move or delete the /dsiprouter directory using the following command.

mv /dsiprouter /usr/local/src (moving directory)

Alternatively:

rm -r /dsiprouter (removing directory)

Installing dsiprouter v0.51

cd /opt/
apt-get update
apt-get install -y git curl
cd /opt
git clone -b v0.51 https://github.com/dOpensource/dsiprouter.git
cd dsiprouter
./dsiprouter.sh install

Note: please take note of the credentials given after the script has completed.

After the install is completed you can now restore your kamailio database using the following command:

cd /opt/
mysql  kamailio < kamailio-bk.sql

After the kamailio database is restored you need to restart dsiprouter using the following commands:

cd /opt/disprouter/
./dsiprouter.sh restart

After the install is complete and the dsiprouter service has been restarted, the login screen should now reflect v0.51 and you should be able to login with the dsiprouter credentials provided after the install completed.

_images/dsip_v51.png