About This Manual

This manual describes how to move applications to the TruCluster^TM Server environment, and how to use TruCluster Server functionality to make applications highly available.

This manual also describes how to use TruCluster Server application programming interfaces (APIs) to take advantage of cluster technologies such as the distributed lock manager (DLM), cluster alias, and Memory Channel.

Read the TruCluster Server Cluster Technical Overview for an understanding of the TruCluster Server cluster subsystems before moving applications to your TruCluster Server environment.

Audience

This manual is intended for system administrators who want to deploy highly available applications on TruCluster Server or move applications from a TruCluster Available Server or TruCluster Production Server to a TruCluster Server environment. This manual is also intended for developers who want to write distributed applications that need the synchronization services of the DLM, alias functionality, or the high-performance capabilities of the Memory Channel.

New and Changed Features

Section 2.12.2 is a new section; it explains how to create a single-instance, highly available Apache HTTP Server using the cluster application availability (CAA) subsystem.

Section 4.6 is revised to provide more information on process identification (PID) numbers available to cluster members.

Section 7.7 is a new section; it describes how to test the status of a cluster member during a rolling upgrade.

Section 7.8 is a new section; it discusses file access resilience in a cluster.

Organization

This manual is organized as follows:

Part 1	Describes how to get single-instance and multi-instance applications up and running on TruCluster Server.
Chapter 1	Describes the general types of cluster applications.
Chapter 2	Describes how to use the cluster application availability (CAA) facility for single-instance application availability on TruCluster Server.
Chapter 3	Describes how to use the default cluster alias for multi-instance application availability on TruCluster Server.
Part 2	Describes how to move applications to a TruCluster Server environment.
Chapter 4	Discusses general issues to consider before moving applications to TruCluster Server.
Chapter 5	Describes how to move Available Server Environment (ASE)-style applications to TruCluster Server.
Chapter 6	Describes how to move distributed applications to TruCluster Server.
Part 3	Describes how to use APIs to take advantage of TruCluster Server technology.
Chapter 7	Describes how to change an application's source code to allow it to run in a clusterized environment.
Chapter 8	Describes how to use the features of the cluster alias API.
Chapter 9	Describes how to use the features of the DLM.
Chapter 10	Describes how to use the Memory Channel API library.

Related Documents

Consult the following TruCluster Server documentation for assistance in cluster configuration, installation, and administration tasks:

TruCluster Server Software Product Description (SPD) -- The comprehensive 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
 
```

TruCluster Server Cluster Technical Overview -- Provides an overview of the TruCluster Server technology.

TruCluster Server Cluster Release Notes -- Provides important information about TruCluster Server Version 5.1A, including new features, known problems, and workarounds.

TruCluster Server Cluster Hardware Configuration -- Describes how to set up the processors that are to become cluster members, and how to configure cluster shared storage.

TruCluster Server Cluster Installation -- Describes how to install the TruCluster Server software product.

TruCluster Server Cluster Administration -- Describes cluster-specific administration tasks.

TruCluster Server Cluster LAN Interconnect -- Describes how to configure and administer a Local Area Network (LAN) as a cluster interconnect.

You can find the latest version of the TruCluster Server documentation at the following URL:

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

In addition, have available the following manuals from the Compaq Tru64^TM UNIX operating system software documentation set:

Tru64 UNIX Release Notes

Tru64 UNIX System Administration

Tru64 UNIX Network Administration: Connections

Tru64 UNIX Network Administration: Services

Tru64 UNIX Programmer's Guide

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:

G	Manuals for general users
S	Manuals for system and network administrators
P	Manuals for programmers
R	Manuals for reference page users

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.

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.