Troubleshooting70XTo7XUpgrades < Deployment

<div id="header-title" style="padding: 10px 15px; border-width:1px; border-style:solid; border-color:#FFD28C; background-image: url(<nop>https://jazz.net/wiki/pub/Deployment/WebPreferences/TLASE.jpg); background-size: cover; font-size:120%">
---+!! UNDER CONSTRUCTION : Troubleshooting DOORS Next 7.0.x to 7.1/7.2 Upgrades  
%DKGRAY% Authors: Main.WillChatham, Main.BharathRao <br>
%ENDCOLOR%</div></sticky>

<!-- Page contents top of page on right hand side in box -->
<sticky><div style="float:right; border-width:1px; border-style:solid; border-color:#DFDFDF; background-color:#F6F6F6; margin:0 0 15px 15px; padding: 0 15px 0 15px;">
%TOC{title="Page contents"}%
</div></sticky>

<sticky><div style="margin:15px;"></sticky>

---+ 

This article is to help troubleshoot ELM upgrades from V7.0.x to V7.1 or V7.2 and is a companion to [[https://www.ibm.com/support/pages/planning-upgrade-elm-71?view=full][Planning for upgrade to ELM 7.1]]


---++ The importance of upgrade testing:

It is imperative that you test the upgrade:

   * This is important to detect any data issues and will also provide you with accurate upgrade times.
   * Use a staging area where the hardware is comparable with your production server.
   * Testing with a copy of your production data is ideal [[https://www.ibm.com/docs/en/engineering-lifecycle-management-suite/lifecycle-management/7.1.0?topic=rename-scenario-setting-up-test-staging-environment][Setting up a test staging environment with production data]]. If that is not possible use data as comparable to production as possible.
   * Take accurate timings of the pre-upgrade tasks, upgrade tasks and post-upgrade tasks.


---++ Use latest IFixes:

IBM recommend that you upgrade using the latest iFixes available for the release you are upgrading from/to.

If this is not possible then we highly recommend that you check the list of known issues that are fixed in the later Interim fixes to see if any could affect your upgrade or affect your users using the tool post upgrade.

   * [[https://www.ibm.com/docs/en/engineering-lifecycle-management-suite/lifecycle-management/7.1.0?topic=system-interim-fixes-engineering-lifecycle-management-71][Interim fixes for Engineering Lifecycle Management 7.1]]
   * [[https://www.ibm.com/docs/en/engineering-lifecycle-management-suite/lifecycle-management/7.2.0?topic=system-interim-fixes-engineering-lifecycle-management-72][Interim fixes for Engineering Lifecycle Management 7.2]]

The list shows the Known issues by Product and Component/area affected.


---++ Critical Notes for Customers (Must Read):

---+++ Product LQE/RS

   * [[https://www.ibm.com/support/pages/key-considerations-and-known-issues-when-upgrading-elm-720-lqe-relational-store][Key considerations and known issues when upgrading to ELM 7.2.0 (LQE relational store)]]

---++ Known issues:

---+++ Product ETM

---++++ OSLC Migration Task

*Problem:* OSLC Migration Task performance is poor, it is running for days and shows no sign of completing.

*What is OSLC migration:*

OSLC migration is a background process that runs after an upgraded Engineering Test Management (ETM) server is started. The migration manages OSLC Migrators, which run a set of tasks on specific artifact types that publishes delete and create events in the Tracked Resource Set 2 (TRS2) feed for the artifacts that require them. The execution is asynchronous and does not prevent the server from working or users from performing normal activities (for example, creating or modifying test plans, test cases, etc.) while the migration is running. 

*Impact:*
Some features might not be displayed in Jazz Reporting Service until the migration is finished and LQE is up-to-date.

For example, ETM 7.0.3 / 7.1 introduced the advanced property mentioned in the below screenshot to include the archived approval groups to the REST and OSLC APIs, PDF, and JRS Reports. 

     <img src="%ATTACHURLPATH%/ETMProperty.png" alt="ETMProperty.png" width="1690" height="236" />

The property is available under ETM Administration > Advanced Property.

Post upgrade to 7.0.3/7.1, one of the OSLC Migrators would update the archived approval details in the existing artifact schema. 
If the property is enabled before the task completes, the archived approvals will be visible in the report for only those artifacts which are updated / migrated.

In summary, while the task is in progress, the existing reports are expected to work the same way as before upgrade.

*How to monitor the progress of OSLC Migration task?* <br />
Administrators can use the OSLC Migration Status page to monitor.
The status page is available at the following location: =https://elm.host.name/<qm-context>/oslcMigrationStatus <br />

     <img src="%ATTACHURLPATH%/oslcMigrationStatus.png" alt="oslcMigrationStatus.png" width="1121" height="483" />

*How to resolve:* This may be resource or database related and the time needed depends on the amount of data to be migrated post upgrade:

   * Run the Database Must Gather and prove :
      * Oracle: [[https://jazz.net/wiki/bin/view/Deployment/OracleMustGather][Must-gather information for diagnosing long-running SQL statements on Oracle]]
         * Also Provide an AWR report for review.
      * DB2: [[https://jazz.net/wiki/bin/view/Deployment/Db2MustGather][Must-gather information for diagnosing long-running SQL statements on DB2]] 
   * Contact IBM Support for assistance.

---+++++!! External links:          

   * [[https://www.ibm.com][IBM]]

---+++++!! Additional contributors: Main.TWikiUser, Main.TWikiUser

<sticky></div></sticky>
This topic: Deployment > WebHome > DeploymentInstallingUpgradingAndMigrating > Troubleshooting70XTo7XUpgrades
History: r6 - 2026-02-16 - 11:14:36 - WillChatham
Copyright © by IBM and non-IBM contributing authors. All material on this collaboration platform is the property of the contributing authors.
Contributions are governed by our Terms of Use. Please read the following disclaimer.
Dashboards and work items are no longer publicly available, so some links may be invalid. We now provide similar information through other means. Learn more here.