Skip to main content
Version: v1.27.x LTS

Install the Zowe CLI @next version

Install the Zowe CLI @next version

Technical Preview The Zowe CLI @next release is a technical preview. Technical previews are for testing only and are not ready for production. Your feedback is valued and appreciated.

You can install the Zowe CLI @next version from the online npm registry or download it from the Zowe Downloads site.

Installation guidelines#

To install the CLI @next version on Windows, Mac, and Linux operating systems, follow the steps in Install Zowe CLI from npm or Install Zowe CLI from a download.

However, to install Zowe CLI @next on z/Linux, z/OS UNIX System Services (USS), or on an operating system where the Secure Credential Store is not required or cannot be installed, use the following installation guidelines:

Prerequisites#

Prerequisite notes:

  • If you are installing Zowe CLI @next on a computer that is running Node.js 16 on Windows operating system, see Installing Zowe CLI with Node.js 16 on Windows.

  • If you are running NPM version 7 (npm@7) or NPM version 8 (npm@8) on a Windows operating system, ensure that your computer is connected to the Internet. Issue the following command before you install Zowe CLI @next:

    npm install -g prebuild-install
  • Linux users may need to prepend sudo to npm commands. For more information, see Troubleshooting Zowe CLI.

Install Zowe CLI from npm#

Use the following procedure to install Zowe CLI from an npm registry:

  1. To install or update the core CLI, open a command-line window:

    npm install -g @zowe/cli@next

    Zowe CLI is installed.

  2. (Optional) Check npmjs.com for any Zowe plug-ins that have an @next version available. If an @next version is available, you can install it:

    zowe plugins install @zowe/<plugin-name>@next

    If no @next version is available, install the @latest version of the plug-in:

    zowe plugins install @zowe/<plugin-name>

    Optional plug-ins are installed.

  3. Migrate your Zowe CLI profiles from your current installation to your @next installation. Issue the following command:

    zowe config convert-profiles

    Note: Profile data is backed up in case you want to revert the profiles to your previous Zowe CLI installation.

  4. (Optional) If you no longer require the profiles for your previous Zowe CLI installation, you can delete them.

    Important: We do not recommend deleting the profiles for your previous Zowe CLI installation until you have tested your @next installation and are satisfied with its performance.

    Issue the following command:

    zowe config convert-profiles --delete

You can now try out the technical preview features.

Install Zowe CLI from a download#

Use the following procedure to install Zowe CLI from a download package:

  1. Navigate to Zowe Downloads and click the Zowe vNext CLI Core button.

  2. Read the End User License Agreement for Zowe and click I agree to download the core package.

    zowe-cli-package-next-2021MMDD.zip is downloaded to your computer (where MMDD indicates the month and day of the build).

  3. (Optional) Navigate to Zowe Downloads and click the Zowe vNext CLI Plugins button to download the plugins.

  4. (Optional) Read the End User License Agreement for Zowe plugins and click I agree to download the plugins package.

    zowe-cli-plugins-next-2021MMDD.zip is downloaded to your computer (where MMDD indicates the month and day of the build).

  5. Unzip the contents of zowe-cli-package-next-2021MMDD.zip (and optionally zowe-cli-plugins-2021MMDD.zip) to a working directory.

  6. Open a command-line window and issue the following commands to the working directory:

    npm install -g zowe-cli.tgz

    Note: If an EACCESS error is returned, refer to Resolving EACCESS permissions errors when installing packages globally in the npm documentation.

    (Optional)

    zowe plugins install 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
  7. Migrate your Zowe CLI profiles from your current installation to your @next installation. Issue the following command:

    zowe config convert-profiles

    Note: Profile data is backed up in case you want to revert the profiles to your previous Zowe CLI installation.

  8. (Optional) If you no longer require the profiles for your previous Zowe CLI installation, you can delete them.

    Important: We do not recommend deleting the profiles for your previous Zowe CLI installation until you have tested your @next installation and are satisfied with its performance.

    Issue the following command:

    zowe config convert-profiles --delete

You can now try out the technical preview features.