Red Hat Enterprise Linux 3
GFS Release Notes
Release Notes for GFS on Red Hat Enterprise Linux 3
Edition 1
Red Hat Engineering Content Services
Red Hat Enterprise Linux 3 GFS Release Notes
Release Notes for GFS on Red Hat Enterprise Linux 3
Edition 1
Red Hat Engineering Content Services
Legal Notice
Copyright © 2004 2006 Red Hat, Inc.
This document is licensed by Red Hat under the Creative Commons Attribution-ShareAlike 3.0 Unported
License. If you distribute this document, or a modified version of it, you must provide attribution to Red
Hat, Inc. and provide a link to the original. If the document is modified, all Red Hat trademarks must be
removed.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section
4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, MetaMatrix, Fedora, the Infinity Logo,
and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux ® is the registered trademark of Linus Torvalds in the United States and other countries.
Java ® is a registered trademark of Oracle and/or its affiliates.
XFS ® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States
and/or other countries.
MySQL ® is a registered trademark of MySQL AB in the United States, the European Union and other
countries.
Node.js ® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or
endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack ® Word Mark and OpenStack Logo are either registered trademarks/service marks or
trademarks/service marks of the OpenStack Foundation, in the United States and other countries and
are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or
sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
Abstract
New features, changes, and bugs fixed in GFS 6.0 for Red Hat Enterprise Linux 3, updates 5, 6, 7, and 8.
Table of Contents
Table of Contents
. . fa. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3. . . . . . . . . .
Pr.e. . ce
1. Document Conventions 3
1.1. Typographic Conventions 3
1.2. Pull-quote Conventions 4
1.3. Notes and Warnings 5
2. Getting Help and Giving Feedback 5
2.1. Do You Need Help? 5
2.2. We Need Feedback! 6
. . vision Hist.ory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Re. . . . . . . . . . . . . 1.6. . . . . . . . . .
. . . . 1.6. . . . . . . . . .
Inde.x. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
F 16
H 16
1
Red Hat Enterprise Linux 3 GFS Release Notes
2
Preface
Preface
1. Document Conventions
This manual uses several conventions to highlight certain words and phrases and draw attention to
specific pieces of information.
In PDF and paper editions, this manual uses typefaces drawn from the Liberation Fonts set. The
Liberation Fonts set is also used in HTML editions if the set is installed on your system. If not, alternative
but equivalent typefaces are displayed. Note: Red Hat Enterprise Linux 5 and later include the Liberation
Fonts set by default.
1.1. Typographic Conventions
Four typographic conventions are used to call attention to specific words and phrases. These
conventions, and the circumstances they apply to, are as follows.
Mono-spaced Bold
Used to highlight system input, including shell commands, file names and paths. Also used to highlight
keys and key combinations. For example:
To see the contents of the file my_next_bestselling_novel in your current working
directory, enter the cat my_next_bestselling_novel command at the shell prompt
and press Enter to execute the command.
The above includes a file name, a shell command and a key, all presented in mono-spaced bold and all
distinguishable thanks to context.
Key combinations can be distinguished from an individual key by the plus sign that connects each part of
a key combination. For example:
Press Enter to execute the command.
Press Ctrl+Alt+F2 to switch to a virtual terminal.
The first example highlights a particular key to press. The second example highlights a key combination:
a set of three keys pressed simultaneously.
If source code is discussed, class names, methods, functions, variable names and returned values
mentioned within a paragraph will be presented as above, in mono-spaced bold. For example:
File-related classes include filesystem for file systems, file for files, and dir for
directories. Each class has its own associated set of permissions.
Proportional Bold
This denotes words or phrases encountered on a system, including application names; dialog box text;
labeled buttons; check-box and radio button labels; menu titles and sub-menu titles. For example:
Choose System Preferences Mouse from the main menu bar to launch Mouse
Preferences. In the Buttons tab, select the Left-handed mouse check box and click
Close to switch the primary mouse button from the left to the right (making the mouse
suitable for use in the left hand).
To insert a special character into a gedit file, choose Applications Accessories
3
Red Hat Enterprise Linux 3 GFS Release Notes
Character Map from the main menu bar. Next, choose Search Find& from the
Character Map menu bar, type the name of the character in the Search field and click
Next. The character you sought will be highlighted in the Character Table. Double-click
this highlighted character to place it in the Text to copy field and then click the Copy
button. Now switch back to your document and choose Edit Paste from the gedit menu
bar.
The above text includes application names; system-wide menu names and items; application-specific
menu names; and buttons and text found within a GUI interface, all presented in proportional bold and all
distinguishable by context.
Mono-spaced Bold Italic or Proportional Bold Italic
Whether mono-spaced bold or proportional bold, the addition of italics indicates replaceable or variable
text. Italics denotes text you do not input literally or displayed text that changes depending on
circumstance. For example:
To connect to a remote machine using ssh, type ssh [e-mail] at a shell
prompt. If the remote machine is example.com and your username on that machine is
john, type ssh [e-mail].
The mount -o remount file-system command remounts the named file system. For
example, to remount the /home file system, the command is mount -o remount /home.
To see the version of a currently installed package, use the rpm -q package command. It
will return a result as follows: package-version-release.
Note the words in bold italics above  username, domain.name, file-system, package, version and
release. Each word is a placeholder, either for text you enter when issuing a command or for text
displayed by the system.
Aside from standard usage for presenting the title of a work, italics denotes the first use of a new and
important term. For example:
Publican is a DocBook publishing system.
1.2. Pull-quote Conventions
Terminal output and source code listings are set off visually from the surrounding text.
Output sent to a terminal is set in mono-spaced roman and presented thus:
books Desktop documentation drafts mss photos stuff svn
books_tests Desktop1 downloads images notes scripts svgs
Source-code listings are also set in mono-spaced roman but add syntax highlighting as follows:
4
Preface
static int kvm_vm_ioctl_deassign_device(struct kvm *kvm,
struct kvm_assigned_pci_dev *assigned_dev)
{
int r = 0;
struct kvm_assigned_dev_kernel *match;
mutex_lock(&kvm->lock);
match = kvm_find_assigned_dev(&kvm->arch.assigned_dev_head,
assigned_dev->assigned_dev_id);
if (!match) {
printk(KERN_INFO "%s: device hasn't been assigned before, "
"so cannot be deassigned\n", __func__);
r = -EINVAL;
goto out;
}
kvm_deassign_device(kvm, match);
kvm_free_assigned_device(kvm, match);
out:
mutex_unlock(&kvm->lock);
return r;
}
1.3. Notes and Warnings
Finally, we use three visual styles to draw attention to information that might otherwise be overlooked.
Note
Notes are tips, shortcuts or alternative approaches to the task at hand. Ignoring a note should
have no negative consequences, but you might miss out on a trick that makes your life easier.
Important
Important boxes detail things that are easily missed: configuration changes that only apply to the
current session, or services that need restarting before an update will apply. Ignoring a box
labeled 'Important' will not cause data loss but may cause irritation and frustration.
Warning
Warnings should not be ignored. Ignoring warnings will most likely cause data loss.
2. Getting Help and Giving Feedback
2.1. Do You Need Help?
If you experience difficulty with a procedure described in this documentation, visit the Red Hat Customer
5
Red Hat Enterprise Linux 3 GFS Release Notes
Portal at http://access.redhat.com. Through the customer portal, you can:
search or browse through a knowledgebase of technical support articles about Red Hat products.
submit a support case to Red Hat Global Support Services (GSS).
access other product documentation.
Red Hat also hosts a large number of electronic mailing lists for discussion of Red Hat software and
technology. You can find a list of publicly available mailing lists at https://www.redhat.com/mailman/listinfo.
Click on the name of any mailing list to subscribe to that list or to access the list archives.
2.2. We Need Feedback!
If you find a typographical error in this manual, or if you have thought of a way to make this manual
better, we would love to hear from you! Please submit a report in Bugzilla: http://bugzilla.redhat.com/
against the product Red Hat Enterprise Linux.
When submitting a bug report, be sure to mention the manual's identifier: GFS_Release_Notes
If you have a suggestion for improving the documentation, try to be as specific as possible when
describing it. If you have found an error, please include the section number and some of the surrounding
text so we can find it easily.
6
Preface
RED HAT GFS 6.0 Release Notes
Copyright(c) 2004 Red Hat, Inc.
-------------------------------------------------------
Introduction:
The following topics are covered in this document:
o GFS 6.0 New Features
o Defects Fixed in the Release
o Related Documentation
GFS 6.0 New Features
o Red Hat GFS 6.0 adds the capability of setting and displaying file ACLs and
extended file attributes in a GFS file system. The Linux commands setfacl
and getfacl set and get ACLs. The Linux commands setfattr and getfattr set
and get file attributes. In addition, this release adds a GFS-specific
mount command option, -o acl. The new option allows users to set ACLs.
o This release adds fencing agents for McData Fibre Channel (FC) switches,
Egenera BladeFrame systems, and xCAT (Extreme Cluster Administration Toolkit)
clusters.
o Initialization (/etc/init.d/) script support has been added for the pool,
ccsd, lock_gulmd, and gfs modules.
o This release allows configuration of the GFS cluster heartbeat rate for
sub-second node failure detection.
o Previous GFS releases required a license file that defined the term of use
and which GFS features were enabled. Red Hat GFS 6.0 does not require a
license file.
o When GFS is installed with Red Hat Cluster Suite, a configuration druid is
available with Cluster Suite for initial configuration of GFS.
Defects Fixed in the Release
o All critical defects in GFS 5.2.1 have been corrected in this release.
Related Documentation
o Refer to the Red Hat GFS 6.0 Administrator's Guide for more information
about installation and configuration of Red Hat GFS 6.0.
7
Red Hat Enterprise Linux 3 GFS Release Notes
Red Hat GFS 6.0 RHEL3 U5 Release Notes
Copyright(c) 2005 Red Hat, Inc.
-------------------------------------------------------
Introduction
The following topics are covered in this document:
o Changes to GFS 6.0
o Major Defects Fixed in the Release
o Related Documentation
Changes to GFS 6.0
This section describes changes for GFS 6.0 RHEL3 U5 and includes the
following information:
o Optional usedev key
o Updated gfs_fsck command
o Use with PowerPath
Optional usedev key
An optional usedev key has been added 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.
The nodes.ccs format with the usedev key:
-----------------------------------------
nodes {
NodeName {
ip_interfaces {
IFNAME="IPAddress" <---- Must be an IP address; not a name
}
usedev = "NamedDevice" <---- Optional parameter usedev
fence {
.
.
.
}
}
NodeName {
.
.
.
8
Preface
}
}
An example of a nodes.ccs file with the usedev key:
---------------------------------------------------
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 {
.
.
.
}
}
Parameter descriptions for use with the usedev key:
---------------------------------------------------
Parameter: IPAddress
Description: 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. Note: This parameter
*must* be an IP address; not a node name.
Parameter: usedev
Description: 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).
Parameter: NamedDevice
Description: 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.
Updated gfs_fsck command
The gfs_fsck command for RHEL3 Update 5 and
later has changed in the following ways:
o 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.
o You can increase the level of verbosity by using the -v flag. Adding a
second -v flag increases the level again.
o You can decrease the level of verbosity by using the -q flag. Adding a
9
Red Hat Enterprise Linux 3 GFS Release Notes
second -q flag decreases the level again.
o 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 man page, gfs_fsck(8), for additional information
about other command options.
Use with PowerPath
In this release, the GFS volume manager (pool) has been enhanced to not
recognize the underlying physical devices accessed via EMC PowerPath. The
result of the enhancement reduces delays caused by seeking alternate paths
through both PowerPath and the underlying physical devices. Instead, GFS pool
relies on redundant path selection provided by PowerPath. In addition, GFS
pool is not designed to allow mixing or concatenating PowerPath devices with
non-PowerPath devices. Attempting to do so prevents activation of a GFS pool
volume composed of a PowerPath and a non-PowerPath device.
Major Defects Fixed in the Release
For a list of defects fixed in this release, refer to Red Hat Errata
"RHBA-2005:466 GFS bug fix update" on Red Hat Network (RHN):
https://rhn.redhat.com/
Related Documentation
Refer to the Red Hat GFS 6.0 Administrator's Guide for more information
about installation and configuration of Red Hat GFS 6.0. The Red Hat GFS
6.0 Administrator's Guide is available at
http://www.redhat.com/docs/manuals/csgfs/.
Refer to the Red Hat documentation errata for updates to the
Red Hat GFS 6.0 Administrator's Guide. Documentation errata for
the Red Hat GFS 6.0 Administrator's Guide is available at
http://www.redhat.com/docs/errata/csgfs/.
10
Preface
Red Hat GFS 6.0 RHEL3 U6 Release Notes
Copyright(c) 2005 Red Hat, Inc.
-------------------------------------------------------
Introduction
The following topics are covered in this document:
o Changes to GFS 6.0
o Bugs Fixed in the Release
o Related Documentation
Changes to GFS 6.0
This section describes the following changes for GFS 6.0 RHEL3 U6:
o Using GFS pool with Hitachi Dynamic Link Manager(tm) Software
o Using GNBD with GFS pool Multipath
o Additional WTI Power Switches Supported
Using GFS pool with Hitachi Dynamic Link Manager(tm) Software
In this release, the GFS volume manager (pool) has been enhanced to not
recognize the underlying physical devices accessed via Hitachi Dynamic Link
Manager (DLM) software. The result of the enhancement reduces delays caused
by seeking alternate paths through both Hitachi DLM and the underlying
physical devices. Instead, GFS pool relies on the redundant path selection
provided by Hitachi DLM. In addition, GFS pool does not allow mixing or
concatenating Hitachi DLM devices with non-Hitachi DLM devices; attempting
to do so prevents activation of a GFS pool.
Using GNBD with GFS pool Multipath
If you are using GNBD with GFS pool multipathing enabled, you must specify
that the GNBD client (gnbd.o) uses a persistent major number other than one
in the range of 232 through 255. That range of major numbers is reserved
for use with GFS pool and external multipath software (for example: Hitachi
DLM and EMC Power Path software). Not setting a major number outside 232
through 255 with GFS pool multipathing can cause unpredictable results.
That is, a major number may be assigned dynamically that falls within the
reserved range, and therefore does not recognize the GNBD. You can
configure the GNBD major number as persistent by adding the following line
to the /etc/modules.conf file in the node where the GNBD client is running:
options gnbd major=
For example, to set the GNBD major number to 121, add/edit the options
line in /etc/modules.conf as follows:
options gnbd major=121
11
Red Hat Enterprise Linux 3 GFS Release Notes
Additional WTI Power Switches Supported
This release now supports the following WTI power switches:
o IPS-800
o IPS-800-CE
o NBB-1600
o NBB-1600-CE
o TPS-2
o IPS-15
These same switches are supported for Red Hat GFS 6.1 (via Red Hat
Cluster Suite 4).
Bugs Fixed in the Release
o 150563 -- Fencing agent for Dell 1855 blade chassis DRAC/MC
o 159313 -- Unnecessary/ugly output from ccsd init script in syslog
o 160525 -- GFS fsck not handling extended attributes correctly
o 160525 -- fsck [gfs_fsck] erroneously reporting bitmap corruption when
converting bits from free_metadata -> free_data
o 162422 -- Recovery problem when the gulm master node is fenced
o 162422 -- gfs_fsck fails to complete, can't mount the device.
o 163221 -- pool commands reports Unable to open device "/dev/lvma":
o 170153 -- Pool and multipathing with Hitachi software. (Note: Refer
to "Use with Hitachi Dynamic Link Manager(tm) Software" in preceding
section of this document.)
For more information about bugs fixed in this release and other information
about the release, refer to RHBA-2005:723 RHN (https://rhn.redhat.com/).
Related Documentation
Refer to http://www.redhat.com/docs/manuals/csgfs/ for the following related
Red Hat documentation.
o Red Hat GFS 6.0:
- Refer to the Red Hat GFS 6.0 Administrator's Guide for more information
about installing and configuring Red Hat GFS 6.0.
- Refer to previous release notes for information about earlier releases
of Red Hat GFS 6.0.
o Red Hat Cluster Suite 3: Refer to the Red Hat document, Red Hat Cluster
12
Preface
Suite Configuring and Managing a Cluster, for information about using
Red Hat GFS 6.0 with Red Hat Cluster Suite 3.
13
Red Hat Enterprise Linux 3 GFS Release Notes
Red Hat GFS 6.0 RHEL3 U7 Release Notes
Copyright(c) 2006 Red Hat, Inc.
-------------------------------------------------------
March 22, 2006
Introduction
The following topics are covered in this document:
o Changes to GFS 6.0
o Bugs Fixed in the Release
o Related Documentation
Changes to GFS 6.0
Red Hat GFS 6.0 contains no new features for Red Hat Enterprise
Linux 3 Update 7.
Bugs Fixed in the Release
o 147551 -- Minor typo in pool_tool 'Please specifiy a config file'
o 152100 -- recovery deadlock after having shot the master
o 168700 -- GFS latency issues after running tests for an hour
o 169967 -- GFS spec file should not include /usr/lib/* in %files
o 171043 -- Critical custom application experiences internal latencies
maybe related to GFS
For more information about bugs fixed in this release and other information
about the release, refer to the following errata on RHN
(https://rhn.redhat.com/):
RHBA-2006:0269 - GFS bug fix update
Related Documentation
The following related documentation is available at
http://www.redhat.com/docs/manuals/csgfs/:
o Red Hat GFS 6.0 Administrator's Guide
o Release notes for Red Hat GFS 6.0
o Red Hat Cluster Suite Configuring and Managing a Cluster
(for Red Hat Cluster Suite 3)
o Release notes for Red Hat Cluster Suite 3
14
Preface
Red Hat GFS 6.0 RHEL3 U8 Release Notes
Copyright(c) 2006 Red Hat, Inc.
-------------------------------------------------------
September 19, 2006
Introduction
The following topics are covered in this document:
o Changes to GFS 6.0
o Bugs Fixed in the Release
o Related Documentation
Changes to GFS 6.0
Red Hat GFS 6.0 contains no new features for Red Hat Enterprise
Linux 3 Update 8.
Bugs Fixed in the Release
o 185078 -- PHP process hung in D state with flock
For more information about bugs fixed in this release and other information
about the release, refer to the following errata on RHN
(https://rhn.redhat.com/): RHBA-2006:0593 - GFS bug fix update
Related Documentation
The following related documentation is available at
http://www.redhat.com/docs/manuals/csgfs/:
o Red Hat GFS 6.0 Administrator's Guide
o Release notes for Red Hat GFS 6.0
o Red Hat Cluster Suite Configuring and Managing a Cluster
(for Red Hat Cluster Suite 3)
o Release notes for Red Hat Cluster Suite 3
15
Red Hat Enterprise Linux 3 GFS Release Notes
Revision History
Revision 1.0-2.4 02 Fri Oct 25 2013 Rüdiger Landmann
Rebuild for Publican 4.0.0
Revision 1.0-2 Tue Jun 4 2013 Ruediger Landmann
Update some boilerplate text
Revision 1.0-1 Tue Jun 4 2013 Ruediger Landmann
Port to Publican 3
Index
F
feedback
- contact information for this manual, We Need Feedback!
H
help
- getting help, Do You Need Help?
16