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.

2. 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.

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

• Create an issue in the Zowe GitHub repository with a detailed description of the problem you have encountered.

• Bring up your questions to the corresponding channels as shown below:

  • Zowe CLI Slack channel
  • Zowe API ML Slack channel
  • Zowe Chat Slack channel
  • Zowe Documentation Slack channel

• Reach out to your available Zowe support team for assistance.

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 Launcher
• Troubleshooting Zowe z/OS component startup
• Troubleshooting API Mediation Layer
• Troubleshooting Zowe Application Framework

Troubleshooting Zowe client-side components

• Troubleshooting Zowe CLI
• Troubleshooting Zowe Explorer
• Troubleshooting Zowe Chat
• Troubleshooting Zowe IntelliJ plug-in

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.