Installing files to automate events

Using the included Perl on Windows

The included Perl is automatically installed in InstallDir\perl. This Perl script contains a stock version of Perl 5.14 with the TrueSight Middleware and Transaction Monitor (TMTM) API extensions already installed. It is recommended that the included version of Perl be used.

Ensure that your user environment is set up such that the included Perl is executed. Set the PATH environment variable to include InstallDir\perl\bin before any other directories on the path that include Perl.

Installing an external Perl script on Windows

Before you begin

Ensure that 32 bit ActivePerl is installed on your system. It is recommended that the new included version of Perl be used.

To install the files on Windows to automate events

1. From a command prompt, change the active directory to InstallDir\automationperl version (example: InstallDir\automation\perl-5-10).
2. Install the QPasa package on Windows by typing the following:
   
   ppm install QPasa.ppd
3. If any errors appear that indicate that QPasa.ppd already exists, remove the old QPasa.ppd and then install the new version:
   
   ppm remove Qpasa
   ppm install Qpasa.ppd
4. Restart the TMTM Event Service and start the TMTM Client Gateway Service.

Using the included Perl on Linux

The included Perl is automatically installed in InstallDir/perl. Ensure that your user environment is set up such that the included Perl is executed.

Set the PATH environment variable to include InstallDir/perl/bin before any other directories on the path that include Perl.

Set the LD_LIBRARY PATH to include InstallDir/perl/lib before any other directories on the path that include Perl.

After changing the user environment, verify the correct Perl binaries are used by running the command:

hash –r
 which perl

This command responds with the copy of Perl being used.

Installing an external Perl script on Linux

Before you begin

• Ensure that 64 bit Perl is installed on your system.
• For the following steps, wherever you see PerlAPIDir, use the InstallDir/automation/perl version directory.

To install the files on Linux to automate events

To enable your shell environment to locate the proper Perl modules, you can select to either customize your shell environment, or you can place or link the files in the existing Perl path.

1. To customize your shell environment, set the PERLLIB environment variable and library path variable.
   
   Put the variables in the profile file for the user running TMTM.
   
   PERLLIB=PerlAPIDir/blib/lib:PerlAPIDir/blib/arch/auto/QPasa:$PERLLIB
   LD_LIBRARY_PATH=PerlAPIDir/blib/arch/auto/QPasa:PerlAPIDir/automation:$LD_LIBRARY_PATH
2. To place or link the files in the existing Perl path, follow these instructions: at the command prompt, type perl -V. At the end of the output there is the line "@INC:". This is the list of locations where Perl looks for scripts and libraries. These locations might require root access. 
3. Restart the TMTM Event Service and start the TMTM Client Gateway Service.