test

Sun Java Enterprise System 5 Monitoring Guide

Installing the Monitoring Console

Due to limitations of the master agent in this release, you cannot have a master agent on the same host as a node agent. As a consequence, the Monitoring Console cannot be installed on the same host as any of the other monitored components of Java ES. It must be installed on its own host, unless you have configured Solaris zones. For more information, see below To Install the Monitoring Console in a Solaris Zone

The installation of Monitoring Console also installs Monitoring Framework as a shared component dependency. The console requires the framework and the Common Agent Container to load the master agent, but unlike the node agent, the master agent is not user-configurable. Specifically, you should not use the mfwkadm command on the host or in the zone where you install Monitoring Console.

ProcedureTo Install the Monitoring Console with the Java ES Installer

Because of a limitation in this beta release, you must install Monitoring Console on a host or Solaris zone where no other Java ES component is installed. As a result, the Monitoring Console is the only component you will install in this procedure.

This procedure uses the installer's graphical interface. For information on how to run the installer in other modes, see Chapter 4, Installing With the Text-Based Interface, in Sun Java Enterprise System 5 Installation Guide for UNIX and Chapter 5, Installing in Silent Mode, in Sun Java Enterprise System 5 Installation Guide for UNIX.

  1. Launch the installer application from the directory the corresponds to your platform in the Java ES release. For further details, see To Begin Installation in Sun Java Enterprise System 5 Installation Guide for UNIX.

  2. After continuing past the welcome screen and accepting the license, choose to Upgrade or Install, select Install New Software, and then click next.

  3. On the component selection screen, select only the Sun Java System Monitoring Console to be installed. Click Next.

  4. The installer checks for needed upgrades to the shared components. When it is done, click Next.

  5. The installer now checks system requirements. If your operating system needs patches, Cancel the installation, add the required patches to your system and restart this procedure. Otherwise click Next.

  6. On the configuration type selection screen, chose Configure Now and on the next custom configuration screen, click Next.

  7. The installer is ready to install the Monitoring Console, click Next to begin. During the installation, you may open the product registration window if you have not yet registered your deployment of Java ES.

  8. When the installation is done, you may review the installation summary and logs and then click Installation Complete to exit the installer.

Next Steps

You should now proceed To Configure the Monitoring Console.

ProcedureTo Install the Monitoring Console in a Solaris Zone

By using Solaris zones, you can install the Monitoring Console on the same physical host as other components of Java ES. Those components will be in the global zone, and you will create a sparse root local zone to be a logical host for the Monitoring Console. Proceed in the following order.

  1. Install and configure all of you Java ES components except the Monitoring Console in the global zone. Complete all post-installation configuration of your selected components in the global zone so that all server instances are running.

  2. As part of the installation in the global zone, the Monitoring Framework will be installed as a shared component in the global zone. Perform all procedures in Chapter 2, Enabling and Configuring the Monitoring Framework that are applicable to your installed components.

  3. On the same host, create a sparse root local zone as the logical host for the Monitoring Console. Because it is a sparse root zone, the Monitoring Framework installed in mfwk-base should be visible (see Default Paths and File Names).

  4. Install the Monitoring Console in the sparse root local zone following the procedure To Install the Monitoring Console with the Java ES Installer.

  5. Configure the Monitoring Framework in the sparse root zone with the following commands:


    cd mfwk-base/bin
./mfwksetup -i

    Using the files from the global zone, this command will create the necessary Monitoring Framework configuration files in the local zone.

Next Steps

You should now proceed To Configure the Monitoring Console.

ProcedureTo Configure the Monitoring Console

This procedure describes how to configure Monitoring Console on a separate physical host. If you installed Monitoring Console on a logical host created by a Solaris zone, the commands are the same but they must be run within that zone's file system.

  1. Use the Monitoring Framework to initialize the master agent with the following commands:


    cd mfwk-base/bin
./masetup -i

  2. Restart the Common Agent Container (cacao) with the following command:


    cacaoadm restart

ProcedureTo Unconfigure the Monitoring Console

If you install and configure Monitoring Console on a host where you wish to install other components, you will not be able to monitor those components because of a conflict in the Monitoring Framework. To monitor the new components with a node agent, you must unconfigure the master agent of the Monitoring Console.

    As root, run the following commands to unconfigure the Monitoring Console:


    cacaoadm stop
cacaoadm unregister-module com.sun.mfwk.masteragent.xml
cacaoadm register-module /etc/mfwk-base/xml/com.sun.mfwk.xml
cacaoadm restart