Upgrading

If a new version of OSLC Connect for Jira has been released and you are about to install it, these are the things you need to know/do:

• It is not necessary to uninstall first the previous version of the connector, you just need to install the new version as if it was the first time and no extra configuration is required on Jira.
• If Jira project administrators are using IBM Collaborative Lifecycle Management global configurations, the recommended upgrading process is:
  1. Ask to the IBM Link Index Provider (LDX) administrator to suspend the indexing of the datasource to OSLC Connect for Jira TRS feed. ^[1]
  2. Upgrade OSLC Connect for Jira.
  3. Ask to the IBM Link Index Provider (LDX) administrator to resume the indexing of the previously paused datasource.
• If Jira project administrators are using IBM Jazz Reporting Service and/or IBM Rational Engineering Lifecycle Manager (RELM), steps 1 and 3 of above procedure must also consider IBM Lifecycle Query Engine (LQE) administrator for correspoding datasources to OSLC Connect for Jira TRS feeds. ^[1]
• If recommended process is not possible due to LDX/LQE administrators not being available, or for any other reason, the alternative path is:
  1. Upgrade OSLC Connect for Jira.
  2. Ask to the IBM Link Index Provider (LDX)/IBM Lifecycle Query Engine (LQE) administrators to re-index the involved datasources as soon as possible ^[2].

^[1] On Suspending and resuming an LDX/LQE datasource topic, LDX/LQE administrators can find a guide to do it. ^[2] On Reindexing an LDX/LQE datasource topic, LDX/LQE administrators can find a guide to do it.