Troubleshooting

This section contains information on common problems and solutions related to installing and configuring IBM Z Service Management Explorer.

Issue with plug-ins

The information below describes what to do when a plug-in cannot be found.

Issue with nodeServer.sh

The information below describes an issue with the nodeServer.sh shell.

Node: not found: You may receive this message while running ./nodeServer.sh.
Solution: Add NODE_HOME to your .profile or in your environment.

Issues with Zowe Login

The topics below describe issues that may occur when logging into Zowe.

Authentication failed for 1 types. Types: ['zss"]

Possible causes include the following:

Wrong username/password
zssServer is not running. Contact your Zowe administrator.
ZIS server is not running. Contact your Zowe administrator.
Configuration/security problems relating to zssServer and ZIS server. Contact your Zowe administrator.

Login fails with no error message, original login reappears.: This is unlikely to happen when you first point your browser at the Zowe web server, but can happen if your Zowe desktop has been up for a while and the session timed out.; It can also happen if your Zowe server is using a certificate that is not considered secure by your browser. Some browsers will periodically force you to re-approve certificates that the browser considers insecure.
Check that the Zowe web server is running and that your browser is accepting the Zowe certificate. The easiest way to do this is to "hard" reload the page (Ctrl-Shift-R), so it will not use the browser cache. If the page fails to reload, that means your web server is not available to your browser.

Gathering other log and output data

The JavaScript console and Zowe application server logs are useful sources of diagnostic information.

JavaScript output is accessed differently in each of the supported browsers:

For Chrome, see How to Open Google Chrome's JavaScript Console.
For Firefox, see Debugging JavaScript.
For Microsoft Edge, see Console.
For Safari, see Safari Developer Tools.

The Zowe log verbosity determines how much detail is shown in the logs. Verbose logging creates large log files and may slow down performance, but provides more information that can help you troubleshoot a problem.

For information about the Zowe logs, see Log output from the Zowe Application Server. For information on setting the log verbosity, see Logging verbosity.

“Items per page” may differ from the number of bars in Bar chart

"Items per page" reflects the number of rows returned. The number of bars displayed reflects the number of unique "formatted category axis values" were in the returned result. If the "items per page" differs from the number of bars in the chart, consider adding filtering, or using a plot chart with Attribute(s) across multiple rows.

In some cases, maximizing your IZSME view, or zooming out (Ctrl-minus), the “items per page” indicator will not appear, when all the bars fit in the chart view.