HP Serviceguard Quorum Server Version A.03.
Legal Notices © Copyright 2006-2007 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.
Printing History Table 1 Printing History Printing Date Part Number Edition April 2007 B8467-90041 First Edition December 2007 B8467-90041 Reprinted The last printing date and part number indicate the current edition, which includes minor revisions.
HP Serviceguard Quorum Server Version A.03.00 Release Notes 1 Chapter 1 HP Serviceguard Quorum Server Version A.03.
HP Serviceguard Quorum Server Version A.03.00 Release Notes Announcements Announcements This edition of the release notes provides information about Quorum Server version A.03.00. This version: • Allows cluster nodes to communicate with the Quorum Server on an alternate subnet; see “Using Alternate Subnets” on page 19. • Increases the number of clusters a single quorum server can support; see “Operating System and Hardware Requirements” on page 10. HP Serviceguard Quorum Server A.03.
HP Serviceguard Quorum Server Version A.03.00 Release Notes Announcements Cluster Name Restrictions The following characters must not be used in the cluster name if you are using the Quorum Server: at-sign (@), equal-sign (=), or-sign (|), semicolon (;). These characters are deprecated, meaning that you should not use them, even if you are not using the Quorum Server, because they will be illegal in a future Serviceguard release.
HP Serviceguard Quorum Server Version A.03.00 Release Notes Using this Version Using this Version For support information see “Compatibility with Serviceguard Versions” on page 12; for instructions see “Configuring and Running the Quorum Server” on page 22. Getting the Software You can obtain Quorum Server free from HP’s software web site: http://software.hp.
HP Serviceguard Quorum Server Version A.03.00 Release Notes What Is the Quorum Server? What Is the Quorum Server? Serviceguard cluster products are specialized facilities for protecting mission-critical applications from a wide variety of hardware and software failures.
HP Serviceguard Quorum Server Version A.03.00 Release Notes System Requirements and Recommendations System Requirements and Recommendations System Requirements Operating System and Hardware Requirements The HP-UX version of Quorum Server version A.03.00 runs on HP 9000 servers, HP Integrity servers, and HP-UX workstations, running HP-UX 11i v1, 11i v2, or 11i v3. The Linux version runs on: • Any hardware specified in the HP Serviceguard for Linux Certification Matrix (which you can find at: http://www.hp.
HP Serviceguard Quorum Server Version A.03.00 Release Notes System Requirements and Recommendations Network Recommendations • Ideally the Quorum Server and the cluster or clusters it serves should communicate over a subnet that does not handle other traffic. (If you are using a version of Serviceguard that supports more than one subnet for communication with the Quorum Server, this should be true of both subnets.) This helps to ensure that the Quorum Server is available when it is needed.
HP Serviceguard Quorum Server Version A.03.00 Release Notes Compatibility with Serviceguard Versions Compatibility with Serviceguard Versions This version of the Quorum Server supports: IMPORTANT • Serviceguard clusters running Serviceguard 11.14 or later on HP-UX 11i v1, 11i v2 or 11i v3. • Serviceguard clusters running Serviceguard 11.14 or later on supported Red Hat or SUSE Linux distributions. The alternate-subnet capability is available only for Serviceguard A.11.
HP Serviceguard Quorum Server Version A.03.00 Release Notes Installing the Quorum Server Installing the Quorum Server Read this entire document and any other Release Notes or READMEs you may have before you begin an installation. The Quorum Server software, which has to be running during cluster configuration, must be installed on a system other than the nodes on which your cluster will be running. This could be a single Linux or HP-UX system, or it could be a separate cluster.
HP Serviceguard Quorum Server Version A.03.00 Release Notes Installing the Quorum Server Now create a directory for the Quorum Server log file. The recommended pathnames are in Table 1-2 on page 24. (You may need to create the directory.) Installing on Linux The install command for Linux uses the complete version name. The current version is A.03.00. Before installing, you can see the complete version name in the file name; after installing, you can get it by using the command rpm -q qs. Step 1.
HP Serviceguard Quorum Server Version A.03.00 Release Notes Updating the Quorum Server Updating the Quorum Server An update can be done while the cluster the Quorum Server server is running, but the Quorum Server’s tie-breaking services will not be available while the update is in progress (see “Replacing a Failed Quorum Server System” on page 28 for more details). If you are updating Serviceguard as well, the Quorum Server update must be done before you update Serviceguard.
HP Serviceguard Quorum Server Version A.03.00 Release Notes Updating the Quorum Server Updating the Quorum Server from A.02.xx or A.01.xx (Red Hat Linux) Step 1. Comment out the Quorum Server entry in /etc/inittab and run the following command: /sbin/init q Step 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. If this is your log file, you may want to save it before running this command. Step 3.
HP Serviceguard Quorum Server Version A.03.00 Release Notes Updating the Quorum Server Updating the Quorum Server from A.02.xx (SUSE Linux) An update can be done while the cluster is running. If you are updating Serviceguard as well, the Quorum Server update must be done before you update Serviceguard. Step 1. Comment out the Quorum Server entry in /etc/inittab and run the following command: /sbin/init q Step 2. Uninstall the existing Quorum Server. For example: rpm -e qs-A.02.
HP Serviceguard Quorum Server Version A.03.00 Release Notes Configuring Serviceguard to Use the Quorum Server Configuring Serviceguard to Use the Quorum Server About the QS Polling Interval and Timeout Extension Serviceguard probes the Quorum Server at intervals determined by the QS_POLLING_INTERVAL parameter in the cluster configuration file. The default value for QS_POLLING_INTERVAL is 5 minutes and the minimum value is 10 seconds.
HP Serviceguard Quorum Server Version A.03.00 Release Notes Configuring Serviceguard to Use the Quorum Server You can use the optional QS_TIMEOUT_EXTENSION to increase the time interval (in microseconds) after which the current connection (or attempt to connect) to the quorum server is deemed to have failed; see “Network Recommendations” on page 11 and “Setting Quorum Server Parameters in the Cluster Configuration File” on page 20.
HP Serviceguard Quorum Server Version A.03.00 Release Notes Configuring Serviceguard to Use the Quorum Server • You must be running a version of Serviceguard, and of Quorum Server, that support this capability. See “Compatibility with Serviceguard Versions” on page 12, and “System Requirements and Recommendations” on page 10. • All of the cluster nodes must be able to communicate with both of the Quorum Server subnets when you configure or reconfigure the cluster.
HP Serviceguard Quorum Server Version A.03.00 Release Notes Configuring Serviceguard to Use the Quorum Server The resulting file contains the QS_HOST, QS_POLLING_INTERVAL, and QS_TIMEOUT_EXTENSION parameters, and the QS_ADDR parameter if your version of Serviceguard supports it.
HP Serviceguard Quorum Server Version A.03.00 Release Notes Configuring and Running the Quorum Server Configuring and Running the Quorum Server NOTE • 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. • You can also configure the Quorum Server to run on a single system; see “Running the Quorum Server on a Single System” on page 25.
HP Serviceguard Quorum Server Version A.03.00 Release Notes Configuring and 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, you must update the authorization file before you run the package; see “Creating and Updating the Authorization File” on page 26. 1. Install the Quorum Server software on all nodes; see “Installing the Quorum Server” on page 13. 2.
HP Serviceguard Quorum Server Version A.03.00 Release Notes Configuring and Running the Quorum Server Table 1-1 Package Configuration File Parameters for qs-pkg (Continued) Parameter Value HALT_SCRIPT $SGCONF/qs-pkg/qs-pkg.ctl HALT_SCRIPT_TIMEOUT NO_TIMEOUT SERVICE_NAME qs SERVICE_FAIL_FAST_ENABLED NO SERVICE_HALT_TIMEOUT 10 SUBNET If the Quorum Server connection is on a single subnet, specify the subnet here. 5. Create a control script in the same directory: cmmakepkg -s qs-pkg.ctl 6.
HP Serviceguard Quorum Server Version A.03.00 Release Notes Configuring and Running the Quorum Server 7. Update the authorization file if necessary. See “Creating and Updating the Authorization File” on page 26. 8. Run the cluster and start the quorum server package. Running the Quorum Server on a Single System Specifying a Log File By default, Quorum Server run-time messages go to stdout and stderr.
HP Serviceguard Quorum Server Version A.03.00 Release Notes Configuring and Running the Quorum Server Start the Quorum Server as follows: init q Verify the Quorum Server is running by checking the qs.log file. (Recommended log pathnames are in Table 1-2 on page 24.) For HP-UX, enter: cat /var/adm/qs/qs.log For Linux, enter: cat /var/log/qs/qs.
HP Serviceguard Quorum Server Version A.03.00 Release Notes Configuring and Running the Quorum Server NOTE If you are specifying an alternate subnet (for clusters running a version of Serviceguard that supports it; see “Compatibility with Serviceguard Versions” on page 12) you must specify both IP addresses by which each node can be reached, for example: ftsys9.localdomain.com 10.10.10.20 #alternate IP address on ftsys9 ftsys10.localdomain.com 10.10.10.
HP Serviceguard Quorum Server Version A.03.00 Release Notes Replacing a Failed Quorum Server System Replacing a Failed Quorum Server System Use the following procedure to replace a defective Quorum Server system without changing the configuration of any cluster nodes. 1. Remove the old Quorum Server system from the network. 2. Set up the new system and configure it with the old Quorum Server’s IP address(es) and hostname(s).
HP Serviceguard Quorum Server Version A.03.00 Release Notes Replacing a Failed Quorum Server System 7. To check that the Quorum Server has been correctly configured and to verify the connectivity of a node to the Quorum Server, you can execute the following command from your cluster nodes as follows: cmquerycl -q -n -n ... or (if you are using more than one subnet; see “Using Alternate Subnets” on page 19): cmquerycl -q -n -n ...
HP Serviceguard Quorum Server Version A.03.
HP Serviceguard Quorum Server Version A.03.00 Release Notes Patches, Fixes, and Known Problems in this Version Patches, Fixes, and Known Problems in this Version This section describes patches that are required, defects that have been fixed in version A.03.00 of Quorum Server, and known problems. Patches The new functionality provided by this version of Quorum Server (that is, the ability to configure and alternate subnet) is currently supported only in Serviceguard A.11.
HP Serviceguard Quorum Server Version A.03.00 Release Notes Software Availability in Native Languages Software Availability in Native Languages HP Serviceguard Quorum Server Version A.03.00 does not provide Native Language Support.