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.
  • Failed upgrade path: An upgrade from Cloudera Data Visualization 7.2.6 to any version of Cloudera Data Visualization between 7.2.9 and 8.0.6 skips the necessary preparatory step from 7.2.8, causing the 7.2.9 migration to fail and result in a mismatch of the database schema.
  • Safe upgrade paths: Upgrades from Cloudera Data Visualization versions 7.2.5, 7.2.7, or 7.2.8 to 7.2.9 or higher work correctly as they do not have this dependency conflict.
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.

  1. Upgrade your Cloudera Data Visualization instance from version 7.2.6 to version 7.2.8.
  2. 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.

  1. Restore the Cloudera Data Visualization database from a backup taken immediately before the failed upgrade.
  2. 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