IBM 51 Appendix A. Common Agent serviceability tool, Components, Running the serviceability tool

Appendix A. Common Agent serviceability tool

This section describes the serviceability tool that captures information about the common agent and the machine the agent is running on.

The serviceability tool is a script that can be run from the common agent installation directory, also referred to as the base directory. The tool collects diagnostic information about the agent and packs the information into an archive that can be used for troubleshooting or can be sent to IBM Customer Support for analysis in the event of problems with the common agent. The archive includes an HTML compilation of the information gathered.

Components

The serviceability tool consists of three key components:

1.A script that runs the tool, which is stored in the base directory of the agent (default: C:\Program Files\tivoli\ep):

v Windows: service.bat

v Unix: service.sh

2.A jar file located in the lib directory (default C:\Program Files\tivoli\ep\lib): casservice.jar

Note: This tool also depends on the guid.jar file being in the lib directory, so it can get the GUID.

3.An output file, CASservice.zip, which is created in the base directory of the agent.

Running the serviceability tool

To run the common agent serviceability tool:

1.Open an Command prompt window.

2.Switch to the base directory of the common agent. 3)

3.Invoke the following script to create a CASservice.zip file in the base directory of the common agent:

vWindows: service

vUNIX/Linux: ./service.sh

Note: If you have multiple common agents on a machine, you need to run the tool in the base directory of each agent that you want to gather service information about. If you intend to send multiple CASservice.zip files to IBM Customer Support, be sure to rename them so they don’t all have the same name.

Contents of the CASservice.zip file

The CASservice.zip file contains the following files:

1.Key system information stored as a file called CASserviceInfo.html that can be viewed by an HTML browser (Internet Explorer 6 recommended). The file is located in the <basedir>\ directory:

© Copyright IBM Corp. 2003, 2006 221