Upgrading OMEGAMON Data Connect
Move your OMEGAMON® Data Connect configuration files to user directories and upgrade your methods of running OMEGAMON Data Connect.
Procedure
- 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:
- 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
- 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.
- Use the
- If you use a z/OS® JCL procedure to run OMEGAMON Data Connect, upgrade your procedure based on the latest
sample.
- Replace your procedure with the latest sample procedure supplied in TKANSAM(KAYCONN).
- 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.
- 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.
- To run OMEGAMON Data Connect, you must now specify
the command-line argument
- 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.