Create a cluster node

A cluster is a group of nodes in ISPmanager. Cluster nodes can be a physical or virtual server. You need to configure the servers before adding them into the cluster. For more information please refer to the article Server requirements.

To add a new cluster node go to Cluster settings → Cluster nodes → Add.

Main settings

1. Select the type of the Cluster node:
   
   1. local  — the server with ISPmanager.
   2. remote.
2. Enter the Name of the cluster node that will be displayed in ISPmanager.
3. Enter the server Domain name.
4. Enter the IP address and SSH port of the server. The default value is "22".
   Note

   For the cluster node, you cannot specify an IP address that was added through the control panel from the IP address database or IPmanager database. This IP address must be removed from the control panel and entered on the network interface using the server console.
5. Enter the Administrator name. The default name is "root".
6. Select the method for Authentication on server:
   1. by password  — enter the server administrator password.
   2. by SSH key — enter the public SSH-keys from the server with ISPmanager. To do so, copy the  Public key and add it into the file //.ssh/authorized_keys on the server:
7. Enter additional information in the Comment field. It will be displayed in the list of cluster nodes → the Comment column.

Cluster node roles

Roles define the functions that a server will perform in the cluster:

1. Set the sever Priority. The priority allows selecting a cluster node where a new user and his main role will be created. The higher the priority, the more users will be located on the cluster node.
   Details

   When selecting a cluster node for a new user role, the system checks every node with the "Ready" status:

   Cluster node rating

   Cluster node = Number of users / Cluster node priority / Available resources

   The cluster node with the smallest rate will be selected.
2. Enable the roles:
   1. Web-server (main role) — the main role of the cluster node including such features as web-server, FTP. User files are located on this node. Read more in Web server configuration.
   2. Primary name server  — this node is used as the primary name server. Read more in Domain names.
   3. Name server (secondary) — this node is used as a secondary name server. Read more in Domain names.
   4. Mail server — this node is used as a mail server.
   5. MySQL server — this node is used as a MySQL server. Enable the option Remote MySQL access and select the IP addresses that will be allowed to access the server. Read more in https://ispsystem.atlassian.net/wiki/spaces/I6BD/pages/7864768.
   6. PostgreSQL server — this node is used as a PostgreSQL server. Read more in https://ispsystem.atlassian.net/wiki/spaces/I6BD/pages/7864768.
   7. Backup server  — this node is used for creating backup copies. Learn more in Backup copies.
3. Click on Ok.