Managing Cluster

After successfully setting up the PortSIP PBX cluster, you can manage it easily.

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
sudo /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
sudo /bin/sh cluster_ctl.sh restart -s media-server-only

Check Status

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

Stop Server

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

Remove Server

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

Managing IM Server

Start Server

cd /opt/portsip
sudo /bin/sh im_ctl.sh start

Restart Server

cd /opt/portsip
sudo /bin/sh im_ctl.sh restart

Stop Server

cd /opt/portsip
sudo /bin/sh im_ctl.sh stop

Check Status

cd /opt/portsip
sudo /bin/sh im_ctl.sh status

Remove Server

cd /opt/portsip
sudo /bin/sh im_ctl.sh rm

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.

Currently, the IM server does not support cluster installations; it can be deployed as a standalone server. It can support up to 50,000 online users with a powerful CPU and memory(16 cores, 16GB). So there is no support to add more IM servers.

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.

Upgrading the Main PBX Server

  1. Remove the current running PBX Main server by the commands on the server 192.168.1.20:

cd /opt/portsip
sudo /bin/sh pbx_ctl.sh stop
sudo /bin/sh pbx_ctl.sh rm
  1. Install the latest version of the PBX server. Follow the instructions provided in the Installation of the PortSIP PBX guide to complete this step with the latest version.

Upgrading the IM Server

  1. Remove the current running server by the commands:

cd /opt/portsip
sudo /bin/sh im_ctl.sh stop
sudo /bin/sh im_ctl.sh rm
  1. Install the latest version of the IM server. Follow the instructions provided in the Installing the IM Server guide to complete this step with the latest version.

Upgrading Cluster Servers

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
sudo /bin/sh cluster_ctl.sh stop -s media-server-only
sudo /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 with the latest version.

Last updated