Serviceguard NFS Toolkit for Linux Version A.03.
Legal Notices © Copyright 2009 Hewlett-Packard Development Company, L.P. Publication Date: March 2009 Confidential computer software. Valid license from HP required for possession, use, or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor’s standard commercial license. The information contained herein is subject to change without notice.
Table of Contents 1 Serviceguard NFS for Linux Version A.03.00 Release Notes....................................5 Announcements......................................................................................................................................5 What’s in this Version.............................................................................................................................5 Enhancements to the Serviceguard NFS Toolkit for Linux..............................................
1 Serviceguard NFS for Linux Version A.03.00 Release Notes Announcements Serviceguard NFS for Linux consists of a separate set of shell scripts and a binary file, which allows you to configure Serviceguard packages that mount highly available networked file systems. An NFS server is a host that “exports” its local directories (makes them available for client hosts to mount using NFS). On the NFS client, these mounted directories look to users as part of the client’s local file system.
• • • • A host configured as an adoptive node for more than one NFS package. The host may also be prevented from adopting more than one failed package at a time. Cascading failover, where a package may have several adoptive nodes configured to run the package. Support for the NFS v3 file lock migration feature. All user configuration parameters in a single toolkit configuration file, hanfs.conf.
What Manuals are Available for This Version The following manual contains information about HA NFS and is included with Serviceguard NFS for Linux Toolkit version A.03.00: • • Managing Serviceguard NFS for Linux Modular Package Support in Serviceguard for Linux Toolkits white paper NOTE: The above white paper contains information about Modular Packages and is available at http://docs.hp.com -> High Availability -> Serviceguard for Linux Toolkits -> White Papers.
NOTE: For supported Serviceguard versions see “Announcements” (page 5). Installing Serviceguard NFS for Linux 1. Before starting, follow the following steps to remove any previous version of Serviceguard NFS for Linux: To query the NFS Toolkit from the rpm database use: # rpm -qa | grep nfs-toolkit If any part of the NFS Toolkit is installed, erase it using: # rpm -e nfs-toolkit- 2.
• • • • • • toolkit.sh: The interface script between the Package Control Script and hanfs.sh. hanfs.conf: The NFS configuration file sets the user configuration parameters. lock_migration.sh:Starts Lock migration in modular packages. tkit_module.sh: Script which starts the package in modular packages. tkit_gen.sh: Script which starts the package in modular packages. nfs.1: Attribute definition file used by Serviceguard to generate package configuration file.
NOTE: toolkit.sh, hanfs.sh, nfs.mon, nfs.flm and hanfs.conf should be in the same directory. In case of legacy packages even the pkg.cntl script must be in the same directory. Do not rename the following files since their names are hard coded in the control scripts: toolkit.sh, hanfs.sh, hanfs.conf, nfs.flm, nfs.mon, tkit_module.sh, tkit_gen.sh, lockmigration.sh, nfs.1 and it’s softlink nfs. Known Problems and Workarounds The following describes known problems with the NFS Toolkit and workarounds for them.
This is due to exportfs -u, and the ESTALE is returned. When an interface is brought down, the routes do not get flushed immediately. Therefore, the server keeps temporarily responding after shutting down the interface. What is the workaround? Do the following steps on all the nodes, that are configured for running NFS package to set min_delay to zero, while the system is running: 1. Run the command # echo 0 > /proc/sys/net/ipv4/route/min_delay 2. Add the following line in /etc/sysctl.
After a package failover, or after an Serviceguard node is rebooted, the following error is displayed for an NFS client: RPC: Authentication Error The error occurs due to starting of rpc.mountd prior to nfsd daemons in the hanfs.sh script What is the fix? The hanfs.sh script is modified to start nfsd daemons before starting rpc.mountd daemon. Software Availability in Native Languages The NFS Toolkit for Linux is not available in native language versions. 12 Serviceguard NFS for Linux Version A.03.