Upgrading High Availability Installation
Before upgrading the PBX HA, please consult with PortSIP support to ensure the versions are compatible.
Please follow the below steps to upgrade your current PBX HA.
Back up data
Before upgrading, please back up the PBX data.
Stop the PBX service
Perform the below command only on the pbx01.
Check the current master node
Perform the below command only on the pbx01.
For example, the below output indicates the current master node is pbx01.
![](https://support.portsip.com/~gitbook/image?url=https%3A%2F%2F846155343-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MfkamWLaD5pcQwlKWwC%252Fuploads%252FWw6fuM7DAaGNsQjAq7MZ%252Fubuntu-ha-27.png%3Falt%3Dmedia%26token%3Dcaf70eba-802e-41d6-93f6-7e8a74f71798&width=768&dpr=4&quality=100&sign=849fd0ae&sv=2)
Back up data
Log in to the current master node, and back up the PBX data directory: /var/lib/portsip
.
Upgrading PortSIP PBX HA v16.x to v22.x
If you are currently running PortSIP PBX v16.x with High Availability (HA), follow these steps to upgrade to the latest version, v22.x.
Ensure you have backed up the current PBX data directory (/var/lib/portsip
) as outlined in the backup steps.
1. Install the New PortSIP PBX v22.x HA
Since PortSIP PBX v22.x HA only supports Ubuntu 24.04, you must rebuild the three PBX node servers. Choose one of the following methods:
Method 1: Prepare three new servers running Ubuntu 24.04. These servers must have the same specifications, IP addresses, and hostnames as the current three servers running v16.x. Install PortSIP PBX v22.x HA following the steps outlined in the High Availability Installation on Ubuntu guide.
Method 2: Destroy and then completely rebuild the current three servers running Ubuntu 20.04 by reinstalling them with Ubuntu 24.04. Then, install PortSIP PBX v22.x HA following the High Availability Installation on Ubuntu guide.
Choose the method that best suits your requirements to install the new PortSIP PBX v22.x HA.
2. Stop the PBX v22.x HA
To proceed with the upgrade, stop the PBX service on the v22.x HA environment. Perform the following steps only on pbx01:
Stop the HA services:
Verify the current master node:
3. Migrate Data
Log in to the current master node of your PortSIP PBX v16.x HA environment.
Copy the backup data from the v16.x environment to the data directory of the v22.x installation (
/var/lib/portsip
).
4. Start PortSIP PBX v22.x HA
Start the upgraded PBX system by running the following command:
The PortSIP PBX application will automatically upgrade the data during the startup process.
Upgrading PortSIP PBX v22.x HA to the Latest Version
If you currently running the PortSIP PBX v22.x HA, please follow the below steps to upgrade it to the latest version.
1. Download and update resources
Perform the below command only on the pbx01.
2. Update
Use the new version image of PortSIP PBX to update the PBX.
Please contact PortSIP support to obtain the <PortSIP PBX new version image> before upgrading.
Perform the below command only on the pbx01.
For example:
Last updated
Was this helpful?