Installation Checklist for Zowe z/OS Components for Testing and Minimum Viable Product (MVP)

Follow the steps in this checklist to guide you through the installation of Zowe z/OS Components for testing purposes or for the minimum viable product. Use this installation procedure to get familiar with Zowe installation time, performance and system requirements, or to develop a plug-in for a Zowe component. This procedure does not require configuration of high availability.

Preparing and Installing

Preparation/Installation Step	Task	Results	Time Estimate
Plan the Installation and address system requirements	1. Plan the Installation 2. Address USS considerations for Zowe 3. Address System requirements:     * z/OS     * Node.js     * Java     * z/OSMF       (recommended for full functionality)     * z/OSMF HA       (required for production)	All prerequisites satisfied to install Zowe z/OS components	1 day
Install z/OS Components	Use one of the following installation options: Option 1: Install Zowe runtime from a convenience build Option 2: Install Zowe with SMP/E Option 3: Install Zowe with a portable software instance	Executables and binaries are unpaxed on mainframe	1 hour

Configuring Zowe z/OS Components

Configuration Step	Task	Results	Time Estimate
Configure base	1. Initialize Zowe     Use one of the following options:     Option 1: Initialize Zowe manually     using zwe command group       a. Prepare zowe.yaml configuration file           if the file does not already exist       b. Initialize Zowe custom data sets          (zwe init mvs)       c. APF authorize load libraries          (zwe init apfauth)       d. Initialize Zowe security configurations          (zwe init security)       e. Install Zowe main started tasks          (zwe init stc)     Option 2: Configure Zowe with z/OSMF     workflows 2. Configure the z/OS system for Zowe 3. Grant users permission to access z/OSMF 4. Install and configure the Zowe cross memory server (ZWESISTC)	* All datasets are created and populated. See Initialize MVS Datasets Results * Started tasks are copied to system libraries * APF authorization is granted to load libraries * Zowe user is created and is asigned all required permissions * Your z/OS and security product are configured	4 hours
Configure the Caching Service storage	Use one of the following storage methods: * Use inMemory (This method is designed only to perform a quick start of a service for test purposes. This method is the simplest to implement and recommended for testing.) * Use Infinispan * Use VSAM (Infinispan and VSAM are the recommended storage methods for production and required to use Zowe in High Availability mode.)	Storage for the Caching service is configured	1 hour
Configure certificates	Zowe is able to use PKCS12 certificates or certificates held in a z/OS Keyring. Use one of the following options: Option 1: Use zwe command group * Configure PKCS12 certificates (This method allows you to create a self-signed PKCS12 certificate, and is the simplest configuration for mvp)    or * Configure JCERACFKS certificates in a key ring Option 2: Set up Zowe certificates using workflows	Your certificates are configured and stored securely	2 hours

Starting and Stopping Zowe

Start/Stop Step	Task	Results	Time Estimate
Start and stop the cross memory server ZWESISTC on z/OS	The ZWESISTC task starts and stops the ZWESASTC task as needed	The cross memory server is run as a started task from the JCL in the PROCLIB member ZWESISTC	5 minutes
Start and stop the Zowe main server ZWESLSTC on z/OS	Option 1: Use zwe to start and stop the main Zowe server Option 2: Manually start and stop the Zowe main server ZWESLSTC	You started or stopped Zowe main server ZWESLSTC on z/OS with zwe or manually	20 minutes

Verify Zowe installation on z/OS

Verification Step	Task	Results	Time Estimate
Verify Zowe Application Framework installation	Open the Zowe Desktop from a supported browser	You should be able to open the Zowe Desktop from a supported browser.	20 minutes
Verify API Mediation installation	Use a REST API client to review the value of the status variable of the API Catalog service routed through the API Gateway	See the example presented in Verify API Mediation installation	15 minutes
Verify z/OS Services installation	Zowe z/OS services usually are registered with Zowe APIML Discovery	You should see JSON format data of all jobs running on the system	15 minutes