test

Sun Cluster Geographic Edition Installation Guide

Chapter 2 Installing Sun Cluster Geographic Edition Software

This chapter describes how to install Sun Cluster Geographic Edition software on a pair of clusters. This chapter also provides a procedure to uninstall Sun Cluster Geographic Edition software.

This chapter contains the following sections:

Installation Overview

You can install Sun Cluster Geographic Edition software on a running cluster without disruption. Because the Sun Cluster Geographic Edition software installation process does not require you to restart Sun Cluster software, the cluster remains in production with services running.

The Sun Java Enterprise System (Java ES) installer program offers two interactive installation modes, graphical user interface (GUI) and text-based interface. The graphical mode provides a wizard that guides you, step by step, through the tasks that you need to perform to install the Sun Cluster Geographic Edition components. The text-based mode provides the same functions that the GUI provides. However, this mode prompts you for responses on a line-by-line basis, rather than by means of a wizard.

Note –

Ensure that you have installed all the required patches for your cluster configuration on each node of every cluster before you start installing the software. See Required Patches in Sun Cluster Geographic Edition 3.2 Release Notes for the location of patches and installation instructions.

You must install Sun Cluster Geographic Edition software on all nodes of all clusters in a partnership.

Installing Sun Cluster Geographic Edition Software

You must install Sun Cluster Geographic Edition software on every node of each cluster in your geographically separated cluster by using the installer program.

ProcedureHow to Install Sun Cluster Geographic Edition Software

This procedure explains how to install Sun Cluster Geographic Edition software.

Before You Begin

Before you begin to install software, make the following preparations:

  1. To use the installer program with a GUI, ensure that the display environment of the cluster node to install is set to display the GUI.


    % xhost +
% setenv DISPLAY nodename:0.0

    If the display environment is not set to display the GUI, the installer program instead displays in test-based mode.

  2. Become superuser on a node where you intend to install the Sun Cluster Geographic Edition software.

    Note –

    Sun Cluster Geographic Edition software must be installed on all nodes of each cluster in the partnership.

  3. Load the Sun Java Availability Suite installation DVD-ROM into the DVD-ROM drive.

    If the volume management daemon vold(1M) is running and is configured to manage CD-ROM or DVD devices, the daemon automatically mounts the media on the /cdrom/cdrom0/ directory.

  4. Change to the installation wizard directory of the DVD-ROM.

    • For the SPARC platform, type the following command:


      # cd /cdrom/cdrom0/Solaris_sparc

    • For the x86 platform, type the following command:


      # cd /cdrom/cdrom0/Solaris_x86

  5. Start the installer program.


    # ./installer

    The installer starts and displays the Welcome page. To exit the installer at any time, click Cancel. For more information about the installer program, see Sun Java Enterprise System 5 Installation Guide for UNIX.

  6. Follow instructions on the screens to read and accept the Software License Agreement.

    After you accept the license terms, the Choose Software Components menu is displayed.

  7. Select Sun Cluster Geographic Edition 3.2 and press Return.

    The Confirm Choices screen is displayed.

  8. Press Return to confirm your choice.

    The Sun Cluster Geographic Edition 3.2 submenu is displayed.

  9. Follow onscreen instructions to select the following products from the Sun Cluster Geographic Edition submenu.

    • Sun Cluster Geographic Edition 3.2.

    • The data replication software that you want to use.

    • (Optional) Sun Cluster Geographic Edition Manager.

  10. When prompted, choose whether to install multilingual packages.

    Note –

    If you choose to install multilingual packages, ensure that all nodes of the cluster have the same default locale.

  11. When prompted, choose to upgrade shared components.

    The installer begins to install the software packages. After the installation is finished, you can view any available installation log.

  12. Unload the Sun Java Availability Suite installation DVD-ROM from the DVD-ROM drive.

  13. Repeat this procedure on each node of each partner cluster.

Next Steps

Install required patches. Go to Installing Patches.

Configure Sun Cluster Geographic Edition software on the clusters. Go to Chapter 3, Enabling and Configuring the Sun Cluster Geographic Edition Software.

Installing Patches

You must run the same patch levels for Sun Cluster software and the common agent container software on all nodes of both clusters.

The patch level for each node on which you have installed Sun Cluster Geographic Edition software must meet the Sun Cluster patch-level requirements.

All nodes in one cluster must have the same version of Sun Cluster Geographic Edition software and the same patch level. However, primary and secondary clusters can run different versions of Sun Cluster Geographic Edition software for a limited amount of time, provided that each version is correctly patched. For example, if one cluster is running Sun Cluster Geographic Edition 3.1 8/05 software that has been fully patched, and the partner cluster is running Sun Cluster Geographic Edition 3.2 software that has been fully patched, then both clusters should be brought to the same patch level as soon as possible. Also, if both partner clusters are running Sun Cluster Geographic Edition 3.2, then both partner clusters should be brought to the same patch level as soon as possible.

To ensure that the patches have been installed properly, install the patches on your secondary cluster before you install the patches on the primary cluster.

Note –

Use the information in this section to install patches before you start the Sun Cluster Geographic Edition infrastructure.

For additional information about Sun Cluster Geographic Edition patches, see the patch README file.

See Required Patches in Sun Cluster Geographic Edition 3.2 Release Notes for a list of required patches.

ProcedureHow to Prepare the Cluster for Patch Installation

  1. Ensure that the cluster is functioning properly.

    To view the current status of the cluster, run the following command from any node:


    % cluster status

    See the cluster(1CL) man page for more information.

    Search the /var/adm/messages log on the same node for unresolved error messages or warning messages.

  2. Become superuser on a node of the cluster.

  3. Remove all application resource groups from protection groups.

    Highly available applications do not have downtime during the Sun Cluster Geographic Edition software patch installation.


    # geopg remove-resource-group resourcegroup protectiongroup

    See the geopg(1M) man page for more information.

  4. Perform the preceding steps on all clusters that have a partnership with this cluster.

  5. Stop all protection groups that are active on the cluster.


    # geopg stop protectiongroup -e local

    See the geopg(1M) man page for more information.

  6. Stop the Sun Cluster Geographic Edition infrastructure.


    # geoadm stop

    See the geoadm(1M) man page for more information.

  7. On each node, stop the common agent container.


    # /usr/sbin/cacaoadm stop
    Note –

    You must use common agent container 2, which is located in the /usr/sbin directory. Use the /usr/sbin/cacaoadm -V command to check which version of common agent container you are using.

Next Steps

Install the required patches for the Sun Cluster Geographic Edition software. Go to How to Install Patches.

ProcedureHow to Install Patches

Perform this procedure on all nodes of the cluster.

Patch the secondary cluster before you patch the primary cluster to permit testing.

Before You Begin

Perform the following tasks:

  1. Ensure that all the nodes are online and part of the cluster.

    To view the current status of the cluster, run the following command from any node:


    % cluster status

    See the cluster(1CL) man page for more information.

    Search the /var/adm/messages log on the same node for unresolved error messages or warning messages.

  2. Become superuser on each node.

  3. On each node, install any necessary patches to support Sun Cluster Geographic Edition software by using the patchadd command.

  4. After you have installed all required patches on all nodes of the cluster, on each node start the common agent container.


    # /usr/sbin/cacaoadm start
    Note –

    You must use common agent container 2, which is located in the /usr/sbin directory. Use the /usr/sbin/cacaoadm -V command to check which version of common agent container you are using.

  5. On one node, enable Sun Cluster Geographic Edition software.


    # geoadm start

  6. Add all application resource groups that you removed while you were preparing the cluster for a patch installation back to the protection group.


    # geopg add-resource-group resourcegroup protectiongroup

    See the geopg(1M) man page for more information.

  7. Start all the protection groups that you have added.


    # geopg start protectiongroup -e local [-n]

    See the geopg(1M) man page for more information.

Next Steps

After you patch the secondary cluster, perform a sanity test on the Sun Cluster Geographic Edition software, and then repeat this procedure on the primary cluster.

Configure Sun Cluster Geographic Edition software on the clusters. Go to Chapter 3, Enabling and Configuring the Sun Cluster Geographic Edition Software.