Skip to main content
Version: v2.1.x LTS

Installation roadmap

Installation roadmap

When you install Zowe™ on z/OS, you install the following two parts:

  1. The Zowe runtime, which consists of a number of components including:

    • Zowe Application Framework
    • Zowe API Mediation Layer
    • Z Secure Services (ZSS)
  2. The Zowe Cross Memory Server, also known as ZIS, which is an APF authorized server application that provides privileged services to Zowe in a secure manner.

Zowe provides the ability for some of its unix components to be run not under USS, but as a container, see Installing Zowe Containers.

If you want to configure Zowe for high availability, see Installing Zowe z/OS Components with High Availability for instructions.

Stage 1: Plan and prepare#

Before you start the installation, review the information on hardware and software requirements and other considerations. See Planning the installation for details.

Stage 2: Install the Zowe z/OS runtime#

  1. Ensure that the software requirements are met. The prerequisites are described in System requirements.

  2. Choose the method of installing Zowe on z/OS.

    The Zowe z/OS binaries are distributed in the following formats. They contain the same contents but you install them by using different methods. You can choose which method to use depending on your needs.

    • Convenience build

      The Zowe z/OS binaries are packaged as a PAX file which is a full product install. Transfer this to a USS directory and expand its contents. The command zwe install will extract a number of PDS members contain load modules, JCL scripts, and PARMLIB entries.

    • SMP/E build

      The Zowe z/OS binaries are packaged as the following files that you can download. You install this build through SMP/E.

      • A pax.Z file, which contains an archive (compressed copy) of the FMIDs to be installed.
      • A readme file, which contains a sample job to decompress the pax.Z file, transform it into a format that SMP/E can process, and invoke SMP/E to extract and expand the compressed SMP/E input data sets.
    • Portable Software Instance (PSWI)

      You can acquire and install the Zowe z/OS PAX file as a portable software instance (PSWI) using z/OSMF.

    While the procedures to obtain and install the convenience build, SMP/E build or PSWI are different, the procedure to configure a Zowe runtime is the same irrespective of how the build is obtained and installed.

  3. Obtain and install the Zowe build.

After successful installation of either a convenience build or an SMP/E build, there will be a zFS folder that contains the unconfigured Zowe runtime directory, a utility library SZWEEXEC that contains utilities, a SAMPLIB library SZWESAMP that contains sample members, and a load library SZWEAUTH that contains load modules. The steps to prepare the z/OS environment to launch Zowe are the same irrespective of the installation method.

Stage 3: Configure the Zowe z/OS runtime#

You can configure the Zowe runtime with one of the following methods depending on your needs.

  • Use a combination of JCL and the zwe init command
  • Use z/OSMF Workflows

Tip: We recommend you open the links to this configuration procedure in new tabs.

Whether you have obtained Zowe from a .pax convenience build, or an SMP/E distribution, the steps to initialize the system are the same.

  1. Prepare custom MVS data sets. Copy the data sets provided with Zowe to custom data sets.

  2. (Required only if you are configuring Zowe for cross LPAR sysplex high availability): Create the VSAM data sets used by the Zowe API Mediation Layer caching service.

  3. APF authorize load libraries containing the modules that need to perform z/OS priviledged security calls..

  4. Initialize Zowe security configurations. Create the user IDs and security manager settings.

    If Zowe has already been launched on a z/OS system from a previous release of Zowe v2 you can skip this security configuration step unless told otherwise in the release documentation.

  5. Configure Zowe to use TLS certificates.

  6. Install Zowe main started tassks.

Looking for troubleshooting help?#

If you encounter unexpected behavior when installing or verifying the Zowe runtime on z/OS, see the Troubleshooting section for tips.