C H A P T E R 12 - Sun Mainframe Administration Tool (Sun MAT)

C H A P T E R 12

Sun Mainframe Administration Tool (Sun MAT)

This chapter describes the Sun MAT software. It includes the following topics:

Introduction to Sun MAT

Prerequisites

Installation

Configuring and Starting Sun MAA

Starting Sun MAT

Accessing Sun MTP Regions

Displaying Region Information

Introduction to Sun MAT

The Sun MAT software is designed to provide remote administrative access to one or more Sun MTP regions running on one or more systems distributed throughout a network. The tool is comprised of three components:

Sun MAT, the graphical user interface (GUI) used to administer regions

Sun Mainframe Administration Agent (Sun MAA), which provides the interface between the GUI and the regions being administered

The unikixadmin process, which executes under the control of Sun MTP

Each system hosting one or more Sun MTP regions must also host a running instance of Sun MAA to provide access to those regions. Sun MAT can run anywhere in the network.

In a simple environment where one system has one region to be administered, the three components (Sun MAT, Sun MAA, and Sun MTP) are all co-located, as shown in the following figure:

FIGURE 12-1 Single Region/Single System Environment

Diagram showing how un MAT connects to a region through Sun MAA when all three are on a single system.

The following figure illustrates a more complex environment that has multiple regions running on multiple systems, all monitored from a single point.

FIGURE 12-2 Multiple Region/Multiple System Environment

Diagram showing a single instance of Sun MAT connecting to multiple regions located on two different hosts.

It is also possible for more than one administrator to run Sun MAT concurrently and access the same regions. This is illustrated in FIGURE 12-3.

FIGURE 12-3 Multiple Regions Accessed by Multiple Sun MATs

Diagram showing two instances of Sun MAT on two systems connecting to multiple regions, which are located on two different remote hosts.

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 tar file named MAA1.0.0.zip. It should 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 tar archive. For example:

$ unzip /cdrom/MAA1.0.0.zip .

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

This will create the following directory structure:

/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 userid 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 tar archive:

$ tar -xvof tar-file-location

where tar-file-location specifies the location of the MAT1.0.0.tar file.

This will create the following directory structure:

/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 a directory or folder for the Sun MAT product.

2. Unpack the zip archive MAT1.0.0.zip to the directory you just created.

This will create the following directory structure:

MAT1.0.0

MAT1.0.0/doc

MAT1.0.0/doc/images

MAT1.0.0/lib

MAT1.0.0/lib/dependencies

Note - There is no bin directory for this type of 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 userid 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 the 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 UserID

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 or Other UNIX 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 12-4.

FIGURE 12-4 Sun MAT Startup Screen

Screen shot showing 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 12-4.

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

Accessing Sun MTP Regions

This section describes the procedures you must perform to access each of the regions you want to administer.

To Access Sun MTP Regions

1. Start Sun MAA.

See Configuring and Starting Sun MAA.

2. Start Sun MAT.

See Starting Sun MAT.

3. Configure Sun MAT to access each system on which an agent (Sun MAA) is running.

See Configuring Sun MAT to Access an Agent System.

4. Register each region running on a system with the agent (Sun MAA) running on that system.

See Registering a Region With Sun MAA.

Configuring Sun MAT to Access an Agent System

The example in this section uses a simple configuration like the one shown in the following figure. The procedure also applies to complex configurations.

In this example Sun MAT is running on the same system as Sun MAA, although it need not be. Sun MAA has been started listening on the default port of 9980.

FIGURE 12-5 No Access From Sun MAT to a Region

Diagram showing a single host running Sun MAT, Sun MAA, and a Sun MTP region.

[ D ]

To Access an Agent System

1. Make sure Sun MAA is started.

See Configuring and Starting Sun MAA

2. Make sure Sun MAT is started and the GUI is displayed.

See Starting Sun MAT.

3. On the GUI menu, select File right arrow Add Machine.

This option will make an agent known to Sun MAT. See FIGURE 12-6.

FIGURE 12-6 Adding a System

Screen shot showing the Add Machine dialog box.

4. In the dialog box:

a. Type the name of the system on which the agent is running.

b. Verify the port number on which the agent is listening.

c. Click OK.

Sun MAT will contact the agent, and a machine entry will be displayed in the tree panel on the left side of the Sun MAT display.

FIGURE 12-7 Machine Entry

Screen shot showing the Network tab in the Sun MAT GUI. It contains an entry for a machine.

Note - Sun MAT treats an instance of an agent and the system on which that agent is running as being synonymous, because there is typically only one agent instance on each system. Sun MAT, therefore, uses the terminology Add Machine.

Communication is now established between Sun MAT and Sun MAA, as shown in FIGURE 12-8.

FIGURE 12-8 Sun MAT Access to Sun MAA

Diagram showing that Sun MAT can access Sun MAA on the system. The region is not yet accessible.

Registering a Region With Sun MAA

Before a region can be registered with an agent, the region must be started with the unikixadmin process enabled. The unikixadmin server is a daemon process that allows a region to be monitored by Sun MAT.

To Enable the unikixadmin Server

1. Make sure the LD_LIBRARY_PATH environment variable points to the location of the Java virtual machine (JVM).

2. Start the region using the -X option to unikixmain.

The -X option requires that you specify the port number to be used by unikixadmin. It must be a unique port number. For example:

$ unikixmain -X 9876 other options

When the unikixadmin server starts as part of region initialization, a message similar to the following is written to the unikixmain.log file:

08/30/2002 13:08:17 unikixmain :KIX0173I Process 1234 of type a started

The server advertises its startup with a message similar to the following:

08/30/2002 13:08:19 unikixadmin :KIX0301I Entering (VER. 8.0.0 - 08/28/2002

To Register a Region With Sun MAA

1. Start Sun MAT.

Starting Sun MAT.

2. In the left tree pane, highlight the machine where the region you want to register is located.

3. On the menu, select File right arrow Register Region.

FIGURE 12-9 Registering a Region

Screen shot showing the Register Region dialog box.

4. In the dialog box:

a. Type the name of the region as you want it to display on the screen.

b. Type the fully qualified directory name of the region's $KIXSYS directory.

Note - The agent will determine the port number the unikixadmin daemon is listening on by accessing $KIXSYS.

c. Click OK.

An entry representing the region will appear beneath the machine name in the left pane of the Sun MAT GUI. You can now use Sun MAT to perform administrative functions on the region.

FIGURE 12-10 Region Entry

Screen shot showing the Network tab in the Sun MAT GUI. It shows that a region has been added.

Note - Since the region is directly registered only with its agent, it will immediately become visible to the user of any other instance of SunMAT that has been configured to access the same agent.

The details about the region are stored by the agent to a local disk file (etc/region_list.xml under the Sun MAA installation directory), so that they will be available even after the agent is stopped and restarted.

FIGURE 12-11 shows a region that is accessible to Sun MAT.

FIGURE 12-11 Access to a Region

Diagram showing that Sun MAT has access to the region through Sun MAA. It also shows that Sun MAA maintains the etc/region_list.xml file.

Displaying Region Information

To Display Region Information

Double-click the region entry in the left pane.

FIGURE 12-12 shows the region's Overview tab.

Refer to the Sun Mainframe Administration Tool User's Guide for information about using the tool.

FIGURE 12-12 Region Overview Screen

Screen shot showing the region's Overview screen in the Sun MAT GUI.