-C H A P T E R

C H A P T E R 2

Installing Sun MAT

This chapter describes the Sun MAT software and explains how to install and start the Sun MAT components. It includes the following topics:

Prerequisites

Installation

Configuring and Starting Sun MAA

Starting Sun MAT

Prerequisites

Any Sun MTP regions that are to be remotely administered through Sun MAA must be at Release 8.0.0 or later.

Sun MAA is a Java application that requires Java 2 Standard Edition (J2SE) version 1.4. Before attempting to start Sun MAA, J2SE 1.4 must be installed on the system where you plan to run Sun MAA.

J2SE version1.4 must also be defined on the $PATH of the user that will start Sun MAA. To test whether J2SE 1.4 is properly defined, type the following commands. The output should be as shown:

$ which java

/usr/java1.4.0/bin/java

$ java -version

java version "1.4.0"

Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.0-b92)

Java HotSpot(TM) Client VM (build 1.4.0-b92, mixed mode)

The location of J2SE might be different on your system. Contact your system administrator to determine if and where J2SE 1.4 is installed. If J2SE 1.4 is not installed on your system, it can be downloaded from:

http://www.java.sun.com

Sun MAT is also a Java application, and can run anywhere that a J2SE 1.4 runtime is available.

Installation

This section describes how to install the Sun MAA and Sun MAT on the various platforms on which they run.

Installing Sun MAA

Sun MAA is distributed as a compressed file named MAA1.0.0.zip. It must be installed on each system on which there are Sun MTP regions that you want to administer.

Follow these guidelines when installing Sun MAA:

Do not install Sun MAA as the root user. Install it as the same user that installed Sun MTP.

You might find it convenient to install Sun MAA in a location analogous to that used for the installation of Sun MTP. For example, if Sun MTP is installed under the directory /pkgs/mtp, you could install Sun MAA under the directory /pkgs/maa. This is not a requirement, however.

To Install Sun MAA

1. Create the top-level installation directory:

$ mkdir -p /pkgs/maa

2. Change to the installation directory:

$ cd /pkgs/maa

3. Extract the archive. For example:

$ unzip /cdrom/MAA1.0.0.zip .

Refer to the unzip(1) man page for information on command options.

The following directory structure is created:

/pkgs/maa/MAA1.0.0

/pkgs/maa/MAA1.0.0/bin

/pkgs/maa/MAA1.0.0/etc

/pkgs/maa/MAA1.0.0/lib

/pkgs/maa/MAA1.0.0/lib/dependencies

MAA1.0.0 indicates the version of Sun MAA that you have installed.

Installing Sun MAT

Sun MAT provides an administrator with a graphical user interface (GUI) to remotely administer Sun MTP regions. It is provided in three distribution formats appropriate for different platforms. The distribution files are named as follows:

MAT1.0.0.tar - For Solaris or other UNIX systems.

MAT1.0.0.exe - For Microsoft Windows. This 32-bit InstallShield executable includes the J2SE 1.4.0 runtime software.

MAT1.0.0.zip - Generic Java distribution, which is suitable for all other platforms.

Choose the installation file most appropriate for your platform.

Installing Sun MAT on Solaris or Other UNIX Systems

Follow these guidelines when installing Sun MAT:

Do not install Sun MAT as the root user. If you are installing Sun MAT on the same system as Sun MAA and Sun MTP, you can use the same user ID as was used to install these products. However, this is not required.

You might find it convenient to install Sun MAA in a location analogous to that used for the installation of Sun MTP and Sun MAA. For example, if Sun MTP is installed under the directory /pkgs/mtp, and Sun MAA under the directory /pkgs/maa, you could install Sun MAT under the directory /pkgs/mat. This is not a requirement, however.

To Install Sun MAT on Solaris or Other UNIX System

1. Create the top-level installation directory:

$ mkdir -p /pkgs/mat

2. Change to the installation directory:

$ cd /pkgs/mat

3. Extract the archive. For example:

$ tar -xvof /cdrom/MAT1.0.0.tar

The following directory structure is created:

/pkgs/mat/MAT1.0.0

/pkgs/mat/MAT1.0.0/bin

/pkgs/mat/MAT1.0.0/doc

/pkgs/mat/MAT1.0.0/doc/images

/pkgs/mat/MAT1.0.0/lib

/pkgs/mat/MAT1.0.0/lib/dependencies

MAT1.0.0 indicates the version of Sun MAT that you have installed.

Installing Sun MAT on Windows Systems

For 32-bit Microsoft Windows platforms, Sun MAT is supplied as a self-installing InstallShield executable. This executable contains an integrated J2SE 1.4.0 runtime.

To Install Sun MAT on Windows Systems

Execute the MAT1.0.0.exe file and follow the on-screen instructions.

Installing Sun MAT on Other Systems

Sun MAT can also be installed and run on other platforms supporting J2SE 1.4.

To Install Sun MAT on Other Systems

1. Create the top-level installation directory:

$ mkdir -p /pkgs/mat

2. Change to the installation directory:

$ cd /pkgs/mat

3. Extract the archive MAT1.0.0.zip to the directory you just created.

The following directory structure is created:

MAT1.0.0

MAT1.0.0/bin

MAT1.0.0/doc

MAT1.0.0/doc/images

MAT1.0.0/lib

MAT1.0.0/lib/dependencies

Note - The bin directory will be empty for this installation.

MAT1.0.0 indicates the version of Sun MAT that you have installed.

Configuring and Starting Sun MAA

Before starting Sun MAA, you must decide on a port number on which the agent will listen, and you must choose the user ID that will start the agent.

Deciding on a Port Number

When Sun MAA starts, it listens for Java Remote Method Invocation (RMI) calls from instances of Sun MAT, by listening on a TCP/IP port. This port is 9980 by default. If you want to use a different port number, you can edit the sunmaa startup script, which is located in the bin directory of the Sun MAA installation. Instructions on editing the script are provided in the script itself.

Choosing an Appropriate User ID

Sun MAA should be started as the same UNIX user that was used to install it. This is usually the same UNIX user that is used to run each of the Sun MTP regions on the system.

In more complex environments, however, several regions can exist, each running as a different UNIX user. In this case, use the following guidelines to decide what UNIX user should run the agent:

The agent must have read access to all of the Sun MAA product files. These are all files under the following directory:

/pkgs/maa/MAA1.0.0/

The agent must have read-write access to the following file:

/pkgs/maa/MAA1.0.0/etc/region_list.xml

The agent must have read access to files in the $KIXSYS directory for each region to which the agent is to provide access.

The agent must have read access to files in the Sun MTP installation directory ($UNIKIX) for each version of Sun MTP for which the agent is to provide administrative access.

To Start Sun MAA

Execute the sunmaa shell script, which is located in the Sun MAA bin directory:

$ /pkgs/maa/MAA1.0.0/bin/sunmaa

Output similar to the following will be displayed on the screen:

MAA: Starting

MAAMaster: control file name is <etc/region_list.xml>

MAA: started RMI connector on port 9980

The etc/region_list.xml control file is the file in which Sun MAA stores information about each region for which it is responsible. Each region that you want to administer must be registered with the agent running on that system. See Registering a Region With Sun MAA.

Starting Sun MAT

This section describes how to start Sun MAT on the different platforms on which it is supported.

To Start Sun MAT on Solaris Systems

1. Verify that the J2SE 1.4.0 runtime is installed on the system and its location is defined in your PATH environment variable.

See Prerequisites.

2. Execute the sunmat shell script, which is located in the Sun MAT bin directory:

$ /pkgs/mat/MAT1.0.0/bin/sunmat

The Sun MAT GUI starts. See FIGURE 2-1.

FIGURE 2-1 Sun MAT Startup Screen

Screen shot of the Sun MAT startup screen.

To Start Sun MAT on Windows

Use either method:

On the Windows desktop, select Start Programs Sun MAT 1.0.0 Administration Tool

Execute the sunmat.exe executable in the product's bin directory.

The Sun MAT GUI starts. See FIGURE 2-1.

To Start Sun MAT on Other Systems

1. Verify that the J2SE 1.4.0 runtime is installed and available on your system.

2. Run the executable JAR file supplied in the lib directory of the Sun MAT installation. Depending on your system, use one of the following methods:

Change to the lib directory and execute the following command:

$ java -jar sunmat.jar

Click on the sunmat.jar file using the GUI of your system.

The Sun MAT GUI starts. See FIGURE 2-1.