Troubleshooting and support on Engineering Lifecycle Management on Hybrid Cloud
To help you troubleshoot the issues, you can gather Engineering Lifecycle Management
serviceability information from the Red Hat® OpenShift® Container Platform by using Engineering Lifecycle Management must-gather tool.
Troubleshooting of error messages
When the defined process steps are failed to run, error messages are displayed in Engineering Lifecycle Management on Hybrid Cloud . Each error message is associated with a reason code. The following table lists the error message, the explanation of the error message, and the troubleshooting information.
Accessing application pod logs
To access the application pod logs, complete the following steps.
Accessing application pod terminal
To access the application pod terminal, complete the following steps.
Generating java heap memory dumps and java cores
To generate java cores, thread memory dumps, heap memory dumps, and system core files that are used to troubleshoot problems such as hangs, memory issues, and performance on the WebSphere® Application Server Liberty profile.
Troubleshooting of installation errors
Troubleshooting of upgrade errors
The troubleshooting information of the errors that are related to the Engineering Lifecycle Management instance upgrade, Engineering Lifecycle Management instance rollback, interim fix update, test fix update, and patch update in Engineering Lifecycle Management on Hybrid Cloud is provided in the following pages.
Troubleshooting of Jazz Authorization Server authentication errors
Troubleshooting of deployment size update errors
The troubleshooting information for the failure scenarios that are related to the Engineering Lifecycle Management instance deployment size update are provided in the following sections.
Troubleshooting of Nginx ingress controller to ignore custom headers
Engineering Lifecycle Management applications like IBM® Engineering Requirements Management DOORS® Next use custom headers in the query requests. In vanilla Kubernetes, cluster is deployed with Nginx as Ingress Controller. Thus, you can face errors when you open an artifact. The following troubleshooting information helps in customizing the Nginx Controller to solve the errors.
Running and gathering the Engineering Lifecycle Management MustGather serviceability information
The cluster administrator can run Engineering Lifecycle Management MustGather tool in the cluster. The collected serviceability information helps Jazz® administrator to work with IBM support for the serviceability of Engineering Lifecycle Management