Sun Java Enterprise System 2005Q4 Installation Guide for UNIX

Sun Cluster Software Example

This example installs Messaging Server in a Sun Cluster framework.

Note –

Components that can be configured to run in a cluster instead of on a single server include Administration Server, Application Server Calendar Server, Directory Server, HADB, Message Queue, Messaging Server, and Web Server.

Before you install or configure Sun Cluster software, ensure that the combination of hardware and software that you choose for your cluster is currently a supported Sun Cluster configuration.

Requirements and Sequencing Issues

Messaging Server requires Directory Server, but not necessarily a local copy. In addition, Messaging Server requires a local copy of Administration Server. You will need the Sun Cluster Core component as well as the Sun Cluster Agents for Directory Server, Administration Server, and Messaging Server. If a remote Directory Server is used, then the Sun Cluster Agent for Directory Server is not required.

Installing, configuring, and starting the components in the correct order is crucial for a successful Sun Cluster implementation.

  1. Installing the Java ES Sun Cluster component

  2. Configuring the Sun Cluster framework

  3. Installing the additional Java ES components that are required for Messaging Server to operate in the cluster

  4. Configuring the Sun Cluster data services using the agents for the relevant Java ES components

At least two installation sessions are performed on each node in the cluster.

Phase I. Installing and Configuring the Sun Cluster Framework

The following tasks must be performed on all nodes in the cluster.

ProcedureTo Develop a Sequence for the Sun Cluster Framework

  1. Verifying that the hardware is connected correctly for the cluster

  2. Running the Java ES installer

    On Solaris 10, Sun Cluster software can only be installed in the global zone.

  3. At component selection, choosing only the Sun Cluster component

    Tip –

    During a Configure Now installation (usually where you have chosen to install all Java ES components), you are prompted whether to enable support for remote Sun Cluster configuration. If you select Yes, postinstallation configuration for Sun Cluster software will be easier.

  4. Selecting the Configure Later option

  5. Following the instructions to configure the Sun Cluster Framework for each host in the cluster

    Follow instructions in Chapter 2, Installing and Configuring Sun Cluster Software, in Sun Cluster Software Installation Guide for Solaris OS. When the Sun Cluster documentation refers to a Sun Cluster CD-ROM, substitute the name of the equivalent Java ES CD-ROM.

    For documentation on creating resource groups and configuring data services, refer to the Sun Cluster Data Services Planning and Administration Guide for Solaris OS.

  6. If needed, installing the special features of Sun Cluster: RSMAPI (SUNWscrif), SCI-PCI adapters (SUNWsci), RSMRDT drivers (SUNWscrdt)

    Sun Cluster Software Installation Guide for Solaris OS

Phase II. Installing and Configuring Components and Agents

The following tasks must be performed on all nodes in the cluster.

ProcedureTo Develop a Sequence for Configuring Components and Agents

  1. Running the Java ES installer

  2. At component selection, choosing the following:

    1. Messaging Server

      Directory Server, the Directory Preparation Tool, and Administration Server are automatically selected.

      (Optional) If you are using a remote copy of Directory Server, deselect Directory Server and specify a remote copy when prompted.

      Note –

      The remote Directory Server must be running before installing any other components. For instructions on installing Directory Server, refer to Directory Server Only Example

    2. Sun Cluster Agents for Sun Java System

      All agents are selected by default.

    3. Expanding the Sun Cluster Agents for Sun Java System component and deselecting all agents except Administration Server, Directory Server, and Messaging Server

  3. Resolving incompatibilities

    The installer verifies software on your node and provides guidance if incompatibilities are identified.

  4. Verifying installation directories

  5. Selecting the Configure Now or Configure Later option

    Messaging Server and Sun Cluster Agents cannot be configured during installation.

  6. Configuring all the selected components except Sun Cluster Agents

  7. Starting all the components except Sun Cluster Agents, in this order:

    1. Starting and Stopping Directory Server

    2. Starting and Stopping Administration Server and the Server Console

    3. Starting and Stopping Messaging Server

  8. Configuring the data services for the components you have installed and configured

    Sun Cluster Data Services Configuration

    The following table contains additional Sun Cluster information.


    Relevant Information 

    Postinstallation configuration information 

    Phase I. Sun Cluster Framework

    Sun Cluster Data Services Configuration

    Starting and stopping 

    Stopping and Rebooting Sun Cluster Software


    Sun Cluster Uninstallation Behavior


    Sun Cluster Software Troubleshooting Tips


    Sun Java Enterprise System 2005Q4 Upgrade Guide