Upgrading OMEGAMON Data Connect

Move your OMEGAMON® Data Connect configuration files to user directories and upgrade your methods of running OMEGAMON Data Connect.

Procedure

  1. Move your existing OMEGAMON Data Connect configuration files to user directories.

    This APAR introduces user directories as a formalized structure for storing your site-specific OMEGAMON Data Connect configuration details.

    Perform the following steps for each of your existing OMEGAMON Data Connect configuration files:

    1. Use the create action of the supplied shell script to create a user directory.

      For example, at a shell prompt, change to the bin directory under the OMEGAMON Data Connect installation directory, and then enter the following command, where /var/omdp/prod-a is the user directory that you want to create:

      ODP_CONNECT_USER_DIR=/var/omdp/prod-a ./connect create
    2. Move your existing configuration file to the relative path config/connect.yaml under the new user directory. Overwrite the sample configuration file that the script copied to that directory.
  2. If you use a z/OS® JCL procedure to run OMEGAMON Data Connect, upgrade your procedure based on the latest sample.
    1. Replace your procedure with the latest sample procedure supplied in TKANSAM(KAYCONN).
    2. Edit the values of the symbolic parameters at the start of the procedure.
      JAVAHOME
      The path of the installation directory of Java™ 8, or later, 64-bit edition. The directory must contain a bin subdirectory that contains the java command.
      INSTLDIR
      The path of the OMEGAMON Data Connect installation directory.
      USERDIR
      The path of your OMEGAMON Data Connect user directory.
  3. If you use the supplied sample shell script to run OMEGAMON Data Connect, change your method for invoking the script to match the latest sample.

    Changes to the sample shell script include:

    • To run OMEGAMON Data Connect, you must now specify the command-line argument run.
    • You must set the value of the environment variable ODP_CONNECT_USER_DIR to refer to the path of the OMEGAMON Data Connect user directory.

    For more details on the changes to the shell script, see What's new in OMEGAMON Data Provider and Sample shell script to run OMEGAMON Data Connect.

  4. If you use your own custom Java command line to run OMEGAMON Data Connect, upgrade your command line to reflect the changes in OMEGAMON Data Connect.

    In particular, note the new JAR file name in the -jar option and the new -Dodp.ext option.

    For details on changes to the Java command line, see What's new in OMEGAMON Data Provider and Java command line to run OMEGAMON Data Connect.