Red Hat Cluster Suite and Red Hat GFS Documentation Errata

If you find any errors in the Red Hat Cluster Suite or Red Hat GFS documentation, or just have a suggestion, please read the Submitting Documentation Errata page.

GFS 6.0 Administrator's Guide

Cluster Management, Fencing, and Recovery

GFS Software Subsystem Components

Creating the fence.ccs File

Creating the nodes.ccs File

Fencing Methods

The following caution admonition should be added/updated to the affected areas above and anywhere else that manual fencing appears in the document:

Caution
Manual fencing should not be used in a production environment. Manual fencing depends on human intervention whenever a node needs recovery. Cluster operation is halted during the intervention.

Basic GFS Examples, Section C.3.3. Setup Process

Step 5. "Create CCS files.", sub-step b.

Line 4 of the example contains an extra closing bracket:

servers = ["n01"] ]

The extra bracket should not appear. The line should read:

servers = ["n01"]

Creating the nodes.ccs File

Appendix C. Basic GFS Examples, Setup Process subsections as follows:

Setup Process, Step 5.c

Setup Process, Step 7.c

This release adds an optional usedev key to the nodes.ccs file (nodes.ccs:nodes). The value of that key is a named device from the ip_interfaces section. If usedev is present, GULM uses the IP address from that device in the ip_interfaces section. Otherwise GULM uses the IP address from libresolv, as it does in earlier releases.

Note
The IP address specified in the ip_interfaces section must be an IP address; not a name.

This change affects the following areas of the document:

Figures 6-13 through 6-22
Examples 6-13 through 6-25
Table 6-3
Appendix C, subsections C.1.3, C.2.3, C.3.3, C.4.3, and C.5.3

Changes affecting Figures 6-13 through 6-22:
-----------------------------------------------------------------


nodes {
  NodeName {
     ip_interfaces {
         IFNAME="IPAddress"  <—   Must be an IP address; not a name
     }
     usedev = "NamedDevice"  <—  Optional parameter usedev
     fence {
     .
     .
     .
     }
  }
  NodeName {
  .
  .
  .
  }
}

Changes affecting Examples 6-13 through 6-25:
-----------------------------------------------------------------


nodes {
   n01 {
      ip_interfaces {
         wizzy = "10.0.0.1"  <---- Must be an IP address; not a name
      }
      usedev = "wizzy"  <---- Optional parameter usedev set to "wizzy"
      fence {
      .
      .
      .
      }
   }
   n02 {
   .
   .
   .
   }
}

Changes affecting Table 6-3:
-----------------------------------------

Parameter	Description
`IPAddress`	For the ip_interfaces section: The IP address of the node on the interface specified. GULM uses this parameter only if the optional `usedev parameter is specified in the nodes.ccs file.`
...	...
`usedev`	If usedev is present, GULM uses the IP address from that device in the ip_interfaces section. Otherwise GULM uses the IP address from libresolv (as it does in earlier releases).
`NamedDevice`	Used with usedev. NamedDevice indicates that the IP address is specified by the optional parameter usedev, and not by the IP address pulled from libresolv.

Repairing a File System

The following note should be added at the end of the second paragraph in that section:

Note
The gfs_fsck command for RHEL3 Update 5 and later has changed in the following ways:

You can no longer set the interactive mode with Ctrl+C. Pressing Ctrl+C now cancels the gfs_fsck command. Do *not* press Ctrl+C unless you want to cancel the command.
You can increase the level of verbosity by using the -v flag. Adding a second -v flag increases the level again.
You can decrease the level of verbosity by using the -q flag. Adding a second -q flag decreases the level again.

The -n option opens a file system as read-only and answers 'no' to any queries automatically. It provides a way to try the command to reveal errors without actually trying to change anything.

Refer to the gfs_fsck(8) man page for additional information about other command options.

Main Site Links:

Red Hat Cluster Suite and Red Hat GFS Documentation Errata