Sun Cluster 2.2 System Administration Guide

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.