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.
Identifying the failed upgrade step in the Engineering Lifecycle Management application pod and resolving the error manually Engineering Lifecycle Management application pod and resolving the error manually to resume the upgrade process are provided.Application diagnostics failed during the Engineering Lifecycle Management upgrade process Engineering Lifecycle Management instance, the upgrade process might fail with the following error. The Applications Events table shows that the error Application diagnostics has failed with the reason code AppDiagnosticsErr. Review the following troubleshooting information to resolve the error.Failed the application diagnostics during the Engineering Lifecycle Management instance upgrade with SAML or OIDC as an authentication provider Engineering Lifecycle Management instance is configured to use SAML or OIDC as an authentication provider, it enables the Engineering Lifecycle Management application passwords by default. During the upgrade process, the application diagnostics is run after the applications are upgraded and post-upgrade validation steps are complete. The repotools uses administrator credentials to run the application diagnostics command. It fails to run as repotools require Engineering Lifecycle Management application credentials for the authentication. The Applications Events table shows the message Application diagnostics has failed with the reason code AppDiagnosticsErr. To troubleshoot this failure scenario, review the following troubleshooting information.Failed the application diagnostics during the Engineering Lifecycle Management instance upgrade with a reverse proxy in the deployment topology Engineering Lifecycle Management instance by using the reverse proxy in the deployment topology, the upgrade might fail with the following error. The Applications Events table shows the message Application diagnostics has failed with the reason code AppDiagnosticsErr. Review the following troubleshooting information to resolve the error.Repotools verification failed during the Engineering Lifecycle Management instance upgrade Engineering Lifecycle Management application fails with the message Repotools verification has failed and reason code AppVerifyErr.Failed to merge the configuration during the Engineering Lifecycle Management instance upgrade Engineering Lifecycle Management instance, the upgrade process might fail with the following error. The Applications Events table shows that the error Failed to merge the configuration files with the reason code ConfigErr. Review the following troubleshooting information to resolve the error.Failed to merge the Jazz Reporting Service configuration during the Engineering Lifecycle Management instance upgrade Engineering Lifecycle Management instance, the upgrade process for the Jazz® Reporting Service application might fail with the following error. The Applications Events table shows that the error Failed to merge the configuration files with the reason code ConfigErr for the Jazz Reporting Service application. Review the following troubleshooting information to resolve the error.Failed to add the database tables during the Engineering Lifecycle Management instance upgrade Engineering Lifecycle Management instance, the upgrade process for the Engineering Lifecycle Management application might fail with the following error. The Applications Events table shows that the error Failed to add database tables with the reason code AddTableErr for the Engineering Lifecycle Management application. Review the following troubleshooting information to resolve the error.Failed to upgrade the data warehouse during the Engineering Lifecycle Management instance upgrade Engineering Lifecycle Management instance, the upgrade process for the Engineering Lifecycle Management application might fail with the following error. The Applications Events table shows that the error Failed to upgrade the data warehouse with the reason code DWUpgradeErr for the Engineering Lifecycle Management application. Review the following troubleshooting information to resolve the error.Failed to reindex the database tables in DOORS application during the Engineering Lifecycle Management instance upgrade Engineering Lifecycle Management instance, the upgrade process for the DOORS® application might fail with the following error. The Applications Events table shows that the error Failed to reindex the database tables with the reason code ReindexErr for the DOORS application. Review the following troubleshooting information to resolve the error.Incorrect image value applied in the test fix Applications Events table after applying a test fix to the Engineering Lifecycle Management application.Patches are not restored after the Engineering Lifecycle Management instance rollback Engineering Lifecycle Management applications are backed up during the Engineering Lifecycle Management instance upgrade process. When you roll back, these patches are automatically restored to the previous Engineering Lifecycle Management version. Review the following troubleshooting information if the patches are not restored after you roll back to the previous Engineering Lifecycle Management version.Application diagnostics failed during the Engineering Lifecycle Management rollback process Engineering Lifecycle Management instance by using the reverse proxy in the deployment topology, the rollback might fail with the following error. The Applications Events page shows App diagnostics error. The Applications Events table shows the error Application diagnostics has failed with the reason code AppDiagnosticsErr. Review the following troubleshooting information to resolve the error.Repotools verification failed during the Engineering Lifecycle Management instance rollback Engineering Lifecycle Management application fails with the message Repotools verification has failed and reason code AppVerifyErr.Cannot roll back as the configuration backup file for the Engineering Lifecycle Management version is not available Cannot roll back to version <elm-build-id> version as no configuration backup is identified with reason code AppRollbackValidationErr during the Engineering Lifecycle Management rollback process.