This chapter provides guidelines and procedures to install the Sun Cluster module to the Sun Management Center graphical user interface (GUI).
This section provides information and procedures to install software for the Sun Cluster module to Sun Management Center.
The Sun Cluster module for Sun Management Center enables you to use Sun Management Center to monitor the cluster. The following table lists the tasks to perform to install the Sun Cluster–module software for Sun Management Center.
Table 7–1 Task Map: Installing the Sun Cluster Module for Sun Management Center
Task |
Instructions |
---|---|
1. Install Sun Management Center server, agent, and console packages. |
Sun Management Center documentation |
2. Install Sun Cluster–module packages. |
SPARC: How to Install the Sun Cluster Module for Sun Management Center |
3. Start Sun Management Center server, console, and agent processes. | |
4. Add each cluster node as a Sun Management Center agent host object. |
SPARC: How to Add a Cluster Node as a Sun Management Center Agent Host Object |
5. Load the Sun Cluster module to begin to monitor the cluster. |
The Sun Cluster module for Sun Management Center is used to monitor a Sun Cluster configuration. Perform the following tasks before you install the Sun Cluster module packages.
Space requirements - Ensure that 25 Mbytes of space is available on each cluster node for Sun Cluster–module packages.
Sun Management Center installation - Follow procedures in your Sun Management Center installation documentation to install Sun Management Center software.
The following are additional requirements for a Sun Cluster configuration:
Install the Sun Management Center agent package on each cluster node.
When you install Sun Management Center on an agent machine (cluster node), choose whether to use the default of 161 for the agent (SNMP) communication port or another number. This port number enables the server to communicate with this agent. Record the port number that you choose for reference later when you configure the cluster nodes for monitoring.
See your Sun Management Center installation documentation for information about choosing an SNMP port number.
If you have an administrative console or other dedicated machine, you can run the console process on the administrative console and the server process on a separate machine. This installation approach improves Sun Management Center performance.
For best results, install the Sun Management Center server and console packages on noncluster machines.
If you choose to install the server or console packages on a cluster node, you might experience the following adverse performance impacts:
Cluster performance might be noticeably slowed due to the increased load from Sun Management Center processes. This is especially likely when the Sun Management Center server runs on a cluster node.
Sun Management Center is not made highly available when you install the server on a cluster node. Sun Management Center service will fail if the node goes down, such as during a failover to another node.
Web browser - Ensure that the web browser that you use to connect to Sun Management Center is supported by Sun Management Center. Certain features might not be available on unsupported web browsers. See your Sun Management Center documentation for information about supported web browsers and any configuration requirements.
Perform this procedure to install the Sun Cluster–module server package.
The Sun Cluster–module agent packages, SUNWscsal and SUNWscsam, are already added to cluster nodes during Sun Cluster software installation.
Ensure that all Sun Management Center core packages are installed on the appropriate machines. This task includes installing Sun Management Center agent packages on each cluster node. See your Sun Management Center documentation for installation instructions.
On the Sun Management Center server machine, install the Sun Cluster–module server package SUNWscssv.
Become superuser.
Load the Sun Java Availability Suite 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 Solaris_sparc/Product/sun_cluster/Solaris_ver/Packages/ directory, where ver is 9 for Solaris 9 or 10 for Solaris 10.
phys-schost# cd /cdrom/cdrom0/Solaris_sparc/Product/sun_cluster/Solaris_ver/Packages/ |
Install the Sun Cluster–module server package.
phys-schost# pkgadd -d . SUNWscssv |
Unload the Sun Java Availability Suite DVD-ROM from the DVD-ROM drive.
Install any Sun Cluster–module patches.
See Patches and Required Firmware Levels in Sun Cluster 3.2 Release Notes for Solaris OS for the location of patches and installation instructions.
Start Sun Management Center. Go to SPARC: How to Start Sun Management Center.
Perform this procedure to start the Sun Management Center server, agent, and console processes.
As superuser, on the Sun Management Center server machine, start the Sun Management Center server process.
The install-dir is the directory on which you installed the Sun Management Center software. The default directory is /opt.
server# /install-dir/SUNWsymon/sbin/es-start -S |
As superuser, on each Sun Management Center agent machine (cluster node), start the Sun Management Center agent process.
phys-schost# /install-dir/SUNWsymon/sbin/es-start -a |
On each Sun Management Center agent machine (cluster node), ensure that the scsymon_srv daemon is running.
phys-schost# ps -ef | grep scsymon_srv |
If any cluster node is not already running the scsymon_srv daemon, start the daemon on that node.
phys-schost# /usr/cluster/lib/scsymon/scsymon_srv |
On the Sun Management Center console machine (administrative console), start the Sun Management Center console.
You do not need to be superuser to start the console process.
adminconsole% /install-dir/SUNWsymon/sbin/es-start -c |
Add a cluster node as a monitored host object. Go to SPARC: How to Add a Cluster Node as a Sun Management Center Agent Host Object.
Perform this procedure to create a Sun Management Center agent host object for a cluster node.
Log in to Sun Management Center.
See your Sun Management Center documentation.
From the Sun Management Center main window, select a domain from the Sun Management Center Administrative Domains pull-down list.
This domain contains the Sun Management Center agent host object that you create. During Sun Management Center software installation, a Default Domain was automatically created for you. You can use this domain, select another existing domain, or create a new domain.
See your Sun Management Center documentation for information about how to create Sun Management Center domains.
Choose Edit⇒Create an Object from the pull-down menu.
Click the Node tab.
From the Monitor Via pull-down list, select Sun Management Center Agent - Host.
Fill in the name of the cluster node, for example, phys-schost-1, in the Node Label and Hostname text fields.
Leave the IP text field blank. The Description text field is optional.
In the Port text field, type the port number that you chose when you installed the Sun Management Center agent machine.
Click OK.
A Sun Management Center agent host object is created in the domain.
Load the Sun Cluster module. Go to SPARC: How to Load the Sun Cluster Module.
You need only one cluster node host object to use Sun Cluster-module monitoring and configuration functions for the entire cluster. However, if that cluster node becomes unavailable, connection to the cluster through that host object also becomes unavailable. Then you need another cluster-node host object to reconnect to the cluster.
Perform this procedure to start cluster monitoring.
In the Sun Management Center main window, right click the icon of a cluster node.
The pull-down menu is displayed.
Choose Load Module.
The Load Module window lists each available Sun Management Center module and whether the module is currently loaded.
Choose Sun Cluster: Not Loaded and click OK.
The Module Loader window shows the current parameter information for the selected module.
Click OK.
After a few moments, the module is loaded. A Sun Cluster icon is then displayed in the Details window.
Verify that the Sun Cluster module is loaded.
Under the Operating System category, expand the Sun Cluster subtree in either of the following ways:
See your Sun Management Center documentation for information about how to use Sun Management Center.
Install third-party applications, register resource types, set up resource groups, and configure data services. See the documentation that is supplied with the application software and the Sun Cluster Data Services Planning and Administration Guide for Solaris OS.
This section provides the following procedures to upgrade the Sun Cluster module for Sun Management Center:
Perform the following steps to upgrade Sun Cluster module software on the Sun Management Center server machine and console machine.
To upgrade the Sun Management Center software itself, do not perform this procedure. Instead, go to SPARC: How to Upgrade Sun Management Center Software to upgrade the Sun Management Center software and the Sun Cluster module.
Have available the Sun Java Availability Suite DVD-ROM for the SPARC platform or the path to the DVD-ROM image.
As superuser, remove the existing Sun Cluster module packages from each machine.
Use the pkgrm(1M) command to remove all Sun Cluster module packages from all locations that are listed in the following table.
Location |
Module Package to Remove |
---|---|
Sun Management Center console machine |
SUNWscscn |
Sun Management Center server machine |
SUNWscssv, SUNWscshl |
machine# pkgrm module-package |
Sun Cluster module software on the cluster nodes was already upgraded during the cluster-framework upgrade.
As superuser, reinstall Sun Cluster module packages on each machine.
Insert the Sun Java Availability Suite DVD-ROM for the SPARC platform into the DVD-ROM drive of the machine.
Change to the Solaris_sparc/Product/sun_cluster/Solaris_ver/Packages/ directory, where ver is 9 for Solaris 9 or 10 for Solaris 10.
machine# cd Solaris_sparc/Product/sun_cluster/Solaris_ver/Packages/ |
Install the SUNWscssv package on the server machine.
Note that you do not upgrade to a new SUNWscscn package on the console machine or a new SUNWscshl package on the server machine.
machine# pkgadd -d . SUNWscssv |
Unload the Sun Java Availability Suite DVD-ROM from the DVD-ROM drive.
Perform the following steps to upgrade from Sun Management Center 2.1.1, 3.0, 3.5, or 3.6 software to Sun Management Center 3.6.1 software.
Have available the following items:
Sun Java Availability Suite DVD-ROM for the SPARC platform and, if applicable, for the x86 platform, or the paths to the DVD-ROM images. You use the DVD-ROM to reinstall the Sun Cluster 3.2 version of the Sun Cluster module packages after you upgrade Sun Management Center software.
The agent packages to install on the cluster nodes are available for both SPARC based systems and x86 based systems. The package for the server machine is available for SPARC based systems only.
Sun Management Center documentation.
Sun Management Center patches and Sun Cluster module patches, if any.
See Patches and Required Firmware Levels in Sun Cluster 3.2 Release Notes for Solaris OS for the location of patches and installation instructions.
Stop any Sun Management Center processes.
If the Sun Management Center console is running, exit the console.
In the console window, choose File⇒Exit.
On each Sun Management Center agent machine (cluster node), stop the Sun Management Center agent process.
phys-schost# /opt/SUNWsymon/sbin/es-stop -a |
On the Sun Management Center server machine, stop the Sun Management Center server process.
server# /opt/SUNWsymon/sbin/es-stop -S |
As superuser, remove Sun Cluster–module packages.
Use the pkgrm(1M) command to remove all Sun Cluster module packages from all locations that are listed in the following table.
Location |
Module Package to Remove |
---|---|
Each cluster node |
SUNWscsam, SUNWscsal |
Sun Management Center console machine |
SUNWscscn |
Sun Management Center server machine |
SUNWscssv |
Sun Management Center 3.0 help-server machine or Sun Management Center 3.5 or 3.6 server machine |
SUNWscshl |
machine# pkgrm module-package |
If you do not remove the listed packages, the Sun Management Center software upgrade might fail because of package dependency problems. You reinstall these packages in Step 4, after you upgrade Sun Management Center software.
Upgrade the Sun Management Center software.
Follow the upgrade procedures in your Sun Management Center documentation.
As superuser, reinstall Sun Cluster module packages from the Sun Java Availability Suite DVD-ROM to the locations that are listed in the following table.
Location |
Module Package to Install |
---|---|
Each cluster node |
SUNWscsam, SUNWscsal |
Sun Management Center server machine |
SUNWscssv |
Insert the Sun Java Availability Suite DVD-ROM for the appropriate platform in the DVD-ROM drive of the machine.
Change to the Solaris_arch/Product/sun_cluster/Solaris_ver/Packages/ directory, where arch is sparc or x86, and ver is 9 for Solaris 9 or 10 for Solaris 10.
machine# cd /cdrom/cdrom0/Solaris_arch/Product/sun_cluster/Solaris_ver/Packages/ |
The agent packages to install on the cluster nodes are available for both SPARC based systems and x86 based systems. The package for the server machine is available for SPARC based systems only.
Install the appropriate module package on the machine.
For cluster nodes that run the Solaris 10 OS, use the following command:
phys-schost# pkgadd -G -d . module-package |
The -G option adds packages to the current zone only. You must add these packages only to the global zone. Therefore, this option also specifies that the packages are not propagated to any existing non-global zone or to any non-global zone that is created later.
SPARC: For cluster nodes that run the Solaris 9 OS and for the server machine, use the following command:
phys-schost# pkgadd -d . module-package |
Apply any Sun Management Center patches and any Sun Cluster module patches to each node of the cluster.
Restart Sun Management Center agent, server, and console processes.
Follow procedures in SPARC: How to Start Sun Management Center.
Load the Sun Cluster module.
Follow procedures in SPARC: How to Load the Sun Cluster Module.
If the Sun Cluster module was previously loaded, unload the module and then reload it to clear all cached alarm definitions on the server. To unload the module, choose Unload Module from the Module menu on the console's Details window.