Installing and configuring the pax format
The following checklist summarizes the key configuration steps for a successful
installation.
Notes:
- The Program Directory for the product details specific installation requirements and instructions in Chapter 5 and Chapter 6.
- For a complete list of releases, refreshes, and fix packs (also known as PTFs) for the product, see Fix list for IBM Open Enterprise SDK for Node.js
Hardware prerequisites
- IBM® z16™
- IBM z15®
- IBM z14®, IBM z14 Model ZR1
- IBM z13®, IBM z13s®
- IBM zEnterprise® EC12, IBM zEnterprise BC12
Software prerequisites
- z/OS® UNIX System Services enabled on any of following operating systems:
- Integrated Cryptographic Services Facility (ICSF) must be enabled when Open Enterprise SDK for Node.js is run on z13. For more information, see ICSF System Programmer's Guide and ICSF Administrator's Guide.
Note: The recommended shell is Bash. To download bash, visit Bash for z/OS on the Rocket
website.
Optional prerequisites
- Python 3.9 or later releases are required to compile native add-ons. It must also be defined in your PATH environment variable. To obtain IBM Open Enterprise SDK for Python, visit IBM Open Enterprise SDK for Python product page.
- Make 4.1 or later is required to compile native add-ons. Its path must be included in your PATH environment variable. To obtain Make, visit the Make for z/OS download page.
-
IBM C/C++ for Open Enterprise Languages on z/OS 2.0 is required to build native C/C++ add-ons. To install the compiler, download the pax edition of the compiler from the IBM C/C++ for Open Enterprise Languages on z/OS download page.
Configuring
Open Enterprise SDK for Node.js is a z/OS
UNIX-based application, which requires certain configuration on the z/OS UNIX System Services file system to ensure proper operation.
- Validate that
/usr/bin/env
exists. If not configured, see the instructions in Verifying the env command path. - Ensure that
/tmp
has at least 1 GB or more of disk space configured. To use an alternative file system, set theTMPDIR
environment variable to a directory that has sufficient space.
Installing
Follow these steps to install Open Enterprise SDK for Node.js:
- Download the pax archive installable file from the pax edition download page to a z/OS machine.
- Unpax the downloaded pax file using the following
command:
This command creates the installation directory <nodejs_dir> under the current directory.$ pax -p p -r -f <downloaded_pax_file>
- Run
setup.sh
to validate system prerequisites and setup environment variables:$ cd <nodejs_dir> $ ./setup.sh
- In order for Node.js to operate correctly, specific environment variables
must be set. Run the generated
.env
script that is generated bysetup.sh
to set the required environment variables in the current shell using the dot command (.):
This command also adds <nodejs_dir>/bin to your PATH, where the$ . <nodejs_dir>/.env
node
binary is located. - Run the
node
andnpm
commands from the command line.
Uninstalling
To uninstall Open Enterprise SDK for Node.js, delete the installation directory.