Upgrading PortSIP PBX to New Versions

This guide is for upgrading your current PortSIP PBX v16.x installation to the latest version. Please follow the steps below to upgrade.
Please ensure that your current PortSIP PBX installation is version 16. x.

Upgrading SBC

If you upgraded the PBX to v16.1.0, then you must also upgrade the SBC to v10.0.6, and update the PBX access token as the guide.
Please follow this article to upgrade the PortSIP SBC.

Upgrading PBX

1 Upgrading for Windows

  1. 1.
    We suggest backing up your PBX data. The data file path is usually c:\programdata\portsip.
  2. 2.
    Download the latest installer from the PortSIP website.
  3. 3.
    Double-click the installer to install it and the upgrade will be performed automatically.

2 Upgrading for Linux

We recommend backing up your PBX data. The data file path is usually /var/lib/portsip. You can also back up the entire VM server or take a snapshot of the VM server.
All commands must be executed in the /opt/portsip directory.

2.1 Stop PBX Docker Instance

Perform the following commands as root to stop the current PBX Docker instance:
cd /opt/portsip && /bin/sh pbx_ctl.sh stop

2.2 Delete the PBX Docker Instance

Perform the following command to delete the PBX Docker instance:
/bin/sh pbx_ctl.sh rm

2.3 List the PBX Docker Images

Perform the following command to list the PBX Docker images:
docker image list
You will get the result shown in the below screenshot.

2.4 Delete the PBX Docker Images

You can use the following command to delete Docker images using the first 4 digits of the IMAGE ID for PBX and Postgresql.
docker image rm 03b8 d569

2.5 Delete the PBX Scripts

rm install_pbx_docker.sh
rm install_docker.sh
rm pbx_ctl.sh

2.6 Download the Latest Installation Scripts

curl https://raw.githubusercontent.com/portsip/portsip-pbx-sh/master/v16.x/new/install_docker.sh \
-o install_docker.sh
curl https://raw.githubusercontent.com/portsip/portsip-pbx-sh/master/v16.x/new/pbx_ctl.sh \
-o pbx_ctl.sh

2.7 Setup the Docker Environment

Execute the below command to install the Docker-Compose environment. If you get the prompt likes*** cloud.cfg (Y/I/N/O/D/Z) [default=N] ?, enter the Y and then press the Enter button.
/bin/sh install_docker.sh

2.8 Create and Run the PortSIP PBX Docker Container Instance

The below command is used to create and run the PBX on a server whose IP is66.175.221.120. If running the PBX in a LAN without the public IP, just replace the IP with the PBX server's LAN private IP.
/bin/sh pbx_ctl.sh \
run -p /var/lib/portsip \
-a \
-i portsip/pbx:16
Your PBX has now been successfully upgraded to the latest version.