Skip to main content
Version: v1.3.x

Installing Node.js on z/OS

Installing Zowe requires Node.js Version 6.14.4.1 or later to be installed on the z/OS host where you install the Zowe Application Server.

How to obtain IBM SDK for Node.js - z/OS#

IBM SDK for Node.js - z/OS, V6.0 (5655-SDK) is available at no license charge, as announced in October 2018. You can obtain the free SDK for IBM Z Mainframe in one of several ways, depending on your requirements. For details, see the blog "How to obtain IBM SDK for Node.js - z/OS, at no charge".

To satisfy Zowe's prerequisite for Node.js - z/OS, you can choose one of the following ways:

  • Order the SMP/E version through your IBM representative for production use
  • Use the pax evaluation for non-production deployments

Hardware and software requirements#

Hardware:

IBM zEnterprise® 196 (z196) or newer

Software:

  • z/OS V2R2 with PTF UI46658 or z/OS V2R3
  • z/OS UNIX System Services is enabled
  • Integrated Cryptographic Service Facility (ICSF) must be configured and started.

Installing Node.js#

The following section summarizes the required configuration steps for installing the pax evaluation version of Node.js - z/OS to run Zowe.

  1. Download the pax.Z file from the Download section to a z/OS machine.

  2. Extract the pax.Z file inside an installation directory of your choice. For example:

    pax -rf <path_to_pax.Z_file> -x pax

  3. Add the full path of your installation directory to your PATH environment variable:

    export PATH=<installation_directory>/bin/:$PATH
  4. Run the following command from the command line to verify the installation.

    node --version

    If Node.js is installed, the version of Node.js is displayed.

  5. After you install Node.js, set the NODE_HOME environment variable to the directory where Node.js is installed. For example, NODE_HOME=/proj/mvd/node/installs/node-v6.14.4-os390-s390x.

To troubleshoot or read more information, see the documentation for IBM SDK for Node.js - z/OS.