Stand-alone Generic Log Adapter v4.3
Installation Guide

This install guide describes how to install the TPTP Generic Log Adapter stand-alone run-time package. This package is used to run the Generic Log Adapter as a stand-alone application. It can be downloaded from the Eclipse Test and Performance Tools Platform download site.

This installation guide contains the following information:

Software prerequisites

Installing the Adapter Configuration Editor

The Adapter Configuration Editor is a tool for creating, modifying and testing adapter configuration files. Adapter configuration files provide the Generic Log Adapter with information necessary to parse log files and specify which log files to parse, how to parse them, and what to do with the parsed log file data. The Adapter Configuration Editor is included in the Monitoring Tools package of the Eclipse Test and Performance Tools Platform.

To install Adapter Configuration Editor, the Platform SDK and Monitoring Tools SDK packages are required to be installed. These packages can also be downloaded from the Eclipse Test and Performance Tools Platform download site. For more information on installing these packages refer to the Eclipse Test and Performance Tools Platform Installation Guide.

For information about using the Adapter Configuration Editor to create static or rule-based adapters, see Stand-alone Generic Log Adapter v4.3 User's Guide.

Installing the TPTP Generic Log Adapter Runtime

The TPTP Generic Log Adapter runtime package consists of the following components:

To install the Generic Log Adapter runtime:

  1. Unzip the stand-alone Generic Log Adapter package. Typically, the package name has the form tptp.gla.runtime-VersionInfo.zip. The Generic Log Adapter package includes a root directory called GenericLogAdapter.
    Note: If you are installing on a z/OS system, use the following commands to unzip the GLARunTime.zip file:
    1. unzip -a tptp.gla.runtime-VersionInfo.zip
    2. unzip -o tptp.gla.runtime-VersionInfo.zip *.adapter
    3. unzip -o tptp.gla.runtime-VersionInfo.zip *.xsd
  2. Open the command file for running the Generic Log Adapter:
  3. Replace the value for GLA_HOME with the Generic Log Adapter install directory. For example, if you unzipped the Generic Log Adapter package in the c:\ directory, set GLA_HOME=c:\GenericLogAdapter.
  4. Update the class path as required. For example, if you wrote a static parser or substitution extension class you need to add them to the class path in order for the Generic Log Adapter to execute them.

The gla.bat and gla.sh files execute the Generic Log Adapter with an adapter configuration file specified as a command line parameter. For example, gla.bat myadapter.adapter. The adapter configuration file describes the log file to parse, the rules used to parse the file and the destination of the resulting parsed data.

For information about using the stand-alone Generic Log Adapter, see Stand-alone Generic Log Adapter v4.3 User's Guide.