Skip to main content
Version: v2.7.x LTS

Troubleshooting overview

Troubleshooting overview

To isolate and resolve Zoweâ„¢ problems, you can use the troubleshooting and support information.

How to start troubleshooting​

When you run into some issues and are looking for troubleshooting tips, the following steps may help you.

  1. Search the error message or error code in your error log by using the Search bar in the Zowe Docs site. If there is an existing solution, follow the instructions to troubleshoot.

A screenshot to show how to search in github repo

  1. If no solution is available or the existing solutions cannot apply to your problem, you could search the keywords, error messages, or error code in the Zowe GitHub repository. If you find a closed issue or pull request, try troubleshooting by using the information shared in the item's Conversation section. If the issue is still open, post your question or comment to prompt a discussion on your problem.

A gif to show how to search in github repo

  1. If your problem is not solved, try the following options:

Known problems and solutions​

Some common problems with Zowe are documented, along with their solutions or workarounds. If you have a problem with Zowe installation and components, review the problem-solution topics to determine whether a solution is available to the problem that you are experiencing.

You can also find error messages and codes, must-gathers, and information about how to get community support in these topics.

Troubleshooting Zowe server-side components​

Troubleshooting Zowe client-side components​

Verifying a Zowe release's integrity​

Following a successful install of a Zowe release, the Zowe runtime directory should contain the code needed to launch and run Zowe. If the contents of the Zowe runtime directory have been modified then this may result in unpredictable behavior. To assist with this Zowe provides the ability to validate the integrity of a Zowe runtime directory, see Verify Zowe runtime directory

Understanding the Zowe release​

Knowing which version of Zowe you are running might help you isolate the problem. Also, the Zowe community who helps you will need to know this information. For more information, see Understanding the Zowe release.