test

Sun Cluster 2.2 System Administration Guide

Using Sun Cluster Manager

Sun Cluster Manager (SCM) is the cluster management tool for Sun Cluster 2.2. SCM provides a single interface to many of Sun Cluster's command line monitoring features. SCM reports information about:

SCM consists of two parts--the SCM server software and the SCM Graphical User Interface (GUI). The SCM server must run on each node in the cluster. The SCM GUI runs as either an application or an applet. If run as an applet, SCM can be displayed through a browser compliant with the Java Development Kit (JDK(TM)), such as HotJava(TM) or Netscape. The browser can run on any machine, including the cluster nodes. For the most current information about which JDK versions are supported, see your service provider or the latest version of the Sun Cluster 2.2 Release Notes.

Use the information in the following sections to configure and run SCM.

Running SCM As an Application

To run SCM as an application, perform the following procedure.

How to Run SCM As an Application

  1. On the administrative workstation, install the SCM package (SUNWscmgr) from the Sun Cluster 2.2 product CD.

  2. Install the latest version of the SCM patch on all cluster nodes and on the administrative workstation.

    For the most current information about patches and patch numbers, see the Sun Cluster 2.2 Release Notes, your service provider, or the Sun patch web site, http://sunsolve.sun.com.

  3. Run the SCM application.

    Start the application by running the following command from any cluster node, where cluster_node is a current member of the cluster. 


    # /opt/SUNWcluster/bin/scmgr cluster_node

Once the SCM application is running, you can access the online help for information about menu navigation, tasks, and reference. To display the Help window from the SCM application, select Help Contents from the Help menu. Alternatively, click on the Help icon in the tool bar above the folder icon.

Refer to the scmgr(1M) man page for more information about running SCM.

Running SCM As an Applet

To run SCM as an applet, you must perform these tasks, which are described in more detail in the procedures that follow.

  1. On all cluster nodes, install the latest version of the SCM patch from SunSolve. For the most current information about patches and patch numbers, see the Sun Cluster 2.2 Release Notes, your service provider, or the Sun patch web site, http://sunsolve.sun.com.

  2. Install a browser on the administrative workstation. Supported browsers for Sun Cluster 2.2 4/00 Release are HotJava (version 1.1.4 or greater) and Netscape (version 4.5 or greater).

  3. If you installed HotJava as your browser, install the JDK on the administrative workstation.

  4. Install and configure a web server on all cluster nodes.

  5. Start the SCM applet by typing the appropriate URL in the browser. Make sure the host you specify in the URL is a current member of the cluster.

    Note -

    If you use the HotJava browser shipped with your Solaris 2.6 or 2.7 operating system, you might experience problems when using the menus. For example, after you make a menu selection, the selection might remain visible on the browser. Refer to the Sun Cluster 2.2 Release Notes for more information about SCM open issues. Solaris 8 software does not support a HotJava browser. To run SCM with Solaris 8 software, you must use another browser, such as Netscape. See "How to Run the SCM Applet in a Netscape Browser From a Cluster Node".

    Note -

    If you use the HotJava browser with SCM, you should have at least 40 Megabytes of free swap space. If you find that swap space gets low, restarting the HotJava browser can help.

To run SCM, you must have the correct versions of HotJava and the JDK packages (SUNWjvrt and SUNWjvjit) installed on the system containing the HotJava browser. Check your version numbers against those listed in the following table. Also see the latest version of the Sun Cluster 2.2 Release Notes for possible updates to this information:

Table 2-5 SCM Requirements: JDK and HotJava

Operating Environment 

Java Developer Kit (JDK) version 

HotJava Version 

Netscape Version 

Solaris 2.6 

1.1.6 or later 

1.1.4 or later 

4.5 or later 

Solaris 7 

1.1.6 or later 

1.1.4 or later 

4.5 or later 

Solaris 8 

1.2 or later 

not supported 

4.5 or later 

You can choose to:

Use the following procedures as necessary to set up your preferred configuration.

How to Set Up the JDK

  1. Determine the current Java version by typing the following at the console prompt on a cluster server.


    # java -version

  2. If necessary, download a later version of the JDK.

    If the system displays a version of Java lower than 1.1.6, follow the instructions to download the JDK version 1.1.6 (or later) software from the following URL:

    http://www.sun.com/solaris/java

How to Download HotJava

  1. From the machine running the HotJava browser, select About HotJava from the Help menu.

    If the browser displays a version lower than 1.1.4, or if you do not have a HotJava browser, follow the instructions to download the HotJava software version 1.1.4 (or later) from the following URL:

    http://java.sun.com/products/hotjava/index.html

How to Run the SCM Applet in a HotJava Browser From a Cluster Node

  1. Run your HotJava browser on a cluster node.

    The HotJava browser is located in /usr/dt/bin.

  2. Remotely display the HotJava browser on an X windows workstation.

  3. In the HotJava browser, set the applet security preferences:

    1. Choose Applet Security from Preferences on the Edit menu.

    2. Click Medium Security as the Default setting for Unsigned applets.

  4. When you are ready to begin monitoring the cluster with SCM, type the appropriate URL. For example: 


    file:/opt/SUNWcluster/scmgr/index.html

  5. Click OK on dialog boxes that ask for permission to access certain files, ports, and so forth.

    Note -

    HotJava takes some time to download and run the applet. No status information will appear during this time.

Refer to the online help for complete information about menu navigation, tasks, and reference.

How to Run the SCM Applet in a HotJava Browser From the Administrative Workstation

  1. Run your HotJava browser on a node in the cluster.

    The HotJava browser is located in /usr/dt/bin.

  2. Set up and start a web server on all cluser nodes.

    For details, see "How to Set Up a Web Server to Run With SCM".

  3. Set the applet security preferences in your HotJava browser:

    1. Choose Applet Security from Preferences on the Edit menu.

    2. Click Medium Security as the Default setting for Unsigned applets.

  4. When you are ready to begin monitoring the cluster with SCM, type the appropriate URL.


    http://cluster_node/link_to_scm/index.html

  5. Click OK on dialog boxes that ask for permission to access certain files, ports, and so forth from the remote display workstation to the cluster node on which the browser is started.

    Note -

    HotJava takes some time to download and run the applet. No status information will appear during this time.

Refer to the online help for complete information about menu navigation, tasks, and reference.

How to Run the SCM Applet in a Netscape Browser From a Cluster Node

  1. Install Netscape on the cluster nodes.

  2. Install SCM and the required SCM patch on the cluster nodes.

    To install SCM, use scinstall(1M). The scinstall(1M) command installs the SCM package (SUNWscmgr) as part of the server package set. To get the SCM patch, see your service representative or the SunSolve web site:

    http://sunsolve.sun.com/

  3. Add the following lines to the preferences.js file, if necessary.

    The file is located in the $HOME/.netscape directory. If the preferences are not included in the file already, add the following lines: 


    user_pref("security.lower_java_network_security_by_trusting_proxies", true);
user_pref("signed.applets.codebase_principal_support", true);

  4. On a cluster node, set your DISPLAY environment variable so that the Netscape browser is displayed remotely on your X Windows workstation, and then run the Netscape browser on that cluster node.

  5. When you are ready to begin monitoring the cluster with SCM, enter the appropriate URL.


    file:/opt/SUNWcluster/scmgr/index.html

  6. Click Grant on Java Security dialog boxes that ask for permission to access certain files, ports, and so forth from the remote display workstation.

    Refer to the online help for complete information about menu navigation, tasks, and reference.

How to Set Up a Web Server to Run With SCM

If you choose, you can install a web server on the cluster nodes to run with SCM.

Note -

If you are running the Sun Cluster HA for Netscape HTTP service and an HTTP server on SCM, you must configure the HTTP servers to listen on different ports, to prevent a port conflict between the HTTP servers.

  1. Install a web server on all nodes in the cluster.

  2. Follow the web server's configuration procedure to make sure that SCM's index.html file is accessible to the clients.

    The client applet for SCM is in the index.html file in the /opt/SUNWcluster/scmgr directory. For example, go to your HTTP server's document_root and create a link to the /opt/SUNWcluster/scmgr directory.

  3. Run the HotJava browser from your workstation.

  4. Set the applet security preferences in your HotJava browser:

    1. Choose Applet Security from Preferences on the Edit menu.

    2. Click Medium Security as the Default setting for Unsigned applets.

  5. When you are ready to begin monitoring the cluster with SCM, type the appropriate URL.

    For example, if you had created a link from the web server's document_root directory to the /opt/SUNWcluster/scmgr directory, you would type the following URL:


    http://cluster_node/scmgr/index.html

  6. Click OK on dialog boxes that ask for permission to access certain files, ports, and so forth on the cluster node on which the browser is started.

    Note -

    HotJava takes some time to download and run the applet. No status information will appear during this time.

Refer to the online help for complete information about menu navigation, tasks, and reference.

Accessing SCM Online Help

SCM provides online help information about menu navigation, tasks, and reference. This help is available whether you are running SCM as an application or an applet.

To display the Help window from SCM, select Help Contents from the Help menu. Alternatively, click on the Help icon (question mark) in the tool bar above the folder.

If necessary, you can run online help in a separate browser by typing the following URL:


file:/opt/SUNWcluster/scmgr/help/locale/en/main.howtotopics.html

For example, if you had created a link from the web server's document_root directory to the /opt/SUNWcluster/scmgr directory, you would type the following URL:


http://clusternode/scmgr/help/locale/en/main.howtotopics.html

When you finish viewing the online help, close its HotJava browswer. Selecting online help again brings up a new browser and loads the help.