About This Manual

This manual describes how to:

• Prepare for cluster installation.

• Install TruCluster^TM Server Version 5.1A software on the Compaq Tru64^TM UNIX Version 5.1A operating system and create a new cluster.

• Add members to a cluster.

• Perform a rolling upgrade from TruCluster Server Version 5.1 to TruCluster Server Version 5.1A.

• Upgrade a TruCluster Production Server cluster or Available Server configuration to a TruCluster Server Version 5.1A cluster. Upgrade a TruCluster Memory Channel Software cluster to TruCluster Server Version 5.1A.

Audience

This manual is for system administrators who install, configure, and administer the TruCluster Server product. The instructions in this manual assume that you are an experienced UNIX administrator who can configure and maintain hardware, operating systems, and networks.

New and Changed Features

The following changes have been made to this manual since the Version 5.1 release:

• Chapter 1 contains two new sections: Section 1.1 describes new or changed product features that affect installation and upgrades, and Section 1.3 provides an overview of the commands used to create and upgrade clusters.

• Chapter 2 includes some LAN IP address information. (The new Cluster LAN Interconnect manual contains the information needed to configure the hardware and install TruCluster Server on a cluster that has a LAN interconnect.)

  All restrictions about using the Logical Storage Manager (LSM) for the clusterwide root (/) and member swap file systems have been removed.

  Table 2-2 has increased the minimum requirements for member boot disk root and swap size from 128 MB to 256 MB.

  Section 2.4.5 now recommends that you have at least 50 MB free space on each member's boot partition when allocating disk space for rolling upgrades.

  Section 2.6 now includes a recommendation for setting the value of the boot_osflags console variable to A before booting a new member added with the clu_add_member command.

• Section 3.5.2 mentions that the clu_add_member command now provides information about the new member's boot disk to help you locate the correct disk from the new member's console.

• Chapter 5 is updated to include the disk location hints and the setting of the boot_osflags console variable to A before booting the new member.

• Because the supported upgrade path from TruCluster Server Version 5.0 is now a full installation, the chapter 'Upgrading from TruCluster Server Version 5.0' has been removed; the description of installation configuration files is now in Section 6.3.

• Chapter 7 describes how to use the rolling upgrade mechanism to install a New Hardware Delivery (NHD) kit on a Version 5.1A cluster. The chapter also includes tables that list the supported upgrade paths from Version 5.1 to Version 5.1A, and tables that list the differences between the Version 5.1 and Version 5.1A clu_upgrade commands. In addition, the chapter is reorganized to put the upgrade procedure at the beginning of the chapter.

• Chapter 8 includes information about TruCluster Server Version 5.1A support for LAN hardware as the cluster interconnect and server-only support for UNIX File System (UFS) read/write support. It also includes a new section that describes an upgrade option for TruCluster Memory Channel Software clusters that have little or no shared storage.

Organization

This manual is organized as follows:

Related Documents

Consult the following TruCluster Server manuals for assistance in understanding, configuring, installing, and administering clusters:

• TruCluster Server Software Product Description (SPD) — The authoritative description of the TruCluster Server Version 5.1A product. You can find the latest version of the SPD at the following URL:

  http://www.tru64unix.compaq.com/docs/pub_page/spds.html
   
  

• Cluster Technical Overview — Introduces the TruCluster Server product and provides descriptions of the major subsystems.

• Cluster Release Notes — Provides a brief introduction to new features in TruCluster Server and describes known problems and workarounds.

• Cluster Hardware Configuration — Describes how to set up the systems that will become cluster members, and how to configure cluster shared storage.

• Cluster LAN Interconnect — Describes how to use LAN hardware as the cluster interconnect.

• Cluster Administration — Describes cluster-specific administration tasks.

• Cluster Highly Available Applications — Describes how to deploy existing applications in a TruCluster Server cluster and how to write cluster-aware applications.

The TruCluster Server documentation is available on the World Wide Web at the following URL:

http://www.tru64unix.compaq.com/docs/pub_page/cluster_list.html
 

In addition, have available the following manuals from the Tru64 UNIX Version 5.1A documentation set:

• Installation Guide

• Installation Guide -- Advanced Topics

• Release Notes

• System Administration

• Network Administration: Connections

• Network Administration: Services

• Security

The Tru64 UNIX documentation is available on the World Wide Web at the following URL:

http://www.tru64unix.compaq.com/docs/

Icons on Tru64 UNIX Printed Manuals

The printed version of the Tru64 UNIX documentation uses letter icons on the spines of the manuals to help specific audiences quickly find the manuals that meet their needs. (You can order the printed documentation from Compaq.) The following list describes this convention:

Some manuals in the documentation help meet the needs of several audiences. For example, the information in some system manuals is also used by programmers. Keep this in mind when searching for information on specific topics.

The Documentation Overview provides information on all of the manuals in the Tru64 UNIX documentation set.

Online Documentation

The TruCluster Server documentation set is available on the Tru64 UNIX Documentation CD-ROM and on the Tru64 UNIX Associated Products Volume 2 CD-ROM in a format that is readable with a Web browser (HTML format) or with the Adobe Acrobat Reader (PDF format). In addition, the reference pages are available in HTML format.

If you are working on an Alpha^TM system, the operating system provides a Netscape browser for viewing the HTML documentation. If you want to view the documentation on a Windows PC or Macintosh, you will need a browser that supports Javascript 1.1. We recommend using Version 4.0 or higher of Netscape Navigator, Netscape Communicator, or Microsoft Internet Explorer.

Most cross-references are hot links that you can follow from book to book, from book to reference page, from reference page to book, and from reference page to reference page. The book or reference page to which you are referring opens in a separate window so that you can gather the information that you need and then easily return to the book or reference page that you were originally reading.

To read the HTML documentation using the Netscape browser:

1. Log in as the superuser.

2. Create a mount point for the cluster documentation:

   # mkdir /usr/share/doclib/online/clusters
    
   

3. Insert the CD-ROM into the CD-ROM drive and mount it.

   On a Tru64 UNIX Version 5.0 or later system:

   # mount -o rrip /dev/disk/cdromnc \
     /usr/share/doclib/online/clusters
    
   

   On a Tru64 UNIX system prior to Version 5.0:

   # mount -r -t cdfs -o rrip /dev/rznc \
     /usr/share/doclib/online/clusters
    
   

   In these commands, n is the unit number of your CD-ROM device.

4. After the CD-ROM is mounted, users can access the documentation with Netscape.

   From a terminal emulator window, start Netscape with the following command:

   % /usr/bin/X11/netscape&
    
   

   From the Common Desktop Environment (CDE) front panel, click on: Application Manager==>Desktop_apps==>Netscape

To view the PDF files, you must install Version 3.0 or higher of the Adobe Acrobat Reader. A suitable version of the Acrobat Reader for Tru64 UNIX, Windows PCs, Macintosh, and other platforms is included on the Tru64 UNIX Documentation CD-ROM. You can also obtain the latest version directly from the Adobe Systems Inc. Web site:

http://www.adobe.com
 

With the Acrobat Reader you can scroll through books, print selected sections or the entire book, and copy sections to the clipboard.

You can access the documentation in the TruCluster product area on the Associated Products Volume 2 CD-ROM on a Tru64 UNIX system, as well as on a variety of operating systems that use the ISO 9660 Level 1 CD-ROM standard.

To help you locate specific information in the TruCluster Server documentation, the Associated Products CD-ROM contains a copy of the AltaVista Search CD-ROM software with a complete index of the TruCluster Server HTML documents. (The Tru64 UNIX documentation CD-ROM includes the Master Index for the Tru64 UNIX manuals and the TruCluster Server manuals.) The AltaVista software runs on an x86-based PC with Windows 95, Windows 98, Windows 2000, or Windows NT Version 4.0.

Note

When documentation is accessed from the documentation CD-ROM or the Web, links to referenced documents will take you to those documents. These links to documents outside the TruCluster Server documentation set do not work when the TruCluster Server documentation is accessed from the Associated Products CD-ROM.

Reader's Comments

Compaq welcomes any comments and suggestions you have on this and other Tru64 UNIX manuals.

You can send your comments in the following ways:

• Fax: 603-884-0120 Attn: UBPG Publications, ZKO3-3/Y32

• Internet electronic mail: readers_comment@zk3.dec.com

  A Reader's Comment form is located on your system in the following location:

  /usr/doc/readers_comment.txt

Please include the following information along with your comments:

• The full title of the manual and the order number. (The order number appears on the title page of printed and PDF versions of a manual.)

• The section numbers and page numbers of the information on which you are commenting.

• The version of Tru64 UNIX that you are using.

• If known, the type of processor that is running the Tru64 UNIX software.

The Tru64 UNIX Publications group cannot respond to system problems or technical support inquiries. Please address technical questions to your local system vendor or to the appropriate Compaq technical support office. Information provided with the software media explains how to send problem reports to Compaq.

Conventions

This manual uses the following typographical conventions:

#

A number sign represents the superuser prompt.

% cat

Boldface type in interactive examples indicates typed user input.

file

Italic (slanted) type indicates variable values, placeholders, and function argument names.

.
.
.

A vertical ellipsis indicates that a portion of an example that would normally be present is not shown.

cat(1)

A cross-reference to a reference page includes the appropriate section number in parentheses. For example, cat(1) indicates that you can find information on the cat command in Section 1 of the reference pages.