OCFS2 Integration with HP Serviceguard for Linux Administrator's Guide HP Part Number: 5992-5333 Published: November 2008 Edition: 1
© Copyright 2008 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..................................................................................................................14 OCFS2 Network Idle Timeout Definitions....................................................................................16 OCFS2 Disk Heartbeat Timeout Definitions.................................................................................
List of Tables 2-1 HP Serviceguard 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.
WARNING A warning calls attention to important information that if not understood or followed will result in personal injury or nonrecoverable system problems. 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. This alert provides essential information to explain a concept or to complete a task A note contains additional information to emphasize or supplement important points of the main text.
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 9) • “Overview of HP Serviceguard for Linux” (page 10) • “Benefits of OCFS2 in an HP Serviceguard for Linux Environment” (page 11) 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.
— 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. For availability, this must be configured as a bonded network using an additional network card. — Two network interface cards configured as a private network with Linux channel bonding for OCFS2 data and Serviceguard Heartbeat.
IMPORTANT: The client network which is shown as a single network (eth2) in Figure 2-1 (page 14) can also be configured with another network HBA as a channel bonded interface for redundancy. However, HP Serviceguard for Linux must not be configured to exchange heartbeat through this public network. Installing OCFS2 in a Serviceguard for Linux Environment This section elaborates on the procedures for installing OCFS2 in a Serviceguard environment.
3. 4. O2CB_KEEPALIVE_DELAY_MS O2CB_RECONNECT_DELAY_MS These parameters and the timeout values are stored in the file /etc/sysconfig/o2cb on all the cluster nodes. Configuring the O2NET_IDLE_TIMEOUT Parameter The O2NET_IDLE_TIMEOUT parameter refers to the OCFS2 network idle timeout. This parameter of OCFS2 specifies the time in milliseconds before a network connection is considered dead.
according to figure 1, the time period between t0 and t3 is 28 seconds. So, using the formula, the O2CB_NET_IDLE_TIMEOUT parameter is set to 48000 milliseconds. O2CB_IDLE_TIMEOUT_MS = (28 seconds + 20 seconds) x 1000 O2CB_IDLE_TIMEOUT_MS = 48000 milliseconds Table 2-1 lists the various HP Serviceguard heartbeat intervals, the corresponding cluster reconfiguration time and the recommended values for the O2CB_NET_IDLE_TIMEOUT values.
Figure 2-3 OCFS2 Disk Heartbeat Timeout Definitions t0 t1 t2 t3 t4 ODFS2 Disk Heartbeat times out. Serviceguard TOC’s node once disk monitor service fails. I/O layer times out. Disk monitor hangs when it tries to access the failed device. Storage links from a node are lost. I/O to disks are halted for a duration equal to the I/O timeout. 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.
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.html Configuring the O2CB_KEEPALIVE_DELAY_MS Parameter The Network Keep-alive parameter specifies the maximum delay in milliseconds before a keep-alive packet is sent.
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. This value allows a minimum of 1 and a maximum of 4 nodes to mount and use the OCFS2 file system 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, 13 Integrating guidelines, 13 prerequisites, 13 Integration Overview, 13 O O2CB Cluster Manager, 9 OCFS2 Oracle Cluster File System 2, 9 OCFS2 file system creating, 19 OCFS2 Mount Point Packages, 20 OCFS2 mount point packages default name SG-OCFS2–MP-#, 20 OCFS2 with HP Serviceguard for Linux installing, 15 ocfs2cluster, 21 create, configure, apply, 21 remove package, 21 start, stop packages, 21 view manpage, 21 ocfs2mntadm, 22 add resources, 22 creat