Skip to main content
Version: v3.0.x LTS

Zowe CLI system requirements

Last updated
:  |
... min read
|
Edit this page
Print
Open doc issue

Zowe CLI system requirements

Before installing Zowe CLI, ensure that your environment meets the prerequisites that are described here.

Required role: systems administrator

Client-side requirements​

Zowe CLI is supported on Windows, Linux, and Mac operating systems. Meet the following requirements before you install the CLI.

Node.js​

The JavaScript runtime environment Node.js must be installed to run JavaScript applications (such as Zowe CLI) outside of a web browser.

To install Node.js:

  1. Go to Node.js LTS to select and install a runtime version with active support.

For a list of supported LTS versions, see Nodejs Releases.

  1. Restart the command prompt after installing Node.js, if required.

  2. Verify that Node.js is installed. Issue the following command in the command prompt:

node --version

Node.js is installed on your PC when a message returns with the correct Node.js version.

If you issue the node --version command and get an error message, confirm that your PATH environment variable includes the path to the Node.js installation location.

npm​

Node Package Manager (npm) is included with most Node.js installations and is used to install and manage Node.js packages on your personal computer. (Zowe CLI supports the npm version packaged with Node.js.)

Your installed version of npm must be compatible with your version of Node.js.

To determine the installed version of npm:

  1. Issue the following command in the command prompt:
npm --version

A message returns with the installed version of npm.

  1. Verify that your installed version of npm is compatible with your version of Node.js by referring to the Node.js release matrix.

    If your npm version is not compatible, install a new version of Node.js.

Secure credential storage​

On Linux systems, you must install the packages gnome-keyring and libsecret (or libsecret-1-0 on Debian and Ubuntu).

For information on performing this configuration, see Configuring secure credential storage on headless Linux operating systems.

Plug-in client requirements​

If you plan to install plug-ins, review the Software requirements for CLI plug-ins.

important

Ensure that you meet the client-side requirements for the IBM Db2 plug-in before it is installed.

Host-side requirements​

IBM z/OSMF​

IBM z/OSMF must be configured and running.

You do not need to install the full Zowe solution to install and use Zowe CLI.

Minimally, an instance of IBM z/OSMF must be running on the mainframe before you can issue Zowe CLI commands successfully. z/OSMF enables the core capabilities, such as retrieving data sets, executing TSO commands, submitting jobs, and more.

If Zowe API Mediation Layer (API ML) is configured and running, Zowe CLI users can choose to connect to API ML rather than to every separate mainframe service.

Plug-in services​

Services for plug-ins must be configured and running.

Plug-ins communicate with various mainframe services. The services must be configured and running on the mainframe before issuing plug-in commands. For example, the CICS plug-in requires an instance of IBM CICS on the mainframe with CICS management client interface (CMCI) (REST services) running. For more information, see Software requirements for CLI plug-ins

Zowe CLI on z/OS is not supported​

Zowe CLI can be installed on an IBM z/OS environment and run under Unix System Services (USS). However, the IBM Db2 plug-in and the Zowe Secrets SDK cannot run on z/OS due to native code requirements. This means that any z/OS credentials display as plain text on a team configuration file. As such, Zowe CLI is not supported on z/OS and is currently experimental.

Free disk space​

Zowe CLI requires approximately 100 MB of free disk space. The actual quantity of free disk space consumed might vary depending on your operating system, the plug-ins that you install, and the user profiles that are saved to disk.

On this page