Installing OMEGAMON Data Provider

If you have the prerequisite software, then OMEGAMON® Data Provider is already installed in your z/OS® SMP/E target libraries. You need to know the location of those libraries. Also, before configuring OMEGAMON Data Provider, you might need to install some components in other locations.

Before you begin

You need to understand the OMEGAMON Data Provider architecture.

Ensure that you have the prerequisite software.

You need to know the SMP/E target locations where OMEGAMON Data Provider is installed. In particular:

  • The high-level qualifiers of the TKANMODP and TKANSAM MVS libraries.
  • The z/OS UNIX directory path specified by the SMP/E DDDEF TKAYHFS. The default path is /usr/lpp/omdp.

If you do not know these locations, then contact the person who installed the prerequisite product offering that contains OMEGAMON Data Provider.

About this task

The following procedure ensures that each component is installed in the correct location.

Procedure

  1. If you are using OMEGAMON monitoring agents as a data source: ensure that your OMEGAMON runtime environment (RTE) load modules are at the prerequisite software levels for OMEGAMON Data Provider.

    If you have not already done so, follow your site-specific procedures to refresh the runtime members in the RKANMOD* libraries of your RTE from the TKANMOD* SMP/E target libraries. For example, perform the GENERATE action of Monitoring Configuration Manager.

    This step ensures that the collection tasks in your RTE support OMEGAMON Data Provider.

  2. Decide whether you want to run OMEGAMON Data Connect on or off z/OS.

    The SMP/E installation steps for product offerings that contain OMEGAMON Data Provider create a z/OS UNIX directory that is specified by the DDDEF name TKAYHFS. The directory contains OMEGAMON Data Connect. The default directory path is /usr/lpp/omdp.

    That z/OS UNIX directory contains one subdirectory and three files:

    kay-110
    The OMEGAMON Data Connect installation directory. This directory contains the expanded files for running OMEGAMON Data Connect.
    KAY11PAX
    A pax interchange format archive file containing the OMEGAMON Data Connect installation directory.
    KAY11SH
    A z/OS UNIX shell script that extracts the pax file KAY11PAX into the subdirectory kay-110. This script will already have been run by an SMP/E APPLY command when the product offering that contains OMEGAMON Data Provider was installed.
    KAY11ZIP
    A compressed binary file with the same contents as the KAY11PAX file, but using a different compressed file format.

    If you want to run OMEGAMON Data Connect on z/OS, but you would prefer to run it from a location that is not an SMP/E target, then copy the installation directory, kay-110, to the z/OS UNIX path of your choice.

    If you want to run OMEGAMON Data Connect off z/OS:

    1. Transfer the compressed binary file KAY11ZIP from z/OS UNIX to another platform, such as Linux®.

      Consider renaming the transferred copy with a .zip file extension.

    2. Create the OMEGAMON Data Connect installation directory kay-110 on that platform by expanding the compressed file.

Results

The software components involved in OMEGAMON Data Provider are now installed in the locations you will run them. Before you run them, you must configure them.