This appendix provides reference information on the following command-line utilities provided with Red Hat Cluster Suite:
redhat-config-cluster-cmd—Provides command-line access to the configuration features of the Cluster Configuration Tool utility
shutil—Checks status of the quorum partitions
clufence—Tests and controls the connections to network and serial-attached power switches
This section details an example of the redhat-config-cluster-cmd utility, which allows you to configure all aspects of the cluster, and stores the information in the /etc/cluster.xml file.
Usage, options, and examples of using the redhat-config-cluster-cmd command can be found in its man page. To access the manpage from a shell-prompt, type man redhat-config-cluster-cmd.
The following describes an example cluster system that is configured using only the redhat-config-cluster-cmd utility.
Suppose a system administrator wants to create a cluster system that will serve highly available NFS services to the engineering department of a small organization. The NFS export should only be accessible to the three members of the department (Bob, Jane, and Tom).
Add the service and assign it a descriptive name to distinguish its functionality from other services that may run on the cluster.
redhat-config-cluster-cmd --add_service --name=nfs_engineers
Add a service IP address that will transfer from one member to another in the event of failover:
redhat-config-cluster-cmd --service=nfs_engineers --add_service_ipaddress \ --ipaddress=10.0.0.10
Add a device to the service (the disk partition that serves as the NFS export):
redhat-config-cluster-cmd --service=nfs_engineering --add_device --name=/dev/sdc3
Add a mount point for the device (note: the mount point cannot be listed in /etc/fstab):
redhat-config-cluster-cmd --service=nfs_engineering --device=/dev/sdc3 --mount \ --mountpoint=/mnt/nfs/engineering/ --fstype=ext3 \ --options=rw,nosuid,sync --forceunmount=yes
Add the mounted directory for NFS exporting:
redhat-config-cluster-cmd --service=nfs_engineering --device=/dev/sdc3 \ --add_nfs_export --name=/mnt/nfs/engineering
Allow Bob to access the clustered NFS export:
redhat-config-cluster-cmd --service=nfs_engineering --device=/dev/sdc3 \ --nfsexport=/mnt/nfs/engineering --add_client --name=bob \ --options=rw
Repeat step 6 for Jane and Tom.
For more information and examples of using redhat-config-cluster-cmd, refer to the man page by typing the following at a shell prompt: