Issue with docs.zowe.org/stable/user-guide/cli-installcli/

[colinpaicemq]

Description

The install doc says
npm install -g zowe-cli.tgz

it needs to say

sudo npm install -g zowe-cli.tgz

Pages to Update

Screenshots

npm error code EACCES
npm error syscall mkdir
npm error path /usr/lib/node_modules/@zowe
npm error errno -13
npm error Error: EACCES: permission denied, mkdir '/usr/lib/node_modules/@zowe'
npm error at async mkdir (node:internal/fs/promises:858:10)
npm error at async /usr/lib/node_modules/npm/node_modules/@npmcli/arborist/lib/arborist/reify.js:624:20
npm error at async Promise.allSettled (index 0)
npm error at async [reifyPackages] (/usr/lib/node_modules/npm/node_modules/@npmcli/arborist/lib/arborist/reify.js:325:11)
npm error at async Arborist.reify (/usr/lib/node_modules/npm/node_modules/@npmcli/arborist/lib/arborist/reify.js:142:5)
npm error at async Install.exec (/usr/lib/node_modules/npm/lib/commands/install.js:150:5)
npm error at async Npm.exec (/usr/lib/node_modules/npm/lib/npm.js:207:9)
npm error at async module.exports (/usr/lib/node_modules/npm/lib/cli/entry.js:74:5) {
npm error errno: -13,
npm error code: 'EACCES',
npm error syscall: 'mkdir',
npm error path: '/usr/lib/node_modules/@zowe'
npm error }
npm error
npm error The operation was rejected by your operating system.
npm error It is likely you do not have the permissions to access this file as the current user
npm error
npm error If you believe this might be a permissions issue, please double-check the
npm error permissions of the file and its containing directories, or try running
npm error the command again as root/Administrator.
npm notice
npm notice New major version of npm available! 10.9.2 -> 11.0.0
npm notice Changelog: https://github.com/npm/cli/releases/tag/v11.0.0
npm notice To update run: npm install -g [email protected]
npm notice
npm error A complete log of this run can be found in: /home/colinpaice/.npm/_logs/2025-01-05T17_50_28_318Z-debug-0.log

Expected behavior

Additional context

[t1m0thyj]

There are some workarounds discussed in this issue: zowe/zowe-cli#666 (comment)

We should probably add a section to our Troubleshooting page for Zowe CLI that covers this 😋

[adam-wolfe]

Also, there is a note on use of sudo for npm global install commands on https://docs.zowe.org/stable/user-guide/cli-installcli/: