TSB 2025-907: Upgrade notice for Cloudera Data Visualization 7.2.6
Learn more about the details communicated in TSB-907.
- Summary
-
A critical issue has been identified that causes a database schema mismatch when upgrading Cloudera Data Visualization directly from version 7.2.6 to any version between 7.2.9 and 8.0.6. This is due to a database migration in version 7.2.9 that requires a prerequisite schema change introduced in version 7.2.8.
Immediate action is required to prevent this issue. All customers planning an upgrade from version 7.2.6 must first upgrade to version 7.2.8 before proceeding to any version between 7.2.9 and 8.0.6. Attempting a direct upgrade will result in an inconsistent database state and application failure.
This issue also impacts customers upgrading Cloudera AI Workbench to Cloudera Data Services on premises 1.5.5 (or higher). This upgrade automatically updates the backend database for all Exploratory Data Science and Visualization applications within the Data tab in the left navigation pane of the Cloudera AI Workbench projects.
- Component(s) affected
-
- Cloudera Data Services on premises
- Cloudera Data Visualization
- Cloudera AI Workbench
- Users affected
-
- All users upgrading Cloudera AI Workbench to Cloudera Data Services on premises 1.5.5
- All users upgrading Cloudera Data Visualization directly from version 7.2.6 to version 7.2.9-8.0.6
- Releases affected
-
- Cloudera Data Services on premises 1.5.5
- Cloudera Data Services on premises 1.5.5 CHF 1
- Cloudera Data Services on premises 1.5.5 SP1
- Impact
- This issue has the highest impact on Cloudera AI Workbench users upgrading to Cloudera Data Services on premises 1.5.5, because this upgrade automatically updates the backend database for all Exploratory DataScience and Visualization applications within the “Data” tab in the left navigation pane of the Cloudera AI Workbench projects.
- Action required:
- Upgrade (recommended)
Perform a staged upgrade
To ensure a successful upgrade and prevent database inconsistencies, you must perform a two-step, staged upgrade.
- Upgrade your Cloudera Data Visualization instance from version 7.2.6 to version 7.2.8.
- After verifying the success of the first step, proceed with the upgrade process and upgrade from version 7.2.8 to your final target version (for example 7.2.9 or higher).
Do not attempt a direct upgrade from 7.2.6 to 7.2.9-8.0.6.
Pin Cloudera Data Visualization Data tab version before a Cloudera AI upgrade
For Cloudera AI Workbench users upgrading to Cloudera Data Services on premises 1.5.5, the Cloudera Data Visualization
version can be pinned to 7.2.6 before the upgrade, to prevent the automatic and problematic
upgrade. To do this, set the EMBEDDED_CDV_IMAGE
environment variable on projects using the Data
tab to point to the 7.2.6 image:
docker.repository.cloudera.com/cloudera/cdv/runtimedataviz:7.2.6-b62
Workaround
If you have already attempted a direct upgrade from 7.2.6 to 7.2.9 or later, the Cloudera Data Visualization application's database is likely in a broken state.
- Restore the Cloudera Data Visualization database from a backup taken immediately before the failed upgrade.
- Follow the staged upgrade path detailed above.
If no backup exists, contact Cloudera Support for assistance.
- Knowledge Base article
- For the latest update on this issue see the corresponding Knowledge Base article: TSB 2025-907: Upgrade notice for Cloudera Data Visualization 7.2.6
