Installing products by using z/OS Package Manager

If you are running z/OS® Cloud Broker 2.2 (or later) and z/OS Package Manager suboperator 2.0 (or later), use z/OS Package Manager to install and validate product instances of IBM Open Enterprise Languages and IBM Z Open Automation Utilities.

When installing a z/OS product, you can pull product OCI Artifact from the IBM trusted registry (icr.io). It is recommended that scans and necessary verifications are performed on the OCI Artifact before installing. See IBM z/OS Product OCI Artifacts.


Install a product on z/OS

The following example shows how to use z/OS Package Manager to install a product instance of IBM Open Enterprise SDK for Python on an existing z/OS endpoint.

  1. From the Red Hat OpenShift Container Platform web console, select the Administrator perspective. Then select Operators > Installed Operators. Notice that multiple options can filter your results or route you to specific actions. Click IBM Z and Cloud Modernization Stack - z/OS Package Manager Operator.

    In Figure 1, he Red Hat OpenShift Container Platform web console with Administrator perspective is shown. Installed operators are displayed, including the IBM Z and Cloud Modernization Stack - z/OS Package Manager Operator. Figure 1 – Administrator perspective showing the Installed Operators page

  2. The IBM Z and Cloud Modernization Stack - z/OS Package Manager Operator page includes a series of tabs, tiles, and text to help you understand and administer your z/OS Package Manager Operator installation.

    Select the Install z/OS Product tab.

    In Figure 2, the Red Hat OpenShift Container Platform web console with the z/OS Package Manager details page is shown. A series of horizontal tabs spans is presented, followed by a section entitled 'Provided APIs' which contains a series of tiles, followed by a section entitled 'Description', which contains informational text about the operator and environment variables. Figure 2 – z/OS Package Manager Operator page with Details tab selected

  3. The Install z/OS Product tab shows that a product instance of IBM Open Enterprise SDK for Node.js is installed.

    To install a product instance of IBM Open Enterprise SDK for Python, click the Create ZosProductInstall button.

    In Figure 3, the Red Hat OpenShift Container Platform web console is shown with the z/OS Package Manager page displayed and the Install z/OS Product tab selected. The Create zOSProductInstall button is available. Figure 3 – z/OS Package Manager Operator page with Install z/OS Product tab selected

  4. The Create ZosProductInstall page provides Form view for basic configuration, and YAML view for more configuration options.

    With Form view selected, perform the following actions:

    • Enter a name for the product instance installation in the Name field.
    • From the ZosEndpoint Selection drop-down list, select a ZosEndpoint on which to install the product.
    • Enter name of a z/OS product OCI artifact to install on the z/OS Endpoint. Make sure that the name matches the OCI artifact name on the registry.

      Note: Only add OCI artifacts from IBM trusted registry (icr.io), which have been verified and certified by IBM.

    • In the z/OS Product OCI Artifact Version field, enter an OCI artifact in VRMF (Version, Release, Modification, Fix) format, such as 3.11.0.0. For the latest OCI artifact information, see Release Notes. For other supported versions, see IBM Z & Cloud Modernization Stack - Community.
    • Specify the Registry Location information if not already provided while creating a z/OS Package Manager instance or to override any pre-configured registry location. Enter the registry that you want the IBM z/OS Package Manager to use to pull software to install on the z/OS endpoint.
      • The credential must contain registry-user and registry-password key values in the secret.
      • If a registry is specified with the z/OS Package Manager instance, this variable can be left blank.
      • If a registry location is provided, it will override any pre-configured registry location on the z/OS Endpoint for this product installation. If the variable is left blank, then a pre-configured registry location in the corresponding z/OS Package Manager instance will be used.
    • Select the registry user credential (secret) that IBM z/OS Package Manager will use to authenticate and pull the software from the registry location. The credential must contain registry-user and registry-password key values in the secret. For instructions, see Before creating a z/OS Package Manager instance section.

    To create a product instance, click the Create button.

    In Figure 4, the Red Hat OpenShift Container Platform web console is shown with the Create zOSProductInstall page displayed in Form view. A series of fields and explanatory text provide basic configuration options. Figure 4 – Create ZosProductInstall page with Form view selected

  5. On the z/OS Package Manager Operator page, the created product instance is listed in the ZosProductInstalls section of the Install z/OS Product tab. The Status field updates as the installation runs. To see detailed information about installation status, click the product instance link and review the Conditions section.

    In Figure 5, the Red Hat OpenShift Container Platform web console is shown with the z/OS Package Manager page displayed and the Install z/OS Product tab selected. In the ZosProductInstalls section, the Python product instance has a status of Succeeded. Figure 5 – Product instance shown in the ZosProductInstalls section of the Install z/OS Product tab


Validate the installation on your z/OS system

Complete these steps to validate the product installation on your selected z/OS Endpoint.

  1. On the z/OS Package Manager Operator page, select the Validate z/OS Product tab. Then click the Create ZosProductValidate button.

    In Figure 6, the Red Hat OpenShift Container Platform web console is shown with the z/OS Package Manager page displayed and the Validate z/OS Product tab selected. The Create zOSProductValidate button is available. Figure 6 – Administrator perspective showing the z/OS Package Manager Operator page with Validate z/OS Product tab selected

  2. The Create ZosProductValidate page provides Form view for basic configuration, and YAML view for more configuration options.

    With Form view selected, perform the following actions:

    • Enter a name for the validation in the Name field.
    • From the ZosEndpoint Selection drop-down list, select the ZosEndpoint where the product instance was installed.
    • From the z/OS Product Instance drop-down list, select the product instance that was installed.

    To create a product instance validation, click the Create button.

    In Figure 7, the Red Hat OpenShift Container Platform web console is shown with the Create zOSProductValidate page displayed in Form view. A series of fields and explanatory text provide basic configuration options. Figure 7 – Create ZosProductValidate page with Form view selected

  3. On the z/OS Package Manager Operator page, the created product instance is listed in the ZosProductValidates section of the Validate z/OS Product tab. The Status field updates as the installation runs. To see detailed information about validation status, click the product instance link and review the Conditions section.

    In Figure 8, the Red Hat OpenShift Container Platform web console is shown with the z/OS Package Manager page displayed and the Validate z/OS Product tab selected. In the ZosProductValidates section, the validate-python instance has a status of Succeeded. Figure 8 – Product validation shown in the ZosProductValidates section of the Validate z/OS Product tab


Run the product on z/OS

To run a product instance on z/OS, review that product's installation and configuration information.