Cluster Command-line Utilities

Red Hat Cluster Suite: Configuring and Managing a Cluster
Prev |  | Next

# Appendix F. Cluster Command-line Utilities

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

# F.1. Using `redhat-config-cluster-cmd`

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).

1. 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

2. 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

3. 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

4. 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

5. Add the mounted directory for NFS exporting:

       redhat-config-cluster-cmd --service=nfs_engineering --device=/dev/sdc3 \
       	      --add_nfs_export --name=/mnt/nfs/engineering

6. 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

7. 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:

    man redhat-config-cluster-cmd

Prev | Home | Next
The `cluster.xml` File | Up | Using the `shutil` Utility