Symantec Veritas Storage Foundation HP-UX User manual

N18486G
Veritas Storage Foundation™
Cluster File System
Installation Guide
HP-UX
5.0

Veritas Storage Foundation Cluster File System
Installation Guide
Copyright © 2006 Symantec Corporation. All rights reserved.
SFCFS 5.0
Symantec, the Symantec logo, Veritas, and Veritas Storage Foundation Cluster File
System are trademarks or registered trademarks of Symantec Corporation or its affiliates
in the U.S. and other countries. Other names may be trademarks of their respective
owners.
The product described in this document is distributed under licenses restricting its use,
copying, distribution, and decompilation/reverse engineering. No part of this document
may be reproduced in any form by any means without prior written authorization of
Symantec Corporation and its licensors, if any.
THIS DOCUMENTATION IS PROVIDED “AS IS” AND ALL EXPRESS OR IMPLIED
CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED
WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR
NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH
DISCLAIMERS ARE HELD TO BE LEGALLY INVALID, SYMANTEC CORPORATION SHALL
NOT BE LIABLE FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES IN CONNECTION
WITH THE FURNISHING PERFORMANCE, OR USE OF THIS DOCUMENTATION. THE
INFORMATION CONTAINED IN THIS DOCUMENTATION IS SUBJECT TO CHANGE
WITHOUT NOTICE.
The Licensed Software and Documentation are deemed to be “commercial computer
software” and “commercial computer software documentation” as defined in FAR
Sections 12.212 and DFARS Section 227.7202.
Symantec Corporation
20330 Stevens Creek Blvd.
Cupertino, CA 95014
www.symantec.com

Third-party legal notices
Third-party software may be recommended, distributed, embedded, or bundled
with this Veritas product. Such third-party software is licensed separately by its
copyright holder. All third-party copyrights associated with this product are
listed in the accompanying release notes.
HP-UX is a registered trademark of Hewlett-Packard Development Company, L.P.
Licensing and registration
Veritas Storage Foundation Cluster File System is a licensed product. See the
Veritas Storage Foundation Cluster File System Installation Guide for license
installation instructions.
Technical support
For technical assistance, visit http://support.veritas.com and select phone or
email support. Use the Knowledge Base search feature to access resources such
as TechNotes, product alerts, software downloads, hardware compatibility lists,
and our customer email notification service.

Contents
Chapter 1 Installing and configuring the product
Hardware overview ..............................................................................................10
Shared storage ..............................................................................................11
Fibre channel switch ...................................................................................11
Cluster platforms .........................................................................................11
Software components ..........................................................................................12
Required HP-UX patches ....................................................................................15
Preinstallation ......................................................................................................17
Release Notes ................................................................................................17
Product licensing .........................................................................................17
Setting PATH and MANPATH environment variables ..........................18
Secure communication ................................................................................18
Veritas Enterprise Administrator .............................................................19
Prerequisites .........................................................................................................19
Installing the product .........................................................................................20
Configuring the Components .............................................................................23
Using the log files ................................................................................................25
Installation log file .......................................................................................25
Response file .................................................................................................25
Summary file ................................................................................................25
Verifying the configuration files .......................................................................26
Low Latency Transport configuration files .............................................26
Checking Low Latency Transport operation ...........................................27
Group Membership and Atomic Broadcast configuration files ............29
Checking Group Membership and Atomic Broadcast operation ..........29
Checking cluster operation ........................................................................30
Verifying agent configuration ...........................................................................32
Synchronizing time on Cluster File Systems ...................................................32
Configuring VCS ...................................................................................................32
main.cf file ....................................................................................................33
SFCFS HA Only .............................................................................................34
VCS application failover services ......................................................................34

6
Chapter 2 Upgrading the product
Preparing to upgrade the product ..................................................................... 36
Planning the upgrade .................................................................................. 36
Upgrade paths .............................................................................................. 36
Upgrade Overview ............................................................................................... 38
Phased upgrade ............................................................................................ 38
Full upgrade .................................................................................................. 38
Upgrading from 3.5 to 5.0 .................................................................................. 39
Phased upgrade ............................................................................................ 39
Full upgrade .................................................................................................. 42
Upgrading from 4.1 to 5.0 .................................................................................. 45
Phased upgrade ............................................................................................ 45
Full upgrade .................................................................................................. 48
Upgrading the disk layout versions .................................................................. 50
Chapter 3 Adding and removing a node
Adding a node to a cluster .................................................................................. 54
Configuring SFCFS and CVM agents on the new node .................................. 56
Removing a node from a cluster ........................................................................ 57
Chapter 4 Uninstalling the product
Appendix A Troubleshooting and recovery
Installation issues ................................................................................................ 63
Incorrect permissions for root on remote system .................................. 63
Resource temporarily unavailable ............................................................ 64
Inaccessible system ..................................................................................... 64
Storage Foundation Cluster File System problems ........................................ 64
Unmount failures ........................................................................................ 65
Mount failures .............................................................................................. 65
Command failures ........................................................................................ 66
Performance issues ..................................................................................... 66
High availability issues ............................................................................... 67

Chapter 1
Installing and configuring
the product
This chapter describes how to install the Veritas Storage Foundation Cluster
File System (SFCFS). SFCFS requires several Veritas software packages to
configure a cluster and to provide messaging services. These packages include
the Veritas Cluster Server (VCS) to monitor systems and application services,
Veritas Low Latency Transport (LLT) and Veritas Group Membership and
Atomic Broadcast (GAB) for messaging and cluster membership, the Veritas
Volume Manager (VxVM) to create the shared volumes necessary for cluster file
systems, and the Veritas File System (VxFS) package.
Topics covered in this chapter include:
■Hardware overview
■Software components
■Preinstallation
■Prerequisites
■Installing the product
■Using the log files
■Verifying the configuration files
■Verifying agent configuration
■Synchronizing time on Cluster File Systems
■Configuring VCS
■VCS application failover services

10 Installing and configuring the product
Hardware overview
Hardware overview
VxFS cluster functionality runs optimally on a Fibre Channel fabric. Fibre
Channel technology provides the fastest, most reliable, and highest bandwidth
connectivity currently available. By employing Fibre Channel technology, SFCFS
can be used in conjunction with the latest Veritas Storage Area Network (SAN)
applications to provide a complete data storage and retrieval solution.
The figure below shows the configuration of a cluster file system on a Fibre
Channel fabric with a disk array.
Figure 1-1 Four Node SFCFS Cluster Built on Fibre Channel Fabric
Public
Fiber Optic Private LAN
Disk Array
Fibre Channel Switch
Fiber Optic Connection
Private
Network
Public

11Installing and configuring the product
Hardware overview
Shared storage
Shared storage can be one or more shared disks or a disk array connected either
directly to the nodes of the cluster or through a Fibre Channel Switch. Nodes can
also have non-shared or local devices on a local I/O channel. It is advisable to
have /, /usr, /var and other system partitions on local devices.
Fibre channel switch
Each node in the cluster must have a Fibre Channel I/O channel to access shared
storage devices. The primary component of the Fibre Channel fabric is the Fibre
Channel switch.
Cluster platforms
There are several hardware platforms that can function as nodes in a cluster file
system cluster.
See the Storage Foundation Cluster File System Release Notes.
Install the HP-UX 11i 64-bit operating system with the September 2004 HP-UX
11i Version 2.0 or later on each node and install a Fibre Channel host bus
adapter to allow connection to the Fibre Channel switch.
Note: For a cluster to work correctly, all nodes must have the same time. If you
are not running the Network Time Protocol (NTP) daemon, make sure the time
on all the systems comprising your cluster is synchronized.

12 Installing and configuring the product
Software components
Software components
Storage Foundation for Cluster File System is the name of the Veritas Cluster
File System product and its supporting software packages. Storage Foundation
Cluster File System HA (SFCFS HA) provides support for application failover
functionality of Veritas Cluster Server (VCS) in addition to other SFCFS features.
Packages installed with SFCFS only
The software packages listed below are required for implementing cluster file
system functionality. They are available on the software disc in the depot
directory and are installed on each node in the cluster using the installer
installation script.
The following table shows the package name and contents for each package:
Package Contents
VRTSperl Veritas Perl 5.8.8 Redistribution
VRTSvlic Veritas Licensing
VRTSicsco Symantec Common Infrastructure
VRTSpbx Symantec Private Branch Exchange
VRTSsmf Symantec Service Management Framework
VRTSat Symantec Product Authentication Service
VRTSobc33 Veritas Enterprise Administrator Core Service
VRTSob Veritas Enterprise Administrator Service
VRTSobgui Veritas Enterprise Administrator
VRTSccg Veritas Enterprise Administrator Central Control Grid
VRTSmh Veritas Centralized Management for Storage Foundation -
Managed Host
VRTSaa Veritas Enterprise Administrator Action Agent
VRTSspt Veritas Software Support Tools
SYMClma Symantec License Inventory Agent
VRTSllt Veritas Low Latency Transport
VRTSgab Veritas Group Membership and Atomic Broadcast
VRTSvxfen Veritas I/O Fen cing