Install IZSME in Zowe 3

You can install IZSME into a Zowe 3 instance to effectively monitor and manage IBM Z systems.

Before you begin

The following requirements apply:
  • You can install IZSME in Zowe 3.1 and later.
  • The minimum required IZSME PTF level is OA65763.

About this task

This task uses the following sample jobs that are provided in the #tgthlq.SIUWSAMP data set:
  • IUWMUNPX
  • IUWMUPPT

In each job, the JCL provides instructions about how to customize the job before running it.

Procedure

  1. Install IZSME base by running the IUWMUNPX job, which extracts the base IZSME runtime files into the IZSME installation directory.
    Note: You can follow the instructions inside the script to learn how you can customize your environment.
  2. Update IZSME runtime files by running the IUWMUPPT job, which extracts an IZSME PTF.
    Note: You can follow the instructions inside the script to learn how you can customize your environment.
  3. Add the "javaHome": <PATH_TO_JAVA_V8_DIRECTORY> parameter into the pluginConfig.json file located in <IZSME_HOME>/ctds/teps_utils/config.
    The following example illustrates how the contents of pluginConfig.json appear after making the necessary edits:
    {
      "javaHome": /rsusr/java/IBM/J8.0_64
    }
    Where:
    • PATH_TO_JAVA_V8_DIRECTORY is the absolute path to Java v8 runtime directory.
    • IZSME_HOME is the absolute path to the IZSME directory.
    Remember: If pluginConfig.json does not exist in <IZSME_HOME>/ctds/teps_utils/config directory, it must be created at the location specified—this pluginConfig.json file is used only during an installation or update of IZSME, not for run.
  4. Install the IZSME components into Zowe by running the following command:
    <ZOWE_RUNTIME_DIRECTORY>/bin/zwe components install -c <ZOWE_YAML> -o <IZSME_HOME>
    Where:
    • ZOWE_RUNTIME_DIRECTORY is the absolute path to the Zowe runtime directory.
    • ZOWE_YAML is the absolute path to the Zowe YAML file for an instance.
    • IZSME_HOME is the absolute path to the IZSME directory.
  5. Add the "javaHome": <PATH_TO_JAVA_V8_DIRECTORY> parameter into the pluginConfig.json file located in the <ZOWE_HOME>/ workspace/app-server/ZLUX/pluginStorage/com.rs.tep.queryhandler/pluginConfiguration directory.
    The following example illustrates how the contents of pluginConfig.json appear after making the necessary edits:
    {
      "javaHome": /rsusr/java/IBM/J8.0_64
    }
    Where:
    • PATH_TO_JAVA_V8_DIRECTORY is the absolute path to Java v8 runtime directory.
    • IZSME_HOME is the absolute path to the IZSME directory.
    Remember: If pluginConfig.json does not exist in <ZOWE_HOME>/workspace/app-server/ZLUX/pluginStorage/com.rs.tep.queryhandler/pluginConfiguration directory, it must be created at the location specified—this pluginConfig.json file is used only during IZSME run, not for installation or update.
  6. Disable node clustering in the Zowe instance by adding the following line to the zowe.yaml configuration file, as IZSME does not support node clustering:
    zowe.environments.ZLUX_NO_CLUSTER: 1
    zowe.configmgr.validation: "COMPONENT-COMPAT"
    components.zss.agent.64bit: false
  7. Restart the Zowe server.