Managing Cluster

After successfully setup the PortSIP PBX cluster, you can manage it in an easy way.

Managing Servers

On each cluster server (not the PBX server), you can use the following commands to manage it.

In the commands, use the parameter -s to specify the service name, PortSIP PBX supports these services:

  • media-server-only

  • queue-server-only

  • meeting-server-only

  • vr-server-only

Start Server

cd /opt/portsip
/bin/sh cluster_ctl.sh start -s media-server-only

You can replace the media-server-only with another service name such as mentioned above.

Restart Server

cd /opt/portsip
/bin/sh cluster_ctl.sh restart -s media-server-only

Check Status

cd /opt/portsip
/bin/sh cluster_ctl.sh status -s media-server-only

Stop Server

cd /opt/portsip
/bin/sh cluster_ctl.sh stop -s media-server-only

Remove Server

cd /opt/portsip
/bin/sh cluster_ctl.sh rm -s media-server-only

Adding Servers

As the scale of your business expands, you may need to add more servers to the existing cluster.

To do this, simply follow the topics on Preparing Cluster Servers and Configuring Cluster Servers to add servers. Then, restart the resource load balancer and all cluster servers - there is no need to restart the PBX server.

Please note that restarting the resource load balancer and servers will affect the calling service, so it is recommended to do this during the middle night.

Upgrading 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.

Whenever a new version of PortSIP PBX is released, it’s essential to upgrade your installed cluster servers as well. Follow the steps below to ensure a successful upgrade.

We use the media server as an example, you will need to replace the media server with other servers as your actual environment.

  1. Remove the current running server by the commands:

cd /opt/portsip
/bin/sh cluster_ctl.sh stop -s media-server-only
/bin/sh cluster_ctl.sh rm -s media-server-only
  1. Install the latest version of the server. Follow the instructions provided in the Install Media server guide to complete this step.

Last updated