Cloudera Docs

Upgrading Cloudera Data Visualization in Cloudera Machine Learning/Cloudera Data Science Workbench

Cloudera recommends following the Cloudera Data Visualization release cadence by upgrading to the latest version as it becomes available. This practice ensures that your Cloudera Data Visualization instances benefit from the latest new features, security enhancements, and bug fixes.

This guide outlines the available options performing an upgrade and the steps of the upgrade process. If you need to downgrade, follow the Restoring Cloudera Data Visualization in Cloudera Machine Learning/Cloudera Data Science Workbench procedure using the backup you created earlier.

  • Before initiating the upgrade, review the Known issues and limitations in Cloudera Data Visualization in the Release Notes for both the currently running version and the version to which you plan to upgrade to. This helps you identify potential challenges, limitations, or specific actions required for a successful upgrade.

  • If you are using an external database like MySQL, MariaDB, Postgres, or Oracle, ensure you back up the database and restore it as a new database that the new Cloudera Data Visualization instance can connect to.

  1. Stop the application.
    On the Applications page in Cloudera Machine Learning/CDSW, click Actions > Stop to stop the selected Cloudera Data Visualization application.
  2. Back up the SQLite metadata database.
    1. Navigate to your project's Overview page and click New Session.
    2. When your session is running, click >_ Terminal Access above the session log pane to open a terminal window.
      The default working directory is /home/cdsw, where all your project files reside.
    3. Navigate to /home/cdsw/.arc.
      This directory contains the Cloudera Data Visualization logs, files, settings, and the arcviz.db database.
    4. Run the following command to create a copy of your current Cloudera Data Visualization metadata.
      sqlite3 arcviz.db “.backup arcviz.db-BACKUP-[***version***]”

      You can use this backup in case you need to revert to a previous Cloudera Data Visualization version.

  3. Navigate to the Application Settings page.
  4. Locate the runtime configuration option, where you can select the desired runtime for your application.
  5. Select the runtime you want to set for your application from the available options.
  6. Click Update Application to save the change.
    The application will restart automatically with the newly selected runtime.