Enabling management node high availability

To make your infrastructure more resilient and redundant, you can create a high availability configuration of three nodes.


  • A clear understanding of the concept High availability.
  • Each node to be added to the high availability configuration is connected to a network with the Admin panel and Internal management traffic types.
  • The storage cluster is created by following the instructions in Deploying the storage cluster.

To create the high availability configuration

Admin panel

  1. On the Settings > Management node screen, open the Management high availability tab.

  2. Select three nodes, and then click Create HA. The management node is automatically selected.

  3. On Configure network, verify that the correct network interfaces are selected on each node. Otherwise, click the cogwheel icon for a node and assign networks with the Internal management and Admin panel traffic types to its network interfaces. Click Proceed.

  4. On Configure network, provide one or more unique static IP addresses for the highly available admin panel, compute API endpoint, and interservice messaging. Click Done.

Once the high availability of the management node is enabled, you can log in to the admin panel at the specified static IP address (on the same port 8888).

Command-line interface

Use the following command:

vinfra cluster ha create --virtual-ip <network:ip> --nodes <nodes> [--force]
--virtual-ip <network:ip>

HA configuration mapping in the format:

  • network: network to include in the HA configuration (must include at least one of these traffic types: Internal management, Admin panel, Self-service panel, or Compute API).
  • ip: virtual IP address that will be used in the HA configuration.

Specify this option multiple times to create a HA configuration for multiple networks.

--nodes <nodes>
A comma-separated list of node IDs or hostnames
Skip checks for minimal hardware requirements

For example, to create a management node HA cluster from nodes node001, node002, and node003, run:

# vinfra cluster ha create --virtual-ip Private: \
--virtual-ip Public: --nodes node001,node002,node003

The command specifies the network Private with the traffic type Internal management and the network Public with the traffic type Admin panel.

You can view the HA configuration in the vinfra cluster ha show output:

# vinfra cluster ha show
| Field                 | Value                                             |
| ha_cluster_location   | -                       |
| nodes                 | - id: 94d58604-6f30-4339-8578-adb7903b7277        |
|                       |   ipaddr:                           |
|                       |   is_primary: false                               |
|                       | - id: f59dabdb-bd1c-4944-8af2-26b8fe9ff8d4        |
|                       |   ipaddr:                           |
|                       |   is_primary: true                                |
|                       | - id: 4b83a87d-9adf-472c-91f0-782c47b2d5f1        |
|                       |   ipaddr:                           |
|                       |   is_primary: false                               |
| primary_node_location |                         |
| virtual_ips           | - ip:                               |
|                       |   roles_set: 5a0401b5-9b42-4d8b-8372-71c747230033 |
|                       | - ip:                                |
|                       |   roles_set: 5f0adc1d-c10f-46c1-b7b8-dd1aacab613b |

After the HA cluster has been created, the admin panel will only be accessible at the provided public IP address. Log in to said address via SSH to continue managing Virtuozzo Hybrid Infrastructure with the vinfra CLI tool. You may also need to set the VINFRA_PASSWORD environment variable again, because you will access different HA cluster nodes on each log in where it may not have been set.