Managing Serviceguard A.11.20, March 2013

NOTE: You can use Serviceguard Manager to configure a cluster: open the System Management
Homepage (SMH) and choose Tools-> Serviceguard Manager. See “Using Serviceguard
Manager” (page 24) for more information.
You can also use Easy Deployment commands; see“About Easy Deployment” (page 110) and “Using
Easy Deployment Commands to Configure the Cluster” (page 167).
To use traditional Serviceguard commands to configure the cluster, follow directions in the remainder
of this section.
Use the cmquerycl (1m) command to specify a set of nodes to be included in the cluster and
to generate a template for the cluster configuration file.
IMPORTANT: See the entry for NODE_NAME under “Cluster Configuration Parameters ” (page 114)
for important information about restrictions on the node name.
Here is an example of the command (enter it all one line):
cmquerycl -v -C $SGCONF/clust1.conf -n ftsys9 -n ftsys10
This creates a template file, by default /etc/cmcluster/clust1.conf. In this output file,
keywords are separated from definitions by white space. Comments are permitted, and must be
preceded by a pound sign (#) in the far left column.
NOTE: HP strongly recommends that you modify the file so as to send the heartbeat over all
possible networks. See also HEARTBEAT_IP under “Cluster Configuration Parameters ” (page 114),
and “Specifying the Address Family for the Heartbeat ” (page 192).
The cmquerycl(1m) manpage further explains the calling parameters as well as those that appear
in the template file. See also “Cluster Configuration Parameters ” (page 114). Modify your /etc/
cmcluster/clust1.conf file as needed.
cmquerycl Options
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” below.)
-w none skips network querying. If you have recently checked the networks, this option will save
time.
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 111) for a full discussion, including important restrictions for IPv6–only and mixed modes.
Configuring the Cluster 191