Installing Zowe CLI
Installing Zowe CLI
Install Zowe™ CLI on your computer.
Tip: If you are familiar with command-line tools and want to get started using Zowe CLI quickly, see Zowe CLI quick start. You can learn about new CLI features in the Release notes.
#
Methods to install Zowe CLIUse one of the following methods to install Zowe CLI.
Note: If you do not have access to the public npm registry at your site, you might want to install the CLI via a proxy server. See Installing Zowe CLI Via Proxy for more information.
If you encounter problems when you attempt to install Zowe CLI, see Troubleshooting Zowe CLI.
#
Installing Zowe CLI from a local packageIf you do not have internet access at your site, use the following method to install Zowe CLI from a local package.
Follow these steps:
- Address the following software requirements for the core CLI:
Node.js: Install a currently supported Node.js LTS version. For an up-to-date list of supported LTS versions, see Nodejs.org.
:::tip You might need to restart the command prompt after installing Node.js. Issue the command
node --version
to verify that Node.js is installed. :::npm: Install a version of Node Package Manager (npm) that is compatible with your version of Node.js.
:::tip Npm is included with most Node.js installations. Issue the command
npm --version
to check your current version. You can reference the Node.js release matrix to verify that the versions are compatible. :::
(Linux only) Address the following software requirements for Secure Credential Storage:
(Graphical Linux) Install
gnome-keyring
andlibsecret
on your computer.(Headless Linux) Follow the procedure documented in the SCS plug-in Readme.
Navigate to Zowe.org Downloads and click the CLI Core button to download the core package. The "core" includes Zowe CLI and Secure Credential Store, which enhances security by encrypting your username and password.
A file namedÂ
zowe-cli-package-v.r.m.zip
 is downloaded to your computer(Optional) Click the CLI Plugins button to download the optional plugins.
A file named
zowe-cli-plugins-v.r.m.zip
is downloaded to your computer.Unzip the contents of
zowe-cli-package-v.r.m.zip
(and optionallyzowe-cli-plugins-v.r.m.zip
) to a preferred location on your computer.Open a command-line window. Issue the following commands in sequence against the extracted directory to install core Zowe CLI on your computer:
npm install -g zowe-cli.tgz
zowe plugins install secure-credential-store-for-zowe-cli.tgz
Notes:
- If the command returns an
EACCESS
error, refer to Resolving EACCESS permissions errors when installing packages globally in the npm documentation. - On Linux, you might need to prepend
sudo
to yournpm
commands. For more information, see Troubleshooting Zowe CLI.
- If the command returns an
(Optional) Address the Software requirements for CLI plug-ins. You can install most plug-ins without meeting the requirements, but they will not function until you configure the back-end APIs. The IBM Db2 plug-in requires additional configuration to install.
(Optional) Issue the following command to install each available plug-in:
zowe plugins install cics-for-zowe-cli.tgz db2-for-zowe-cli.tgz zos-ftp-for-zowe-cli.tgz ims-for-zowe-cli.tgz mq-for-zowe-cli.tgz
Important: Ensure that you meet the Software requirements for CLI plug-ins. You can install most plug-ins without meeting the requirements, but they will not function until you configure the back-end APIs. The IBM Db2 plug-in requires additional configuration to install.
Zowe CLI is installed on your computer. Issue the zowe --help
command to view a list of available commands. For information about how to connect the CLI to the mainframe, create profiles, integrate with API ML, and more, see Using CLI.
#
Installing Zowe CLI from an online registryIf your computer is connected to the Internet, you can use the following method to install Zowe CLI from an npm registry.
Follow these steps:
- Address the following software requirements for the core CLI:
Node.js: Install a currently supported Node.js LTS version. For an up-to-date list of supported LTS versions, see Nodejs.org.
:::tip You might need to restart the command prompt after installing Node.js. Issue the command
node --version
to verify that Node.js is installed. :::npm: Install a version of Node Package Manager (npm) that is compatible with your version of Node.js.
:::tip Npm is included with most Node.js installations. Issue the command
npm --version
to check your current version. You can reference the Node.js release matrix to verify that the versions are compatible. :::
(Linux only) Address the following software requirements for Secure Credential Storage:
(Graphical Linux) Install
gnome-keyring
andlibsecret
on your computer.(Headless Linux) Follow the procedure documented in the SCS plug-in Readme.
Issue the following commands in sequence to install the core from the public npm registry. The "core" includes Zowe CLI and Secure Credential Store, which enhances security by encrypting your username and password.
npm install -g @zowe/cli@zowe-v1-lts
zowe plugins install @zowe/secure-credential-store-for-zowe-cli@zowe-v1-lts
Notes:
- If the command returns an
EACCESS
error, refer to Resolving EACCESS permissions errors when installing packages globally in the npm documentation. - On Linux, you might need to prepend
sudo
to yournpm
commands. For more information, see Troubleshooting Zowe CLI.
- If the command returns an
(Optional) Address the Software requirements for CLI plug-ins. You can install most plug-ins without meeting the requirements, but they will not function until you configure the back-end APIs. The IBM Db2 plug-in requires additional configuration to install.
(Optional) To install all available plug-ins to Zowe CLI, issue the following command:
zowe plugins install @zowe/cics-for-zowe-cli@zowe-v1-lts @zowe/db2-for-zowe-cli@zowe-v1-lts @zowe/ims-for-zowe-cli@zowe-v1-lts @zowe/mq-for-zowe-cli@zowe-v1-lts @zowe/zos-ftp-for-zowe-cli@zowe-v1-lts
Zowe CLI is installed on your computer. Issue the zowe --help
command to view a list of available commands. For information about how to connect the CLI to the mainframe, create profiles, integrate with API ML, and more, see Using CLI.