26.3.0

This migration requires deployment of the 26.3.0 Codebeamer and Windchill extensions. No Codebeamer or Windchill configuration changes are required when upgrading from release/26.2.1.

---

Prerequisites #

Before starting the migration, confirm the following:

1. You have administrator access to each Codebeamer and Windchill environment that is connected to the tenant.
2. You have file-system and restart access for the Codebeamer and Windchill servers.
3. You have tenant administrator access at https://app.iqnect.ai.
4. You have the 26.3.0 extension artifacts for each connected system.
5. You have a maintenance window, because Codebeamer and Windchill must be restarted.

---

Breaking changes in 26.3.0 #

Quality Dashboards are replaced by IQNECT Projects #

The legacy Quality Dashboards are no longer available in IQNECT 26.3.0, having been replaced by IQNECT Projects that expose project-oriented quality review across multiple systems. It includes project membership management, project search, scheduled updates, resource-shape details, and health, quality, rating, and suspicion calculations.

---

Migration order #

Perform the migration in the following order for each connected environment:

1. Deploy the 26.3.0 Codebeamer extension to each Codebeamer environment and restart Codebeamer.
2. Deploy the 26.3.0 Windchill extension to each Windchill environment, then restart Windchill.
3. Update the tenant version to v26.3.0 (or v26.3 for a non-patch release).
4. Validate the widget, indexing, and trace views in every connected system.

---

Codebeamer server changes #

1. Download the IQNECT Codebeamer extension from https://app.iqnect.ai/cb_extension/codebeamer-extension-26.3.0.zip.
2. Unzip the file and select the JAR that matches the installed Codebeamer and Java versions. The file is named iqnect-cb-extension-26.3.0-cb<CB_VERSION>-jdk<JDK_VERSION>.jar.
3. On the Codebeamer server, open <INSTALL_DIR>/tomcat/webapps/cb/WEB-INF/lib, where INSTALL_DIR is the Codebeamer installation directory.
4. Replace the existing IQNECT Codebeamer extension JAR with the selected 26.3.0 JAR.
5. Restart Codebeamer.

Codebeamer configuration changes #

No changes are required to the existing iqnox.iqnect application configuration. Retain the configuration from release/26.2.1, including the IQNECT URLs, OAuth settings, queue settings, client credentials, and tunnel settings.

---

Windchill server changes #

1. Download the IQNECT Windchill extension from https://app.iqnect.ai/wc_extension/iqnect-windchill-extension-26.3.0.zip.
2. Unzip the artifact into the Windchill customization root, for example C:\PTC\customization.
3. Open a Windchill shell and go to <WT_HOME>/bin/customizationTools/.
4. In customizationTools.properties, set wt.customizationSource.dir.path to the folder where the artifact was unzipped.
5. Deploy the package and load the IQNECT preference definitions:ant deploy ant load.data
6. Restart Windchill:ant wnc.restart

Windchill configuration changes #

No changes are required to the existing IQNECT preferences under Site Utilities > Preference Management > IQNECT. Retain the preference values from release/26.2.1, including credentials, URLs, queue settings, and any tunnel settings.

---

IQNECT tenant changes #

Tenant version update #

1. Log in to https://app.iqnect.ai.
2. Open the tenant to upgrade.
3. Go to the Details view and inspect the IQNECT Version field.
4. Click Edit.
5. Select v26.3.0 and click Save.

---

Validation checklist #

Use the following checks after the migration:

1. Confirm that Codebeamer and Windchill are running after the restart.
2. In each connected system, confirm that the IQNECT button is visible and functional.
3. In Codebeamer, confirm that new and updated non-review items are received by IQNECT for indexing.
4. Confirm that review-project items are not shown as incoming traces in Codebeamer trace views.
5. In Windchill, confirm that the IQNECT controls load and that a workflow-governed trace operation redirects correctly.
6. Confirm that users can sign in through the tenant’s SSO configuration and open IQNECT from a deep link.
7. Confirm that the tenant shows IQNECT version 26.3.0.
8. Confirm that legacy Quality Dashboard links and documented workflows have been retired or updated.

---

Rollback / failure signals #

Stop and investigate before proceeding if any of the following occurs:

1. The IQNECT button is missing after a Codebeamer or Windchill restart.
2. Codebeamer cannot obtain an IQNECT token or load the widget bootstrap script.
3. New or updated Codebeamer items are not indexed.
4. Windchill deployment, preference loading, or restart fails.
5. Windchill IQNECT controls do not load after deployment.
6. The tenant cannot be set to version v26.3.0.

If rollback is required, restore the previous Codebeamer JAR and Windchill customization package, restart the affected server, and return the tenant to its previous IQNECT version.