This chapter describes how to install the Sun Cluster Geographic Edition software on a pair of clusters. This chapter also provides a procedure to uninstall the Sun Cluster Geographic Edition software.
This chapter contains the following sections:
You can install the Sun Cluster Geographic Edition software to a running cluster without disruption. Because the Sun Cluster Geographic Edition software installation process does not require you to restart the Sun Cluster software, the cluster remains in production with services running.
The Java Enterprise System (ES) installer 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.
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.1 2006Q4 Release Notes for the location of patches and installation instructions.
The Sun Cluster Geographic Edition software must be installed on all nodes of all clusters in a partnership.
You must install the Sun Cluster Geographic Edition software on every node of each cluster in your geographically separated cluster by using the installer utility.
This procedure explains how to install the Sun Cluster Geographic Edition software on Solaris OS 9 or 10 by using the GUI.
If you have installed Solaris OS 8, see Installing the Software on Solaris OS 8.
Before you begin to install software, make the following preparations:
Ensure that the Solaris OS is installed to support Sun Cluster Geographic Edition software.
If Solaris software is already installed on the node, you must ensure that the Solaris installation meets the requirements for Sun Cluster Geographic Edition software and any other software that you intend to install on the cluster.
Read Chapter 1, Planning the Sun Cluster Geographic Edition Installation.
Read the following manuals, which contain information that can help you plan your configuration and prepare your installation strategy:
Sun Cluster Geographic Edition 3.1 2006Q4 Release Notes – Restrictions, bug workarounds, and other late-breaking information
Documentation for all third-party software products
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 |
Become root on the cluster where you intend to install the Sun Cluster Geographic Edition software.
The Sun Cluster Geographic Edition software must be installed on all nodes of a cluster.
% su |
Load the Sun Java ES 2006Q4 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.
Change to the Sun Java ES installation wizard directory of the DVD-ROM. If you are installing the software packages on the SPARC platform, type the following command:
# cd /cdrom/cdrom0/Solaris_sparc |
If you are installing the software packages on the x86 platform, type the following command:
# cd /cdrom/cdrom0/Solaris_x86 |
Start the Sun Java ES installation wizard program.
# ./installer |
Follow the instructions on the screen to install Sun Cluster Geographic Edition framework software on the cluster.
The installer starts and displays the Welcome page.
After the installation is finished, you can view any available installation log.
To exit the installer at any time, click Cancel.
Choose Typical or Custom installation.
The Typical installation installs the Sun Cluster Geographic Edition data replication as well as the core components of the Sun Cluster Geographic Edition software.
The Custom installation installs the core components of the Sun Cluster Geographic Edition software.
Choose the locale for the software.
The languages you choose will be installed for all the components you select. Each language causes additional packages to be installed, which adds to the disk space that is required for installation. The English language is always installed.
All nodes of the cluster must have the same default locale.
If you chose the Custom installation, select the Sun Cluster Geographic Edition data replication you want to install.
Confirm that you have selected all the software components you want to install, and click Install Now.
Unload the Sun Java ES 2006Q4 DVD-ROM from the DVD-ROM drive.
Install required patches. Go to Installing Patches.
Configure Sun Cluster Geographic Edition software on the clusters. Go to Chapter 4, Enabling and Configuring the Sun Cluster Geographic Edition Software.
This procedure explains how to install the Sun Cluster Geographic Edition software on Solaris OS 9 or 10 by using the text-based interface.
If you have installed Solaris OS 8, see Installing the Software on Solaris OS 8.
Before you begin to install software, make the following preparations:
Ensure that you have installed all the required patches for your cluster configuration on each node of every cluster.
See Required Patches in Sun Cluster Geographic Edition 3.1 2006Q4 Release Notes for the location of patches and installation instructions.
Read Chapter 1, Planning the Sun Cluster Geographic Edition Installation.
Read the following manuals, which contain information that can help you plan your configuration and prepare your installation strategy:
Sun Cluster Geographic Edition 3.1 2006Q4 Release Notes – Restrictions, bug workarounds, and other late-breaking information
Documentation for all third-party software products
Follow these guidelines to use the interactive installer utility in this procedure:
The interactive installer enables you to type ahead. Therefore, do not press the Return key more than once if the next menu screen does not appear immediately.
Unless otherwise noted, you can press Control-D to return to either the beginning of a series of related questions or to the Main Menu.
Default answers or answers to previous sessions are displayed in brackets ([ ]) at the end of a question. Press Return to enter the response that is in brackets without typing it.
Become root on the cluster where you intend to install the Sun Cluster Geographic Edition software.
The Sun Cluster Geographic Edition software must be installed on all nodes of a cluster.
% su |
Insert the Sun Cluster Geographic Edition CD-ROM in the CD-ROM drive.
Change to the root directory of the CD-ROM, where the installer utility resides.
# cd cdroot/Solaris_sparc/Product/sun_cluster_geo |
Start the installer utility by using the -nodisplay option to indicate that you want to use the text-based interface.
# ./installer -nodisplay |
Follow the instructions on the installer pages to install the Sun Cluster Geographic Edition framework software on the cluster.
After the installation is finished, you can view any available installation log.
To exit the installer at any time, type the ! character.
Choose Typical or Custom installation.
The Typical installation installs the Sun Cluster Geographic Edition data replication as well as the core components of the Sun Cluster Geographic Edition software.
The Custom installation installs the core components of the Sun Cluster Geographic Edition software.
Choose the locale for the software.
The languages you choose will be installed for all the components you select. Each language causes additional packages to be installed, which adds to the disk space that is required for installation. English is always installed.
All nodes of the cluster must have the same default locale.
If you chose the Custom installation, select the Sun Cluster Geographic Edition data replication you want to install.
Confirm that you have selected all the software components you want to install.
Change to a directory that does not reside on the CD-ROM and eject the CD-ROM.
# eject cdrom |
Install required patches. Go to Installing Patches.
Configure Sun Cluster Geographic Edition software on the clusters. Go to Chapter 4, Enabling and Configuring the Sun Cluster Geographic Edition Software.
The version of Sun Cluster software on Sun Java ES 2006Q4 does not support installation on Solaris OS 8. If you have installed Solaris OS 8, you must install the Sun Cluster software from Java ES 2005Q4 before you install the Sun Cluster Geographic Edition software from Java ES 2006Q4.
For information on downloading the Sun Cluster software from Java ES 2005Q4, go to http://www.sun.com/software/javaenterprisesystem/previous/index.xml. For information on installing Sun Cluster software, see Sun Cluster Software Installation Guide for Solaris OS
If you have installed Solaris OS 8, you must install all the packages on the Sun Cluster Geographic Edition software CD on every node of both clusters by using the pkgadd(1M) command.
This procedure explains how to install the Sun Cluster Geographic Edition software on Solaris OS 8 by using the GUI.
If you are running Solaris OS 9 or 10, see Installing the Software on Solaris OS 9 or 10.
Before you begin to install software, be sure to read Chapter 1, Planning the Sun Cluster Geographic Edition Installation. Also, the following manuals contain information that can help you plan your configuration and prepare your installation strategy.
Sun Cluster Geographic Edition Release Notes — Restrictions, bug workarounds, and other late-breaking information
Documentation for all third-party software products.
Log in as root on the cluster where you intend to install the Sun Cluster Geographic Edition software.
% su |
Change to the directory that contains the Sun Cluster Geographic Edition software packages.
# cd cd-root/jes_5/06/Solaris_sparc/Product/ \ sun_cluster_geo/Solaris_8/Packages |
Install the following Sun Cluster Geographic Edition software packages by using the pkgadd command:
SUNWscmautil: Sun Cluster Management Agent utilities
SUNWscmautilr: Sun Cluster Management Agent utilities for root
SUNWscghb: Sun Cluster Geographic Edition heartbeats
SUNWschbr: Sun Cluster heartbeats for root
SUNWscgctl: Control management agents
SUNWscgctlr: Control management agents for root
If you are using Sun StorEdge Availability Suite 3.2.1 software data replication:
SUNWscgrepavs: Sun StorEdge Availability Suite 3.2.1 software data replication
SUNWscgrepavsu: Sun StorEdge Availability Suite 3.2.1 software data replication for usr
If you are using Hitachi TrueCopy data replication:
SUNWscgreptc: Hitachi TrueCopy data replication
SUNWscgreptcu : Hitachi TrueCopy data replication for usr
If you are using EMC Symmetrix Remote Data Facility data replication:
SUNWscgrepsrdf: EMC Symmetrix Remote Data Facility data replication
SUNWscgrepsrdfu : EMC Symmetrix Remote Data Facility data replication for usr
SUNWscgspm: SunPlex Manager Extensions
SUNWscgman: Sun Cluster Geographic Edition man pages
You can also install the following localization packages:
SUNWcscgctl: Simplified Chinese Control Agents
If you are using Sun StorEdge Availability Suite 3.2.1 software data replication, SUNWcscgrepavsu: Simplified Chinese Sun StorEdge Availability Suite data replication for usr
If you are using Hitachi TrueCopy data replication, SUNWcscgreptcu: Simplified Chinese Hitachi TrueCopy data replication for usr
If you are using EMC Symmetrix Remote Data Facility data replication, SUNWcscgrepsrdfu: Simplified Chinese EMC Symmetrix Remote Data Facility data replication for usr
SUNWcscgspm: Simplified Chinese SunPlex Manager Extensions
SUNWjscgctl: Japanese Sun Cluster Geographic Edition Control Agents
SUNWjscgman: Japanese Sun Cluster Geographic Edition man pages
If you are using Sun StorEdge Availability Suite 3.2.1 software data replication, SUNWjscgrepavsu: Japanese Sun StorEdge Availability Suite data replication for usr
If you are using Hitachi TrueCopy data replication, SUNWjscgreptcu: Japanese Hitachi TrueCopy data replication for usr
If you are using EMC Symmetrix Remote Data Facility data replication, SUNWjscgrepsrdfu: Japanese EMC Symmetrix Remote Data Facility data replication for usr
SUNWjscgspm: Japanese SunPlex Manager Extensions
SUNWkscgctl: Korean Sun Cluster Geographic Edition Control Agents
If you are using Sun StorEdge Availability Suite 3.2.1 software data replication, SUNWkscgrepavsu: Korean Sun StorEdge Availability Suite data replication for usr
If you are using Hitachi TrueCopy data replication, SUNWkscgreptcu: Korean Hitachi TrueCopy data replication for usr
If you are using EMC Symmetrix Remote Data Facility data replication, SUNWkscgrepsrdfu: Korean EMC Symmetrix Remote Data Facility data replication for usr
SUNWkscgspm: Korean SunPlex Manager Extensions
# pkgadd -d . SUNWscmautil # pkgadd -d . SUNWscmautilr # pkgadd -d . SUNWscghb # pkgadd -d . SUNWscghbr # pkgadd -d . SUNWscgctl # pkgadd -d . SUNWscgctlr # pkgadd -d . SUNWscgrepavs # pkgadd -d . SUNWscgrepavsu # pkgadd -d . SUNWscgreptc # pkgadd -d . SUNWscgreptcu # pkgadd -d . SUNWscgspm # pkgadd -d . SUNWscgman |
Install required patches. Go to Installing Patches.
Configure Sun Cluster Geographic Edition software on the clusters. Go to Chapter 4, Enabling and Configuring the Sun Cluster Geographic Edition Software.
You must run the same patch levels for Sun Cluster and common agent container on all nodes of both clusters.
The patch level for each node on which you have installed the Sun Cluster Geographic Edition software must meet the Sun Cluster patch-level requirements.
All nodes in one cluster must have the same version of the 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 provided that each version is correctly patched, for a limited amount of time. 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.1 2006Q4 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.1 2006Q4, 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.
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.1 2006Q4 Release Notes for a list of required patches.
Ensure that the cluster is functioning properly.
To view the current status of the cluster, run the following command from any node:
% scstat |
See the scstat(1M) man page for more information.
Search the /var/adm/messages log on the same node for unresolved error messages or warning messages.
Check the volume manager status.
On a node of the cluster, become root.
% su |
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 protectiongroupname |
See the geopg(1M) man page for more information.
Perform the preceding steps on all clusters that have a partnership with this cluster.
Stop all protection groups that are active on the cluster.
# geopg stop protectiongroupname -e local | global |
See the geopg(1M) man page for more information.
Stop the Sun Cluster Geographic Edition infrastructure.
# geoadm stop |
See the geoadm(1M) man page for more information.
Stop the common agent container.
# /opt/SUNWcacao/bin/cacaoadm stop |
You must use common agent container 1.1, which is located in /opt/SUNWcacao/bin. Use the /opt/SUNWcacao/bin/cacaoadm -V command to check which version of common agent container you are using.
Install the required patches for the Sun Cluster Geographic Edition software. Go to How 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.
Perform the following tasks:
Ensure that the Solaris OS is installed to support Sun Cluster Geographic Edition software.
If Solaris software is already installed on the node, you must ensure that the Solaris installation meets the requirements for Sun Cluster Geographic Edition software and any other software that you intend to install on the cluster.
Ensure that Sun Cluster Geographic Edition software packages are installed on the node.
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:
% scstat |
See the scstat(1M) man page for more information.
Search the /var/adm/messages log on the same node for unresolved error messages or warning messages.
Install any necessary patches to support Sun Cluster Geographic Edition software by using the patchadd command.
After you have installed all required patches on all the nodes of all clusters, start the common agent container.
# /opt/SUNWcacao/bin/cacaoadm start |
You must use common agent container 1.1, which is located in /opt/SUNWcacao/bin. Use the /opt/SUNWcacao/bin/cacaoadm -V command to check which version of common agent container you are using.
Enable the Sun Cluster Geographic Edition software.
# geoadm start |
Add all application resource groups you removed while you were preparing the cluster for a patch installation back to the protection group.
# geopg add-resource-group resourcegroup protectiongroupname |
See the geopg(1M) man page for more information.
Start all the protection groups that you have added.
# geopg start protectiongroupname -e local | global [-n] |
See the geopg(1M) man page for more information.
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 4, Enabling and Configuring the Sun Cluster Geographic Edition Software.