Verifying Zowe installation on z/OS
Verifying Zowe installation on z/OS
After the Zowe™ started task ZWESLSTC
is running, follow the instructions in the following sections to verify that the components are functional.
- Verifying Zowe Application Framework installation
- Verifying API Mediation installation
- Verifying z/OS Services installation
Note: Not all components may have been started. Which components have been started depends on your setting of the component enabled
status in Zowe configuration file (usually zowe.yaml
). If you set enabled
to be true
for gateway
, discovery
and api-catalog
, the API Mediation Layer and z/OS Services are started. If you set enabled
to be true
for app-server
and zss
, the Zowe Application Framework (also known as Zowe desktop) are started. Those using containerization may only have ZSS
started. For more information, see reference of YAML configurations - components.
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
where,
-
myHost is the host on which you installed the Zowe Application Server.
-
httpsPort is the port number value
components.app-server.port
inzowe.yaml
. For more information, see Configure component app-server.For example, if the Zowe Application Server runs on host myhost and the port number that is assigned to
components.app-server.port
is 12345, you specifyhttps://myhost:12345
. The web desktop uses page direct to the actual initial page which ishttps://myhost:12345/ZLUX/plugins/org.zowe.zlux.bootstrap/web/index.html
. If the redirect fails, try the full URL.
If the desktop appears but you are unable to log on, check Cannot log into the Zowe desktop for troubleshooting tips.
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://myhost:httpsPort/apicatalog/api/v1/application/health
where,
- myHost is the host on which you installed the Zowe API Mediation Layer.
- httpsPort is the port number value
zowe.externalPort
inzowe.yaml
. For more information, see Domain and port to access Zowe.
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. The curl
command is a powerful tool used for making HTTP requests from the command line. It allows you to send and receive data from various protocols, including HTTP, HTTPS, FTP, and more.
$ curl -v -k --silent https://myhost:httpsPort/apicatalog/api/v1/application/health 2>&1 | awk '/"status":"UP"/' | awk -F\" '{print$4;}'
UP
-
-v
: The-v
option stands for "verbose." When you include this option, curl provides more detailed information during the request and response process. It displays additional information such as the request headers, response headers, and other debugging details. -
-k
: The-k
option stands for "insecure" or "insecure SSL." When you include this option, curl allows insecure connections and bypasses SSL certificate verification. It is useful when making requests to HTTPS URLs with self-signed certificates or when dealing with SSL certificate issues. However, it's important to note that using-k
removes security checks and may expose you to potential security risks. Exercise caution when using this option, especially in production environments.
The response UP
confirms that API Mediation Layer is installed and is running properly. For more instructions about curl
command, please see the tutorial.
Verifying z/OS Services installation
Zowe z/OS services usually are registered with Zowe APIML Discovery and exposed with certain service url like /<service>/api/v1
.
Here we give an example of verifying jobs-api
shipped with Zowe. Please be aware that jobs-api
is not enabled by default if you created your Zowe configuration file from example-zowe.yaml
. To enable jobs-api
, you need to set components.jobs-api.enabled
to be true
and restart Zowe. You can verify the installation of jobs-api
service from an internet browser by entering the following case-sensitive URL:
https://hostName:gatewayPort/jobs/api/v1/jobs?prefix=*
where,
gatewayPort
is the port number that is assigned to zowe.externalPort
in the zowe.yaml
file used to launch Zowe. For more information, see Domain and port to access Zowe.
The above link should prompt you to login. After you input correct user name and password of your target z/OS system, you should see JSON format data of all jobs running on the system.