Skip to main content
Version: v1.2.x

Planning the installation

The installation of Zowe consists of two independent processes: installing Zowe runtime on z/OS and installing Zowe CLI on your computer.

When you install Zowe runtime on z/OS, there are two parts:

  • The first part is to install the Zowe Application Framework, the API Mediation Layer, and a number of micro services that provide capability to both.
  • The second part is to install the Zowe Cross Memory Server. This is an authorized server application that provides privileged services to Zowe in a secure manner.

The Zowe CLI is not installed on z/OS and runs on a personal computer. The following diagram shows the installation location of Zowe components.

Zowe installation overview

Installation roadmap#

Installing Zowe involves several steps that you must complete in the order listed. Review the following table that presents the task-flow for preparing your environment and installing and configuring Zowe before you begin the installation process.

TasksDetails
1. Review the pre-installation planning information and prepare your environment to meet the installation prerequisites.See Planning the installation of Zowe z/OS components and System requirements.
2. Allocate enough space for the installation.The installation process requires approximately 1 GB of available space. Once installed on z/OS, API Mediation Layer requires approximately 150MB of space, and the Zowe Application Framework requires approximately 50 MB of space before configuration. Zowe CLI requires approximately 200 MB of space on your computer.
3. Download the installation files and install components of Zowe.To install Zowe runtime on z/OS, see Installing the Zowe runtime on z/OS.
To install Zowe CLI on a computer, see Installing Zowe CLI.
4. (Optional) Troubleshoot problems that occur during installation.See Troubleshooting.

To uninstall Zowe, see Uninstalling Zowe.

Planning the installation of Zowe z/OS components#

The following information is required during the installation process of API Mediation Layer and Zowe Application Framework. Make the decisions before the installation.

  • The HFS directory where you install Zowe, for example, /var/zowe.

  • The HFS directory that contains a 64-bit Javaâ„¢ 8 JRE.

  • The z/OSMF installation directory, for example, /usr/lpp/zosmf/lib.

  • The API Mediation Layer HTTP and HTTPS port numbers. You will be asked for 3 unique port numbers.

  • The user ID that runs the Zowe started task.

    Tip: Use the same user ID that runs the z/OSMF IZUSVR1 task, or a user ID with equivalent authorizations.

  • The mainframe account under which the ZSS server runs must have UPDATE permission on the BPX.DAEMON and BPX.SERVER facility class profiles.