Managing servers in the cluster

A cluster is a group of servers in a single location. The key feature of such servers (cluster nodes) is their location and high data transfer speed between them.

Server connection

---

Before connecting, make sure that the server meets the requirements for the cluster.

Perform the following steps to connect a server to the cluster: 

1. Go to Cluster nodes → Connect a node.
2. Enter a cluster node Name. 
3. Select a Cluster that the server will be connected to.

4. To prevent VMmanager from creating a default bridge on the node, enable the Do not configure network automatically option. Learn more in Network setting on the cluster node.
   

   

   Enable this option if:

   • you plan to use the VLAN interface for the server IP;
   • the server has a non-standard network configuration — there is no single interface for all traffic to pass through.

   After connecting the node, you will be able to manually configure the necessary network settings.

5. Enter additional information into the Notes field.
6. Enter a server IP address and Port to connect via SSH. The default port is 22. 
7. Enter the User. It is recommended to use root for correct operation of the node.

8. Enter the server User password or add a public SSH-key of the server with VMmanager. To do so, click on I want to use a public ssh-key, copy the key, and add it into the file /root/.ssh/authorized_keys on the server. 

   

   If you specify a SSH root password, VMmanager connects to the server with this password and add the platform's public SSH key to the list of authorized keys. Next time to connect to the storage, VMmanager will use only the SSH key.

9. Enter the RAM Overselling ratio. Learn more in Overselling. 
10. Select VM limit. When the limit is reached, the creation and migration of virtual machines on the node will be forbidden. If the limits are not set, the virtual machines can be created unless there are sufficient resources on the node.
11. Select vCPU limit — the maximum number of vCPUs that can be allocated to VMs on this node. The default value of the parameter is the number of CPUs on the server multiplied by the overselling ratio.
12. Specify the VM parameters that will be created on the cluster node. For details, see the VM distribution settings section.
13. If you are connecting the server to a cluster with IP-fabric type, specify an IPv6 address for configuring networks.
14. If you connect the server to the cluster with the "Routing" network configuration type, enter the IP for new VM. You can enter single IP addresses, or a mask. Enter every IP address from a new line. 
15. Select the scripts to be executed when the node is connected:
    1. Press Select scripts.
    2. Mark the desired scripts in the list.
    3. Select the order in which the scripts will be executed in the Start Priority column.

    4. Press Select ... scripts.
       

       

       If the Autorun on clusters option is enabled in the script settings, you cannot disable the script and change the priority. Read more in Creating a script for the node.

16. Click on Connect the node.
17. If you have selected a cluster with two network interfaces, specify the Interface for the main network and/or the Interface for the additional network. Read more in Main and additional network. Press Continue.

Example of server connection

The system will install the required software and configure the server. 

Cluster node dashboard

---

To view information about a cluster node, open its card: go to Nodes section → select the node. The cluster node card displays:

• node status;
• virtualization type — KVM or LXD;
• CPU — CPU load;
• RAM — RAM used;
• Storage — disk space used;
• overselling ratios;
• information about connected storages;
• Total VMs — total number of VMs on the node;
• number of VMs with a certain status;
• Estimated number — maximum possible number of VMs. The value is calculated dynamically and depends on available node resources;
• cluster name;
• operating system;
• IP-address of the node;
• Uptime — time of continuous node operation;
• Services — services running;
• note.

Possible node statuses:

Special statuses for nodes in HA clusters:

Cluster node dashboard interface

To view detailed information about a node, click the Parameters button in the node card.

Change connection settings

---

If the IP address and/or SSH port on the cluster node has changed, VMmanager will lose connection with the node. To reconnect:

1. Go to Nodes → select a node → menu → Change connection settings.
2. Specify the Node IP address.
3. Specify the SSH port.
4. Click Connect to node.

VM distribution settings

---

When creating a VM, the platform selects the cluster node with the most suitable distribution settings. For example, you can configure the settings so that only VMs with a certain amount of RAM or Storage are created on the node.

To configure distribution settings:

1. Enter Nodes → select the node → VM distribution settings.
2. Enter the RAM оverselling ratio. Read more in Overselling.
3. Specify the VM limit — the maximum number of VMs on the node.
4. Specify the Limit the vCPU number — the maximum number of vCPUs that can be allocated to VMs on this node.
5. Select VM parameters for distribution filters:
   • OS tags — operating system template tags;
   • Configurations — the names of configurations;
   • RAM resources — the amount of RAM;
   • Storage resources — the volume of the disk;
   • vCPU resources — the number of virtual CPUs;
   • Complex filter — a condition with several parameters.
     When entering conditions, use the filter syntax. If you want to set an additional condition, press Add filter. To delete a condition, press .
6. Press Save.

Example of setting distribution filters

To configure VM distribution on multiple nodes of a cluster:

1. Enter Nodes → select the nodes.
2. On the bottom menu, press VM distribution settings.
3. In the window that opens, configure the VM distribution filters.
4. Press Save.

Example of setting distribution filters

Forbid users to create VMs on a cluster node

---

To prevent users from creating virtual machines on a cluster node: 

1. Go to Cluster nodes → menu → Prohibit VM creation.
2. Click on Confirm.

To cancel the settings: 

1. Go to Cluster nodes → menu → Allow VM creation.
2. Click on Allow.