Managing HP Serviceguard A.11.20.10 for Linux, December 2012

5.2.1 cmquerycl Options
5.2.1.1 Speeding up the Process
In a larger or more complex cluster with many nodes, networks or disks, the cmquerycl command
may take several minutes to complete. To speed up the configuration process, you can direct the
command to return selected information only by using the -k and -w options:
-k eliminates some disk probing, and does not return information about potential cluster lock
volume groups and lock physical volumes.
-w local lets you specify local network probing, in which LAN connectivity is verified between
interfaces within each node only. This is the default when you use cmquerycl with the-C option.
(Do not use -w local if you need to discover nodes and subnets for a cross-subnet configuration;
see “Full Network Probing”).
-w none skips network querying. If you have recently checked the networks, this option will save
time.
5.2.1.2 Specifying the Address Family for the Cluster Hostnames
You can use the -a option to tell Serviceguard to resolve cluster node names (as well as Quorum
Server hostnames, if any) to IPv4 addresses only (-a ipv4) IPv6 addresses only (-a ipv6), or
both (-a any). You can also configure the address family by means of the
HOSTNAME_ADDRESS_FAMILY in the cluster configuration file.
IMPORTANT: See “About Hostname Address Families: IPv4-Only, IPv6-Only, and Mixed Mode”
(page 83) for a full discussion, including important restrictions for IPv6–only and mixed modes.
If you use the -a option, Serviceguard will ignore the value of the HOSTNAME_ADDRESS_FAMILY
parameter in the existing cluster configuration, if any, and attempt to resolve the cluster and Quorum
Server hostnames as specified by the -a option:
• If you specify -a ipv4, each of the hostnames must resolve to at least one IPv4 address;
otherwise the command will fail.
• Similarly, if you specify -a ipv6, each of the hostnames must resolve to at least one IPv6
address; otherwise the command will fail.
• If you specify -a any, Serviceguard will attempt to resolve each hostname to an IPv4 address,
then, if that fails, to an IPv6 address.
If you do not use the -a option:
• If a cluster is already configured, Serviceguard will use the value configured for
HOSTNAME_ADDRESS_FAMILY, which defaults to IPv4.
• If no cluster configured, and Serviceguard finds at least one IPv4 address that corresponds to
the local node's hostname (that is, the node on which you are running cmquerycl),
Serviceguard will attempt to resolve all hostnames to IPv4 addresses. If no IPv4 address is
found for a given hostname, Serviceguard will look for an IPv6 address. (This is the same
behavior as if you had specified -a any).
5.2.1.3 Specifying the Address Family for the Heartbeat
To tell Serviceguard to use only IPv4, or only IPv6, addresses for the heartbeat, use the -h option.
For example, to use only IPv6 addresses:
148 Building an HA Cluster Configuration