Troubleshooting Zowe CLI
The following topics contain information that can help you troubleshoot problems when you encounter unexpected behavior installing and using Zowe CLI.
Command not found message displays when issuing
npm install commands
Valid on all supported platforms
When you issue NPM commands to install the CLI, the message command not found displays. The message indicates that Node.js and NPM are not installed on your computer, or that PATH does not contain the correct path to the NodeJS folder.
To correct this behavior, verify the following:
- Node.js and NPM are installed.
- PATH contains the correct path to the NodeJS folder.
More Information: System requirements for Zowe CLI
npm install -gCommand Fails Due to an EPERM Error
Valid on Windows
This behavior is due to a problem with Node Package Manager (npm). There is an open issue on the npm GitHub repository to fix the defect.
If you encounter this problem, some users report that repeatedly attempting to install Zowe CLI yields success. Some users also report success using the following workarounds:
npm cache cleancommand.
Uninstall and reinstall Zowe CLI. For more information, see Install Zowe CLI.
Add the --no-optionalflag to the end of the
Sudo syntax required to complete some installations
Valid on Linux and macOS
The installation fails on Linux or macOS.
Depending on how you configured Node.js on Linux or macOS, you might need to add the prefix
sudo before the
npm install -g command or the
npm uninstall -g command. This step gives Node.js write access to the installation directory.
npm install -g command fails due to
npm ERR! Cannot read property 'pause' of undefined error
Valid on Windows or Linux
You receive the error message
npm ERR! Cannot read property 'pause' of undefined when you attempt to install the product.
This behavior is due to a problem with Node Package Manager (npm). If you encounter this problem, revert to a previous version of npm that does not contain this defect. To revert to a previous version of npm, issue the following command:
npm install email@example.com -g
Node.js commands do not respond as expected
Valid on Windows or Linux
You attempt to issue node.js commands and you do not receive the expected output.
There might be a program that is named node on your path. The Node.js installer automatically adds a program that is named node to your path. When there are pre-existing programs that are named node on your computer, the program that appears first in the path is used. To correct this behavior, change the order of the programs in the path so that Node.js appears first.
Installation fails on Oracle Linux 6
Valid on Oracle Linux 6
You receive error messages when you attempt to install the product on an Oracle Linux 6 operating system.
Install the product on Oracle Linux 7 or another Linux or Windows OS. Zowe CLI is not compatible with Oracle Linux 6.