Table of Contents

Installation Guide

Contents

About This Guide

Chapter 1: Overview of the Installation Process

Overview of the Installation Tasks

Step 1: Installing HACMP on Server Nodes

Step 2: Installing HACMP on Client Nodes

Overview of the Cluster Creation Tasks

Step 1: Creating an HACMP Cluster

Step 2: Configuring an HACMP Cluster

Overview of the Migration Tasks

Where to Find Documentation

Chapter 2: Creating Shared LVM Components

Prerequisites

Logical Volumes

Configuring HACMP to Use NFS Version 4

Step 1: Configuring NFS and Changing to Version 4

Step 2: Configuring the NFS Local Domain

Step 3: Adding the NFS Directory to the Exports List

Step 4: Adding the NFS for Mounting

Step 5: Editing the /etc/filesystems file

Step 6: Editing the /usr/es/sbin/cluster/etc/exports file

Step 7: Removing Entries from /etc/exports

Where You Go from Here

Chapter 3: Upgrading an HACMP Cluster

Overview

Prerequisites

Terminology Overview

Identifying Your Upgrade Path

Supported Upgrade Paths

Upgrading from Pre-5.1 Versions of HACMP

Choosing Your Upgrade Scenario

Planning for an Upgrade

Updating the Current Cluster Configuration

Checking Cluster Condition, Settings, and Worksheets

Reviewing the Cluster and Node Version in the HACMP Configuration Database

Checking Types of Networks

Migrating Resource Groups Configured without Sites

Upgrading Applications Configured Using a Smart Assist

Ensuring Applications Use Proprietary Locking Mechanism

Addressing Concurrent Access (AIX 5L) Migration Issues

Priority Override Location and Persistence

Notes on Upgrading from HACMP 5.1

HACMP 5.4 Inter-Site Selective Fallover for Resource Group Recovery

Upgrade Do’s and Don’ts

Upgrade Do’s

Upgrade Don’ts

Checking That the Software Is Committed

Performing a Rolling Migration to HACMP 5.4

Step 1: Stop Cluster Services on a Node Hosting the Application

Step 2: Install the HACMP 5.4 Software

Step 3: Reboot the Node

Step 4: Start Cluster Services on the Upgraded Node

Step 5: Repeat Steps for Other Cluster Nodes

Step 6: Verify the Upgraded Cluster Definition

Upgrading to HACMP 5.4 Using a Snapshot

Step 1: Creating a Snapshot

Step 2: Stopping All Nodes

Step 3: Removing the Existing Version of the HACMP Software

Step 4: Installing the HACMP 5.4 Software

Step 5: Converting and Applying a Saved Snapshot

Step 6: Verifying the Upgraded Cluster Definition

Upgrading to HACMP 5.4 on an Offline Cluster

Applying a PTF

Step 1: Stop Cluster Services on a Node Hosting the Application

Step 2: Install the PTF Update

Step 3: Start Cluster Services on the Upgraded Node

Step 4: Repeat Steps for Other Cluster Nodes

Step 5: Verify the Upgraded Cluster Definition

Additional Migration Tasks

Recompiling Clinfo Clients after Migrating to HACMP 5.4

Using a Web-Based Interface for Configuration and Management

Resetting HACMP Tunable Values

Verifying the Success of Your Migration

Verifying Software Levels Installed Using AIX 5L Commands

Automatically Saved Files

Verifying the Upgraded Cluster Definition

Verifying All Cluster Filesets Have Migrated

Testing HACMP on the Upgraded Cluster

Running AIX 5L Commands on the Migrated Cluster

Troubleshooting Your Migration

Error: “config_too_long”

Error: “cldare cannot be run”

Recovering Your Previous Version of HACMP

Recovering from a Conversion Failure

Recovering Configuration Information

Chapter 4: Installing HACMP on Server Nodes

Prerequisites

Supported Hardware

Disk Space Requirements

Required Versions of AIX 5L and RSCT

Security Fileset Requirements

HAView Requirements

Tivoli Requirements

English and Japanese Message Catalogs

Contents of the Installation Medium

HACMP Installable Images

HACMP Installation Choices

Installing from an Installation Server

Installing from a Hard Disk

Copying HACMP Software to Hard Disk

Installing HACMP from the Hard Disk

Installing HACMP on an SP from the Hard Disk

Installing from the Installation Medium

Completing the Installation

Verifying the Software Installation

Addressing Problems during the Installation

Cleaning up after an Unsuccessful Installation

Resolving System ID Licensing Issues

Removing the HACMP Software

Installing and Configuring WebSMIT

Planning for WebSMIT

Prerequisites Tasks for Installing WebSMIT

Steps for Installing and Configuring WebSMIT

Upgrading from a Previous Configuration

Where You Go from Here

Chapter 5: Installing HACMP on Client Nodes

Prerequisites

Overview

Installing and Configuring HACMP on Client Systems

Step 1: Installing the Base System Client Images

Step 2: Copying the clhosts.client File onto Client Nodes

Step 3: Editing the clinfo.rc Script

Step 4: Updating the ARP Cache for Clients Not Using Clinfo

Step 5: Rebooting the Clients

Chapter 6: Configuring Installed Hardware

Configuring Network Interface Cards

Ethernet, Token-Ring, and FDDI Interface Cards

Completing the TCP/IP Network Interface Worksheets

Configuring Point-to-Point Networks

Configuring RS232 Serial Connections

Configuring an RS232 Serial Connection in AIX 5L

Testing the Serial Connection

Defining the Serial Connection to HACMP

Configuring an SP Switch

Configuring for Asynchronous Transfer Mode (ATM)

Support of Classic IP and LANE on the Same Interface Card

Configuring ATM Classic IP

Configuring Classic IP for HACMP Cluster Networks

Testing the Configuration

Configuring ATM ARP Servers for Use by HACMP Nodes

Configuring ATM ARP Servers for Service Subnetworks

Configuring ATM ARP Servers for Non-Service Subnetworks

Configuring ATM ARP Clients on Cluster Nodes

Testing Communication over the Network

Defining the ATM Network to HACMP

Configuring ATM LAN Emulation

Defining the ATM LAN Emulation Network to HACMP

Configuring Shared External Disk Devices

Configuring Shared Fibre Channel Disks

Configuring Shared SCSI Disks

Configuring IBM SCSI Disk Arrays

Configuring Target Mode SCSI Connections

Configuring the Status of SCSI Adapters and Disks

Configuring Target Mode SCSI Devices in AIX 5L

Testing the Target Mode Connection

Defining the Target Mode SCSI Connection to HACMP

Configuring Target Mode SSA Connections

Changing Node Numbers on Systems in SSA Loop

Configuring Target Mode SSA Devices in AIX 5L

Testing the Target Mode Connection

Configuring Shared IBM SSA Disk Subsystems

Defining the Target Mode SSA Connection to HACMP

Installing and Configuring Shared Tape Drives

Installing Shared SCSI Tape Drives

Installing and Configuring Shared Fibre Tape Drives

Configuring the Installation of a Shared Tape Drive

Chapter 7: Defining Shared LVM Components

Overview

Defining Shared LVM Components for Non-Concurrent Access

Defining Shared LVM Components

Creating a Shared Volume Group on Source Node

Creating a Shared Filesystem on Source Node

Renaming jfslogs and Logical Volumes on Source Node

Adding Copies to Logical Volume on Source Node

Testing a Filesystem

Varying Off a Volume Group on the Source Node

Collecting Information on Current Volume Group Configuration

Importing a Volume Group onto Destination Nodes

Changing a Volume Group’s Startup Status

Varying Off Volume Group on Destination Nodes

Defining LVM Components for Concurrent Access

Creating a Concurrent Access Volume Group on a Source Node

Chapter 8: Configuring AIX 5L for HACMP

I/O Considerations

I/O Pacing

Syncd Frequency

Networking Considerations

Checking User and Group IDs

Configuring Network Options

Changing routerevalidate Network Option

Updating the /etc/hosts File and nameserver Configuration

Setting up NIS-Managed Users to Create Crontabs

Enabling the AIX 5L Automounter Daemon

Planning HACMP File Collections

Default HACMP File Collections

Types of Error Notification

AIX 5L Error Notification Facility

HACMP Automatic Error Notification

Error Notification Method Used for Volume Group Loss

Emulation of Error Log Entries

SP-Specific Considerations

SP Switch Address Resolution Protocol (ARP)

SP Switch Global Network Failure Detection and Action

Chapter 9: Creating a Basic HACMP Cluster

Overview

HACMP Cluster Definition

Resource Group Policies

Prerequisites

TCP/IP Connectivity

Copy of the Application

Start Scripts and Stop Scripts

Volume Groups

Service IP Label/Address

HACMP Software

Planning a Two-Node Cluster

Using the Two-Node Cluster Configuration Assistant

User Privileges

Existing Clusters

Using the Standalone Assistant

Using the SMIT Assistant

Logging for the Two-Node Cluster Configuration Assistant

Preventing Single Points of Failure

Where You Go from Here

Appendix A: Cluster Monitoring with Tivoli

Appendix B: OEM Disk, Volume Group, and Filesystems Accommodation

Appendix C: GPFS Cluster Configuration

Appendix D: HACMP and SNMP Utilities

Notices for HACMP Installation Guide

Index