Skip to main content
Skip table of contents

Adding a node to an existing Imagicle Cluster

Before starting

Warning: when you add a node to a cluster, you loose all the data on that node.

Before you try to add a node to a cluster, ensure that:

  • The new node has the same UCX Suite version of the other nodes in the cluster, otherwise you won't be able to complete the procedure

  • The node is already configured to use the desired database server (you can check this through Support web page)

  • If the cluster is using the Replicated Database strategy, there's enough free disk space on the machine to contain at least twice the size of the database of a node that already belongs to the cluster.

You should notice also that during this procedure all the applications of the UCX Suite are stopped and unavailable on this node.

Procedure

To add a node to a cluster, log in as administrator to UCX Suite web portal and click on Admin ⇒ High Availability.

image-20250113-132510.png

Choose Add to existing Cluster and click Next.

On the next page you choose one of the IP addresses of the machine. This becomes the address used by the other nodes of the cluster to communicate with this node.

Starting from 2022.Spring.1 release, Imagicle High Availability supports IPv6 addressing too. If you choose this addressing type, please remember that all nodes should be added with same IPv6 addressing.

image-20250113-132522.png

Then you must enter the IP address of an existing node (chosen from the displayed nodes list) of the cluster you want to join. That node must be up and running until the end of this procedure.

When you click Next and confirm your choices, the node addition procedure starts. It may take a long time, depending on the amount of data contained at that moment in the cluster (this procedure automatically creates a backup of source node's database, download and restore it to the node to be added). Roughly, the first node that joins an existing cluster might take 16 minutes per GB of database size. Nodes that join later, might take 3 minutes per GB.

image-20250113-132535.png

When the procedure is complete, the node displays a success notification, but if the addition fails it displays a failure notification.

image-20250113-132549.png

From now on, the summary page shows the list of all the nodes in the cluster (including the node that you just added). IP addresses are shown in IPv4 or IPv6 format, as they were added in the cluster.

image-20250113-132605.png

Pls. keep in mind that above cluster's NODE ID corresponds to Imagicle server's host name (FQDN). You can later change host name, if required and with Imagicle team assistance; just beware that NODE ID will remain unchanged (with initial host name).

Now, in order to propagate the topology change to all the other nodes, you should restart all of them, one by one.

Next, please be aware you must re-configure some node-specific parameters: 

  • PBX connection(s), like SIP/H.323 trunks, FTP/Telnet, Routing rules, etc.

  • Proxy settings

  • Launch a DB maintenance, if required, from Support web page

  • Outgoing emails parameters

  • Monitoring parameters, including email and SNMP notifications configuration

  • Numbering plan settings

  • Contact Manager's custom fields

  • Email templates related to Digital Fax, VoiceMail and Call Recording applications

Known limitations

There are some actions an administrator can't do on a cluster:

  • On UCX Suite versions lower than Summer 2015, you can't remove a node from a cluster.

  • Once a node is part of a cluster, you can't change its IP Address.

  • You can't change cluster's NODE IDs on your own. To change NODE ID, please contact Imagicle Support.

  • You can't restore a UCX Suite backup to a cluster node: data integrity is granted by the cluster itself.

For any problem regarding one of the activities above, you can contact Imagicle Technical Support.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.