OCFS2 integration with HP Serviceguard for Linux administrator's guide HP Part Number: 5992-6352 Published: May 2009 Edition: 2
© Copyright 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 About This Document.........................................................................................................7 Intended Audience.................................................................................................................................7 Document Organization.........................................................................................................................7 Typographic Conventions.....................................................
List of Figures 2-1 2-2 2-3 4 Configuration Scenario..................................................................................................................16 OCFS2 Network Idle Timeout Definitions....................................................................................19 OCFS2 Disk Heartbeat Timeout Definitions.................................................................................
List of Tables 2-1 2-2 HP Serviceguard A.11.18 and OCFS2 Values................................................................................20 HP Serviceguard A.11.19 and OCFS2 Values................................................................................
About This Document This document describes the integration of Oracle Cluster File System 2 (OCFS2) with HP Serviceguard for Linux on SUSE Linux Enterprise Server 10 (SP1 and SP2). This document highlights the features of OCFS2 and HP Serviceguard for Linux individually, and elaborates on the benefits of integrating the two solutions. Intended Audience This document is intended for system administrators who manage clusters in their environment.
| Separates items in a list of choices. WARNING A warning calls attention to important information that if not understood or followed will result in personal injury or nonrecoverable system problems. CAUTION A caution calls attention to important information that if not understood or followed will result in data loss, data corruption, or damage to hardware or software.
HP Encourages Your Comments HP encourages your comments concerning this document. We are committed to providing documentation that meets your needs. Send any errors found, suggestions for improvement, or compliments to: docsfeedback@hp.com. Include the document title, manufacturing part number, and any comment, error found, or suggestion for improvement you have concerning this document.
1 Introduction This chapter elaborates on the features of Oracle Cluster File System (OCFS2) and the benefits of integrating it with HP Serviceguard for Linux. This chapter addresses the following topics: • “Overview of OCFS2” (page 11) • “Overview of HP Serviceguard for Linux” (page 12) • “Benefits of OCFS2 in an HP Serviceguard for Linux Environment” (page 13) Overview of OCFS2 Oracle Cluster File System 2 (OCFS2) is an independent cluster file system.
NOTE: OCFS2 does not include support for any cluster volume manager. Overview of HP Serviceguard for Linux HP Serviceguard for Linux is a software that allows you to create high availability clusters of HP ProLiant or HP Integrity Servers. Redundant configurations ensure high availability of application services running on systems. In such configurations, in the event of hardware or software failure, application services continue to run with minimal downtime.
For more information on HP Serviceguard for Linux and its features, see the following documents: • Managing HP Serviceguard for Linux, Eighth Edition available at: http://docs.hp.com —> High Availability —> Serviceguard for Linux • Keep your business running with HP Serviceguard for Linux whitepaper. Benefits of OCFS2 in an HP Serviceguard for Linux Environment Following are the benefits of the OCFS2 with HP Serviceguard for Linux integration: • Support for a clustered file system.
2 Integrating OCFS2 with HP Serviceguard for Linux This chapter describes the procedure and related information to integrate OCFS2 with HP Serviceguard for Linux.
Prerequisites for Integrating OCFS2 with HP Serviceguard for Linux Following are the hardware and configuration prerequisites for integrating OCFS2 with HP Serviceguard for Linux. • Hardware Requirements — A minimum of three network interface cards. However, it is preferable to use four or more network interface cards. — Shared storage device. • Configuration Requirements — At least one public network interface for clients to access the nodes.
independent redundant network connections. As a workaround, multiple network interfaces can be bonded using Linux channel bonding and presented to OCFS2 as a single interface. HP Serviceguard must be configured to send heartbeat only on this bonded interface. Multiple individual heartbeat networks for HP Serviceguard is not supported in this integrated environment as Serviceguard needs to see the same heartbeat failure that is seen by OCFS2. This bonding is the only way to achieve heartbeat redundancy.
1. Upgrade the toolkit on all nodes in the cluster. # ocfs2mntadmn upgrade node 2. Upgrade all packages that are configured with HP Serviceguard A.11.18. IMPORTANT: OCFS2 mount point packages that mount or unmount disks configured with OCFS2 clustered file system have an added level of protection called Persistent Reservation, available when configured with HP Serviceguard A.11.19. For more information on Persistent Reservation, see the Managing HP Serviceguard for Linux guide available at http://docs.
Figure 2-2 OCFS2 Network Idle Timeout Definitions In the figure, t0, t1, t2, t3, and t4 represent the time at which HP Serviceguard for Linux and OCFS2 realize that there is a network failure. Following is the sequence of events: 1. At t0, network links that carry the Serviceguard heartbeat, OCFS2 data, and the TCP connection is lost. 2. At t1, HP Serviceguard for Linux recognizes that there is a network failure, due to the loss of the heartbeat. 3.
Table 2-1 HP Serviceguard A.11.
Figure 2-3 OCFS2 Disk Heartbeat Timeout Definitions In the figure, t0, t1, t2, t3, and t4 represent the time at which HP Serviceguard for Linux and OCFS2 realize that there is a disk access failure. Following is the sequence of events: 1. 2. 3. 4. 5. At t0, a node loses connectivity to a storage device because of an FC link failure. This loss of connectivity immediately halts the I/O from all nodes for a duration which is equal to the timeout of the I/O layer.
O2CB_HEARTBEAT_THRESHOLD = (((60 seconds + 30 seconds)/2) + 1) O2CB_HEARTBEAT_THRESHOLD = 46 For more information on configuring the O2CB_HEARTBEAT_THRESHOLD parameter, see the Configuring Cluster Timeouts section in the OCFS2 – Frequently Asked Questions document. This document is available at the following location: http://oss.oracle.com/projects/ocfs2/dist/documentation/ocfs2_faq.
slots that are used by the cluster nodes to perform the disk heartbeat. The total number of cluster nodes which can heartbeat are less than or equal to the value of the -N option. If, at a later time, you need to increase the number of nodes in the cluster, change the value of the -N option. However, once set at a higher value, the value of -N cannot be set to a lesser value. In the example shown above, -N option is set at 4 which creates 4 node slots on the device, /dev/ sdf1.
3 Working with Administrative Commands This chapter describes the administrative commands that can be used in an environment that has OCFS2 integrated with Serviceguard for Linux.
Completed the cluster update OCFS2 is now configured Starting OCFS2...
Checking existing configuration ... Done Parsing package file: /opt/cmcluster/ocfs2/ocfs2mntadm.conf .21653. Attempting to add package SG-OCFS2-MP-1. Validation for package SG-OCFS2-MP-1 succeeded via /opt/cmcluster/conf/scripts/mscripts/master_control_script.sh. WARNING: Invalid system multi-node package name: SG-OCFS2-pkg Maximum configured packages parameter is 150. Configuring 2 package(s). 148 package(s) can be added to this cluster. 200 access policies can be added to this cluster.
For example, to view the contents of all configured mount point packages, run the command: # ocfs2mntadm display To view the contents of the mount point package SG-OCFS2-MP-1, run the command: # ocfs2mntadm display -p SG-OCFS2-MP-1 To remove a previously configured mount point multi-node package, run the following command: # ocfs2mntadm unconfig -p For example, to unconfigure the mount point package SG-OCFS2-MP-1, run the following command: # ocfs2mntadm unconfig -p SG-OCFS2-MP-1 To view the
A Blank Planning Worksheets This appendix contains a blank worksheet that you can print and use when you are integrating OCFS2 with HP Serviceguard for Linux.
Glossary C to S CRT Cluster Reformation Time DLM Distributed Lock Manager.
Index I integrate OCFS2 with HP Serviceguard for Linux, 15 Integrating guidelines, 15 prerequisites, 16 Integration Overview, 15 O O2CB Cluster Manager, 11 OCFS2 Oracle Cluster File System 2, 11 OCFS2 file system creating, 22 OCFS2 Mount Point Packages, 23 OCFS2 mount point packages default name SG-OCFS2–MP-#, 23 OCFS2 with HP Serviceguard for Linux installing, 17 ocfs2cluster, 25 create, configure, apply, 25 remove package, 25 start, stop packages, 25 view manpage, 25 ocfs2mntadm, 26 add resources, 26 cre