HP Serviceguard Quorum Server Version A.04.
Legal Notices © Copyright 2006-2009 Hewlett-Packard Development Company, L.P. 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 Printing History .............................................................................................................................7 1 HP Serviceguard Quorum Server Version A.04.00 Release Notes...................................................9 Announcements....................................................................................................................9 Cluster Name Restrictions...............................................................................
Known Problems and Workarounds.............................................................................25 Software Availability in Native Languages .......................................................................
List of Tables 1 1-1 1-2 Printing History............................................................................................................7 Package Configuration File Parameters for qs-pkg....................................................20 Package Control Script Parameters for qs-pkg...........................................................
Printing History Table 1 Printing History Printing Date Part Number Edition March 2009 B8467-90045 First Edition The last printing date and part number indicate the current edition.
1 HP Serviceguard Quorum Server Version A.04.00 Release Notes Announcements This edition of the release notes provides information about Quorum Server version A.04.00. This version: • Allows Serviceguard A.11.19 cluster nodes to communicate with the Quorum Server on an alternate subnet; see “Using Alternate Subnets” (page 17). IMPORTANT: This version is required if you intend to use an alternate subnet with Serviceguard A.11.19, and must be installed before you upgrade an A.11.
Using this Version For support information see “Compatibility with Serviceguard Versions” (page 12); for instructions see “Configuring and Running the Quorum Server” (page 19). Getting the Software You can obtain Quorum Server free from HP’s software web site: http://software.hp.com -> High Availability -> ServiceGuard Quorum Server The version of the software you download is determined by the operating system you specify on the download page.
Within the restrictions specified under “System Requirements” (page 11), a Quorum Server running on either a Linux or an HP-UX system can serve a Serviceguard for Linux cluster, an HP-UX Serviceguard cluster, or a combination of clusters of both types. The Quorum Server uses TCP/IP, and listens to connection requests from the Serviceguard nodes on port # 1238.
A Quorum Server can provide quorum services for multiple HP-UX or Linux clusters, or a combination of both, up 150 clusters but not exceeding 300 nodes in all. CAUTION: Make sure that each cluster served by a given Quorum Server has a unique cluster name. Serviceguard normally enforces this, but under some circumstances (for example if the clusters are on different subnets) Serviceguard will not be able to detect a duplicate name. See also “Network Recommendations” (page 12).
IMPORTANT: The alternate-subnet capability is available only for Serviceguard A.11.17 on HP-UX 11i v2 with patch PHSS_35427, and for Serviceguard A.11.18 (with October 2007 or later patch) and A.11.19 on both HP-UX and Linux. See the latest version of the corresponding Serviceguard A.11.18 Release Notes for required patches for Serviceguard A.11.18. Quorum Server version A.04.00 is required if you are using an alternate subnet for communication with a Serviceguard A.11.
The Quorum Server executable file, qs, is installed in the /usr/lbin directory. When the installation is complete, you need to create an authorization file on the server where the Quorum Server will be running, to allow specific cluster nodes to obtain quorum services. See “Creating and Updating the Authorization File” (page 22). Now create a directory for the Quorum Server log file. The recommended pathnames are in Table 1-2 (page 21). (You may need to create the directory.
2. Uninstall the existing Quorum Server: swremove B8467BA 3. Install Quorum Server A.04.00: swinstall B8467BA 4. 5. Uncomment the Quorum Server entry in the /etc/inittab file. Start the Quorum Server: /sbin/init q Updating the Quorum Server (Red Hat Linux) 1. Comment out the Quorum Server entry in /etc/inittab and run the following command: /sbin/init q 2. Uninstall the existing Quorum Server. For example: rpm -e qs-A.02.04 CAUTION: This command may remove the file /var/log/qs/qs.log.
CAUTION: This command may remove the file /var/log/qs/qs.log. If this is your log file, you may want to save it before running this command. 3. Install the version of Quorum Server A.04.00 appropriate to your distribution and hardware. For example: rpm -ihv qs-A.04.00.00-0.sles10.i386.rpm 4. 5. Uncomment the entry you commented out in /etc/inittab.
Using Alternate Subnets Some versions of Serviceguard (see “Compatibility with Serviceguard Versions” (page 12)) support new functionality in the Quorum Server that allows you to configure more than one subnet on which communication between the Quorum Server and the cluster nodes can take place. In this case, you configure a primary subnet (indicated by the QS_HOST parameter in the cluster configuration file) and a second subnet (indicated by QS_ADDR in the cluster configuration file).
NOTE: If you are using a version of Serviceguard that supports alternate subnets (see “Compatibility with Serviceguard Versions” (page 12)), you can specify a second hostname or IP address in the -q option (all one line): cmquerycl -q -n -n -C .config QS_Host and QS_Addr can each be either a fully qualified hostname or an IP address.
3. Edit the resulting file. Change the value of the QS_HOST parameter to an IPv6 address, or a hostname that resolves to an IPv6 address. Add the QS_ADDR parameter, and a second IPv6 address or hostname that resolves to an IPv6 address. Configuring and Running the Quorum Server • • You can configure the Quorum Server as a monitored package in one Serviceguard cluster to provide quorum service to another Serviceguard cluster or clusters; see “Creating a Package for the Quorum Server” below.
cd qs-pkg 3. Create a package configuration file: cmmakepkg -P qs-pkg.config 4. Edit the parameter values in the file as follows. Table 1-1 Package Configuration File Parameters for qs-pkg 5. Parameter Value PACKAGE_NAME qs-pkg PACKAGE_TYPE FAILOVER FAILOVER_POLICY CONFIGURED_NODE FAILBACK_POLICY MANUAL NODE_NAME * AUTO_RUN YES LOCAL_LAN_FAILOVER_ALLOWED YES NODE_FAIL_FAST_ENABLED NO RUN_SCRIPT $SGCONF/qs-pkg/qs-pkg.
Table 1-2 Package Control Script Parameters for qs-pkg Parameter Value IP[] IP address(es) to be used when accessing the Quorum Server. If you are using more than one subnet for communicate between the Quorum Server and the cluster nodes, make sure each address is on a different subnet. SUBNET[] Specify your subnet(s) here SERVICE_NAME[0] qs SERVICE_CMD[0] (>> Redirect file in this example shows recommended log pathnames) HP-UX: /usr/lbin/qs >> /var/adm/qs/qs.
Running the Quorum Server NOTE: If you have just installed the quorum server, or if you are adding new cluster nodes, or implementing the alternate-subnet functionality (for a cluster running a version of Serviceguard that supports it; see “Compatibility with Serviceguard Versions” (page 12)) you must update the authorization file; see “Creating and Updating the Authorization File” (page 22). You must have root capability to run the Quorum Server.
Enter into the file the fully-qualified hostnames, or IP addresses, of all the cluster nodes that will obtain quorum services from this Quorum Server. Use one line per node, for example: ftsys9.localdomain.com ftsys10.localdomain.com NOTE: If you are specifying an alternate subnet (for clusters running a version of Serviceguard that supports it; see “Compatibility with Serviceguard Versions” (page 12)) you must specify both IP addresses by which each node can be reached, for example: ftsys9.localdomain.
• 5. 6. Edit the /etc/inittab file to add the Quorum Server entries, as shown in “Installing the Quorum Server” (page 13). • Use the init q command to run the Quorum Server. Refer to the qs(1) man page for more details. All nodes in all clusters that were using the old Quorum Server will connect to the new Quorum Server. Use the cmviewcl -v command from any cluster that is using the Quorum Server to verify that the nodes in that cluster have connected to the Quorum Server.
Patches Apart from the patch mentioned under “Compatibility with Serviceguard Versions” (page 12), no other patches are needed for version A.04.00 at the time of publication. Contact your Hewlett-Packard support representative for up-to-the-moment information. Patches can be created, superseded, or withdrawn at any time without notice. An updated list of patches is available on the Hewlett-Packard IT Resource Center site: http://itrc.hp.com (Americas and Asia Pacific) or http:// europe.itrc.hp.com (Europe).
