IP quorum configuration

The IP quorum application is a Java™ application that runs on a separate server or host. An IP quorum application is used in Ethernet networks to resolve failure scenarios where half the nodes or enclosures on the system become unavailable. In this scenario, the application determines which nodes or enclosures can continue processing host operations and avoids a split system, where both halves of the system continue to process I/O independently. In addition, an IP quorum application also provides a quorum disk that stores configuration metadata that is used for system recovery. For systems that already have a quorum disk configured for metadata recovery, you can configure the IP quorum application to provide only tie-break operations.

In some HyperSwap configurations, an IP quorum application can be used at the third site as an alternative to third-site quorum disks. No Fibre Channel connectivity at the third site is required to use an IP quorum application as the quorum device. If you currently have a third-site quorum disk, you must remove the third site before you use an IP quorum application.

There are strict requirements on the IP network and some disadvantages with using an IP quorum application. When certain aspects of the system configuration change, an IP quorum application must be reconfigured and redeployed to hosts. These aspects include adding or removing a node (or hot-spare node) from the system or when service IP addresses are changed on a node. Other examples include changing the system certificate or experiencing an Ethernet connectivity issue. An Ethernet connectivity issue prevents an IP quorum application from accessing a node that is still online. If an IP application is offline, the IP quorum application must be reconfigured because the system configuration changed. To view the state of an IP quorum application in the management GUI, select Settings > System > IP Quorum. If you update the software version of the system, you need to reconfigure and redeploy the IP quorum application to include support for quorum disks to store configuration metadata system recovery operations. You can also use the lsquorum command to view the state of the IP quorum application.

An IP quorum application can also act as the quorum device for systems that are configured with a single-site or standard topology that does not have any external storage configured. This configuration gives a system tie-break capability, automatically resuming I/O processing if half of the system's nodes or enclosures are inaccessible.

The maximum number of IP quorum applications that can be deployed is five. However, multiple instances of the IP quorum application cannot be run on the same host or server. Only one instance of the IP quorum application per host or server is supported. IP quorum applications on multiple hosts or servers can be configured to provide redundancy.

Do not deploy the IP quorum application on a host that depends on storage that is presented by the system. This action can result in a situation where the nodes need to detect the IP quorum application to process I/O, but cannot because IP quorum application cannot access storage.

IP quorum requirements

For stable quorum resolutions, an IP network must provide the following requirements:
  • Connectivity from the servers that are running an IP quorum application to the service IP addresses of all nodes or node canisters. The network must also deal with possible security implications of exposing the service IP addresses, as this connectivity can also be used to access the service assistant interface if the IP network security is configured incorrectly.
  • On each server that runs an IP quorum application, ensure that only authorized users can access the directory that contains the IP quorum application. Metadata is stored in the directory in a readable format, so ensure access to the IP quorum application and the metadata is restricted to authorized users only.
  • Port 1260 is used by the IP quorum application to communicate from the hosts to all nodes or enclosures.
  • The maximum round-trip delay must not exceed 80 milliseconds (ms), which means 40 ms each direction.
  • If you are configuring the IP quorum application without a quorum disk for metadata, a minimum bandwidth of 2 megabytes per second is guaranteed for traffic between the system and the quorum application. If your system is using an IP quorum application with quorum disk for metadata, a minimum bandwidth of 64 megabytes per second is guaranteed for traffic between the system and the quorum application.
  • Ensure that the directory that stores an IP quorum application with metadata contains at least 250 megabytes of available free space.
The following minimum requirements must be met on the hosts that are used to run an IP quorum application:
Table 1. Supported Operating Systems and Java Runtime Environments.

Operating System Java Vendor and Version
IBM OpenJDK Oracle
7.1 7.1+ 8 8.1+ 7 7+ 8 8+ 7 7+ 8 8+
AIX7 X X X X                
AIX7.x X X X X                
RHEL6 X X X X X X X X X X X X
RHEL6.x X X X X X X X X X X X X
RHEL7 X X X X X X X X X X X X
RHEL7.x X X X X X X X X X X X X
SLES11 X X X X X X X X X X X X
SLES11.x X X X X X X X X X X X X
SLES12 X X X X X X X X X X X X
SLES12.x X X X X X X X X X X X X
CentOS6         X X X X        
CentOS6.x         X X X X        
CentOS7         X X X X        
CentOS7.x         X X X X        
Win2008 X X     X X X X X X X X
Win2008x X X     X X X X X X X X
Win2012 X X X X X X X X X X X X
Win2012x X X X X X X X X X X X X
Win2016 X X X X X X X X X X X X
Win2016x X X X X X X X X X X X X

Installing IP quorum

If you change the configuration by adding a node, changing a service IP address, or changing SSL certificates, you must download and install the IP quorum application again. To download and install the IP quorum application, complete the following steps:
  1. In the management GUI, select Settings > System > IP Quorum and download the version of the IP quorum Java application. You can also use the command-line interface (CLI) to enter the mkquorumapp command to generate an IP quorum Java application. The application is stored in the dumps directory of the system with the file name ip_quorum.jar.
  2. On the server or host on which you plan to run the IP quorum application, create a separate directory that is dedicated to the IP quorum application.
  3. Transfer the IP quorum application from the system to a separate directory on the server or host that is to run the IP quorum application.
  4. Use the ping command on the host server to verify that it can establish a connection with the service IP address of each node in the system.
  5. On the host, run the command java -jar ip_quorum.jar to initialize the IP quorum application.
  6. To verify that the IP quorum application is installed and active, select Settings > System > IP Quorum. The new IP quorum application is displayed in the table of detected applications. The system automatically selects MDisks for quorum disks. In a HyperSwap configuration with IP quorum, the system automatically selects an MDisk from both sites. These MDisks store metadata that are used for system recovery.If you want to select specific MDisk to use as quorum disks, select MDisk by Pools and right-click the MDisk and select Quorum > Modify Quorum Disk. You can also use the lsquorum command on the system CLI to verify that the IP quorum application is connected and is the active quorum device. If you want to modify the MDisk that are used for quorum by using the command-line interface, use the chquorum command.