Skip to main content
Version: v1.8.x

Verifying Zowe installation on z/OS

After Zoweâ„¢ is running, follow the instructions in the following sections to verify that the components are installed correctly and are functional.

Verifying Zowe Application Framework installation#

If the Zowe Application Framework is installed correctly, you can open the Zowe Desktop from a supported browser.

From a supported browser, open the Zowe Desktop at https://myhost:httpsPort/ZLUX/plugins/org.zowe.zlux.bootstrap/web/index.html

where:

  • myHost is the host on which you installed the Zowe Application Server.

  • httpPort is the port number that is assigned to node.http.port in zluxserver.json.

  • httpsPort is the port number that is assigned to node.https.port in zluxserver.json.

    For example, if the Zowe Application Server runs on host myhost and the port number that is assigned to node.https.port is 12345, you specify https://myhost:12345/ZLUX/plugins/org.zowe.zlux.bootstrap/web/index.html.

Verifying z/OS Services installation#

After the ZWESVSTC procedure is started, you can verify the installation of z/OS Services from an internet browser by entering the following case-sensitive URL:

https://hostName:<_gatewayPort_>/api/v1/jobs?prefix=*

where, gatewayPort is the port number that is assigned to ZOWE_ZLUX_SERVER_HTTPS_PORT in the instance.env file used to launch Zowe, see Configure instance directory.

Verifying API Mediation installation#

Use your preferred REST API client to review the value of the status variable of the API Catalog service that is routed through the API Gateway using the following URL:

https://hostName:basePort/api/v1/apicatalog/application/health

The hostName is set during installation, and basePort is set as the gatewayPort parameter.

Example:

The following example illustrates how to use the curl utility to invoke API Mediation Layer endpoint and the grep utility to parse out the response status variable value

$ curl -v -k --silent https://hostName:basePort/api/v1/apicatalog/application/health 2>&1 | grep -Po '(?<=\"status\"\:\")[^\"]+'
UP

The response UP confirms that API Mediation Layer is installed and is running properly.