Sun Cluster Software Installation Guide for Solaris OS

Chapter 7 Installing and Upgrading the Sun Cluster Module to Sun Management Center

This chapter provides guidelines and procedures to install the Sun Cluster module to the Sun Management Center graphical user interface (GUI).

SPARC: Installing the Sun Cluster Module for Sun Management Center

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 

SPARC: Installation Requirements for Sun Cluster Monitoring

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. 

SPARC: How to Start Sun Management Center

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. 

SPARC: How to Load the Sun Cluster Module

SPARC: Installation Requirements for Sun Cluster Monitoring

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.

ProcedureSPARC: How to Install the Sun Cluster Module for Sun Management Center

Perform this procedure to install the Sun Cluster–module server package.


Note –

The Sun Cluster–module agent packages, SUNWscsal and SUNWscsam, are already added to cluster nodes during Sun Cluster software installation.


Before You Begin

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.

  1. On the Sun Management Center server machine, install the Sun Cluster–module server package SUNWscssv.

    1. Become superuser.

    2. 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.

    3. 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/
      
    4. Install the Sun Cluster–module server package.


      phys-schost# pkgadd -d . SUNWscssv
      
    5. Unload the Sun Java Availability Suite DVD-ROM from the DVD-ROM drive.

      1. To ensure that the DVD-ROM is not being used, change to a directory that does not reside on the DVD-ROM.

      2. Eject the DVD-ROM.


        phys-schost# eject cdrom
        
  2. 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.

Next Steps

Start Sun Management Center. Go to SPARC: How to Start Sun Management Center.

ProcedureSPARC: How to Start Sun Management Center

Perform this procedure to start the Sun Management Center server, agent, and console processes.

  1. 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
    
  2. 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
    
  3. 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
    
  4. 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
    
Next Steps

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.

ProcedureSPARC: 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.

  1. Log in to Sun Management Center.

    See your Sun Management Center documentation.

  2. 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.

  3. Choose Edit⇒Create an Object from the pull-down menu.

  4. Click the Node tab.

  5. From the Monitor Via pull-down list, select Sun Management Center Agent - Host.

  6. 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.

  7. In the Port text field, type the port number that you chose when you installed the Sun Management Center agent machine.

  8. Click OK.

    A Sun Management Center agent host object is created in the domain.

Next Steps

Load the Sun Cluster module. Go to SPARC: How to Load the Sun Cluster Module.

Troubleshooting

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.

ProcedureSPARC: How to Load the Sun Cluster Module

Perform this procedure to start cluster monitoring.

  1. In the Sun Management Center main window, right click the icon of a cluster node.

    The pull-down menu is displayed.

  2. Choose Load Module.

    The Load Module window lists each available Sun Management Center module and whether the module is currently loaded.

  3. Choose Sun Cluster: Not Loaded and click OK.

    The Module Loader window shows the current parameter information for the selected module.

  4. Click OK.

    After a few moments, the module is loaded. A Sun Cluster icon is then displayed in the Details window.

  5. Verify that the Sun Cluster module is loaded.

    Under the Operating System category, expand the Sun Cluster subtree in either of the following ways:

    • In the tree hierarchy on the left side of the window, place the cursor over the Sun Cluster module icon and single-click the left mouse button.

    • In the topology view on the right side of the window, place the cursor over the Sun Cluster module icon and double-click the left mouse button.

See Also

See your Sun Management Center documentation for information about how to use Sun Management Center.

Next Steps

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.

SPARC: Upgrading Sun Management Center Software

This section provides the following procedures to upgrade the Sun Cluster module for Sun Management Center:

ProcedureSPARC: How to Upgrade Sun Cluster Module Software for Sun Management Center

Perform the following steps to upgrade Sun Cluster module software on the Sun Management Center server machine and console machine.


Note –

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.


Before You Begin

Have available the Sun Java Availability Suite DVD-ROM for the SPARC platform or the path to the DVD-ROM image.

  1. 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
    

    Note –

    Sun Cluster module software on the cluster nodes was already upgraded during the cluster-framework upgrade.


  2. As superuser, reinstall Sun Cluster module packages on each machine.

    1. Insert the Sun Java Availability Suite DVD-ROM for the SPARC platform into the DVD-ROM drive of the machine.

    2. 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/
      
    3. 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
      
    4. Unload the Sun Java Availability Suite DVD-ROM from the DVD-ROM drive.

      1. To ensure that the DVD-ROM is not being used, change to a directory that does not reside on the DVD-ROM.

      2. Eject the DVD-ROM.


        machine# eject cdrom
        

ProcedureSPARC: How to Upgrade Sun Management Center Software

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.

Before You Begin

Have available the following items:

  1. Stop any Sun Management Center processes.

    1. If the Sun Management Center console is running, exit the console.

      In the console window, choose File⇒Exit.

    2. On each Sun Management Center agent machine (cluster node), stop the Sun Management Center agent process.


      phys-schost# /opt/SUNWsymon/sbin/es-stop -a
      
    3. On the Sun Management Center server machine, stop the Sun Management Center server process.


      server# /opt/SUNWsymon/sbin/es-stop -S
      
  2. 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.

  3. Upgrade the Sun Management Center software.

    Follow the upgrade procedures in your Sun Management Center documentation.

  4. 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

    1. Insert the Sun Java Availability Suite DVD-ROM for the appropriate platform in the DVD-ROM drive of the machine.

    2. 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/
      

      Note –

      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.


    3. 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
        
  5. Apply any Sun Management Center patches and any Sun Cluster module patches to each node of the cluster.

  6. Restart Sun Management Center agent, server, and console processes.

    Follow procedures in SPARC: How to Start Sun Management Center.

  7. 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.