H3C UIS Manager

Stateful Failover Configuration Guide

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Document version: 5W101-20210103

 

Contents

About H3C UIS Manager stateful failover system·· 1

Overview· 1

Stateful failover system member roles· 1

Network diagrams· 1

Restrictions and guidelines· 2

Configuring stateful failover 3

Host requirements· 3

VM template pools· 3

Stateful failover system setup time· 3

Deployment schemes· 3

Restrictions and guidelines· 3

Procedures· 4

Setting up a stateful failover system·· 4

Adding a VM template pool 7

Configuring a VNC proxy server 8

Registering licenses· 8

 

About H3C UIS Manager stateful failover system

Overview

You can set up a UIS Manager stateful failover system for high availability. When the primary node fails or its network fails, the backup node takes over automatically to provide service.

UIS Manager stateful failover provides the following features:

·     Stateful failover—CMSD, the main process of the stateful failover service, performs the following tasks:

¡     Enables communication within the stateful failover system.

¡     Starts and stops the stateful failover service.

¡     Initiates a failover when network or host failure occurs.

·     Data synchronization—The primary and backup nodes synchronize data through Distributed Replicated Block Device (DRBD). When UIS Manager on the primary node has data changes, the backup node synchronizes its data with the primary node in real time to ensure management data consistency.

·     Distributed storage hot backup—The distributed storage component backs up data independent of the CMSD process.

·     Quorum mechanism—If the primary and backup UIS Manager platforms fail to communicate with each other but have reachability to external networks, the quorum mechanism operates to handle the issue. UIS Manager supports the following quorum modes:

¡     Advanced quorum—A host installed with UIS acts as a quorum host. The primary and backup UIS Manager platforms send their status to the quorum host, and the quorum host determines their roles based on the status information and sends the result back to them.

¡     Ping quorum—Two IP addresses are specified as quorum IP addresses. The primary and backup UIS Manager platforms ping the quorum IP addresses simultaneously to test network connectivity. If a platform fails to ping both quorum IP addresses, it changes its role to backup.

Stateful failover system member roles

A stateful failover system contains the following nodes:

·     Primary node.

·     Backup node.

·     Quorum node.

A quorum node can be a pingable network node, such as a switch or gateway, or a host installed with UIS.

Network diagrams

Stateful failover supports the following deployment modes:

·     Converged deployment—The primary and backup nodes are in a service cluster, such as a compute, network, or storage cluster, as shown in Figure 1.

·     Distributed deployment—The primary and backup nodes are independent nodes not in a service cluster, as shown in Figure 2.

Figure 1 Converged deployment

 

Figure 2 Distributed deployment

 

Restrictions and guidelines

You can set up a stateful failover system only when deploying UIS Manager. You cannot set up a stateful failover system for deployed UIS Manager.

You cannot split a stateful failover system into two independent platforms.

The primary and backup nodes must both be service cluster nodes or independent nodes.

Configuring stateful failover

Host requirements

The hosts to form the stateful failover system must meet the following requirements:

·     They are installed with the same version of UIS.

·     They have the same system boot method and boot drive for operating system installation.

·     The vms partition is larger than 20 GB and has enough space.

·     Their system disks are the same size.

·     They have connectivity on the management network.

·     They have the same system time.

·     They do not have VMs attached. If VMs exist, delete or migrate them.

·     Their storage pools use the default configuration set in initialization.

VM template pools

The stateful failover system uses iSCSI or FC shared directories as VM template pools. The primary and backup nodes do not need to synchronize VM templates over the management network.

Stateful failover system setup time

You can set up a stateful failover system on UIS Manager after system initialization. Setting up a stateful failover system might take a long time, because the local and peer disk partitions must be initialized during the setup process. The time it takes to set up a stateful failover system depends on the disk size and network speed. For example, it requires about 20 minutes to initialize 100 GB of disk space over a Gigabit network, and using a 10 Gigabit network can speed up initialization.

Deployment schemes

You can use the following deployment schemes, which are listed in descending order of priority:

·     Converged deployment with advanced quorum.

·     Converged deployment with ping quorum.

·     Distributed deployment with advanced quorum.

·     Distributed deployment with ping quorum.

Restrictions and guidelines

·     If the stateful failover system splits because of network anomalies, the nodes in the system automatically elect the primary node after the network recovers. If service hosts are sending performance statistics to the backup node when the split-brain failure occurs, the hosts will still send performance statistics to the backup node after the stateful failover system recovers, which causes data loss on the primary node. To resolve this issue, you must connect UIS Manager on the primary node to the host.

·     Do not restart or shut down member nodes when you are setting up the stateful failover system. If an unexpected node reboot or poweroff occurs, you must re-set up the stateful failover system.

·     To avoid serious issues such as data loss, do not modify host names or IP addresses after the stateful failover system is set up successfully.

·     During stateful failover system setup, do not close the browser. When stateful failover system setup starts, you are redirected to the login page at the virtual IP address of UIS Manager.

·     If UIS Manager fails to set up the system, check /var/log/cvm_master.log and /var/log/cvm_master_slave.log for detailed cause and phase information. You can modify incorrect parameters and re-set up the stateful failover system.

·     For distributed deployment, if UIS Manager cannot find the backup host when re-setting up the stateful failover system after a failure, log in to the backup host to delete the isCvmFlag file in the /root/.ssh/ directory.

Procedures

Setting up a stateful failover system

1.     Log in to UIS Manager.

2.     On the top navigation bar, click System, and then select Stateful Failover from the navigation pane.

Figure 3 Stateful failover configuration page

 

3.     Click Set Up Stateful Failover System.

4.     Configure the parameters used for setting up the stateful failover system as follows, and then click OK:

¡     Virtual IP Address—Specify the IP address for accessing UIS Manager. The IP address must be an unused address on the management network.

¡     Subnet Mask—Specify the subnet mask for the virtual IP address.

¡     Backup Host Location—Specify the location of the backup host.

-     If you use converged deployment, only Hosts in System is available.

-     If you use distributed deployment, select Others.

For converged deployment, you must add an independent node to a service cluster through host discovery before you can specify it as the backup node.

¡     Storage System Virtual IP—Enter an IP address for high availability management of the distributed storage component or configure the system to automatically allocate one. The IP address must be an unused address on the management network.

¡     Backup Host IP Address—Specify the management IP address of the backup UIS Manager.

¡     Quorum Mode—Select a quorum mode. If you use advanced quorum mode, make sure the quorum host has been installed with the same version of UIS as the primary and backup nodes. As a best practice, use a host in a service cluster as a quorum host. For two-node deployment mode, use ping quorum mode.

¡     Quorum Host IP Address—Specify the IP address of the quorum host.

¡     Quorum Host Root PWD—Enter the root password of the quorum host.

¡     Quorum IP Address—Enter two different IP addresses that are always reachable to the stateful failover system.

¡     Estimated Host Quantity—Enter the estimated number of hosts in UIS Manager.

¡     Estimated VM Quantity—Enter the estimated number of VMs in UIS Manager.

¡     Database Partition Size—Specify the database partition size. The system can calculate a value for this parameter based on the estimated host quantity and estimated VM quantity.

Figure 4 Configuring stateful failover parameters

 

5.     On the dialog box than opens, enter confirm and then click OK.

Figure 5 Confirming stateful failover system setup

 

UIS Manager starts setting up the stateful failover system. If errors occur, modify incorrect parameters and re-set up the stateful failover system. Detailed information about the errors is saved in /var/log/cvm_master_slave.log.

Figure 6 Setting up the stateful failover system

 

Adding a VM template pool

After the stateful failover system is set up, the system requires you to configure a template pool when you log in to UIS manager for the first time.

To add a template pool:

1.     Click Create Now.

2.     Configure the parameters as follows, and then click OK:

¡     Select a block device in a distributed storage system as the VM template pool. As a best practice, create the block device first.

¡     Select the iSCSI shared directory type.

¡     Configure the IP address as follows:

-     For converged deployment, enter 127.0.0.1 or the iSCSI HA VIP.

-     For distributed deployment, enter the iSCSI HA VIP.

You must first configure the iSCSI HA VIP. To configure that IP address, click Storage on the navigation bar, select Mapping Management from the navigation pane, and then click the iSCSI HA tab.

¡     If you use a LUN of an external IP SAN storage system, select the iSCSI shared directory type and enter the service IP address of the IP SAN storage system.

¡     If you use a LUN of an external FC SAN storage system, select the FC shared directory type.

Figure 7 Adding a VM template pool

 

Configuring a VNC proxy server

If VNC proxy is required to log in to VMs, configure VNC proxy server parameters as follows:

1.     On the top navigation bar, click System, and then select Parameters > System Parameters from the navigation pane.

2.     Configure VNC proxy server parameters.

For the stateful failover system to provide VNC proxy services, you must configure a VNC proxy server on both the primary and backup nodes and configure the virtual IP address of UIS Manager as the IP address of the VNC proxy servers.

Figure 8 Configuring VNC proxy server parameters

 

Registering licenses

The license request procedure is the same for an independent host and a stateful failover system member. For more information, see H3C UIS Manager License Registration Guide.