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.
If you installed the PortSIP SBC, please follow this article to upgrade the PortSIP SBC.
Upgrading PBX for Windows
We suggest backing up your PBX data. The data file path is usually
c:\programdata\portsip
. You can follow the article Backup and Restore: An Essential Guide.Download the latest installer from the PortSIP website.
Double-click the installer to install it and the upgrade will be performed automatically.
Upgrading PBX 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.
Please follow the article Backup and Restore: An Essential Guide.
All commands must be executed in the /opt/portsip
directory.
Step 1 Stop PBX Docker Instance
Perform the following commands as root to stop the current PBX Docker instance:
You must use the su - rather than su root
Step 2 Delete the PBX Docker Instance
Perform the following command to delete the PBX Docker instance:
Step 3 List the PBX Docker Images
Perform the following command to list the PBX Docker images:
You will get a similar result shown in the below screenshot.
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
, in this case, is 03b8
and d569
.
Step 4 Delete the PBX Scripts
Step 5 Download the Latest Installation Scripts
Step 6 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.
Step 7 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, replace the IP 66.175.221.120
with the PBX server's LAN private IP.
Please replace the IP address 66.175.221.120 in the command below with your own PBX server’s IP address.
Please be patient during this step, especially if your PBX contains a large amount of data. Do not cancel the process.
Your PBX has now been successfully upgraded to the latest version.
Upgrading Cluster Servers
It’s crucial to keep your cluster servers updated in line with the latest PortSIP PBX releases. This ensures that all features function as expected and that your system maintains optimal performance and security.
If you have set up your PBX as a cluster following this guide, it’s mandatory to upgrade those servers whenever the PBX is updated. Please refer to the article Managing Cluster for the upgrade process.
Last updated