Upgrading Dash Enterprise

This page can help you prepare for upgrading Dash Enterprise 5 to a newer version. View information about upgrading Dash Enterprise 4 here.

Plotly uses Replicated to deliver new Dash Enterprise versions. We will notify you when a new version is available. Your organization is responsible for performing the upgrade to a new version. You can manage Dash Enterprise upgrades in the KOTS Admin Console, part of the Replicated toolset.

Important: While the KOTS Admin Console has settings to configure automatic upgrades, always wait for us to contact you before upgrading Dash Enterprise. Automatic upgrades are not officially supported.

You can directly upgrade to a version of Dash Enterprise that is more than one release ahead of your current version unless the intermediate versions contain a minor version.
To upgrade Dash Enterprise by more than one minor version, you need to perform the upgrades one at a time.

Continue to Before Upgrading to learn how to prepare for your upgrade.

Before Upgrading

Before upgrading Dash Enterprise, we strongly recommend:

• Carefully reading the changelog for the version you want to upgrade to, as well as all intermediate versions. In addition to listing the Dash Enterprise changes that you can expect, the changelog contains important compatibility information and notices related to the upgrade, such as:
• Whether apps and workspaces will be restarted upon upgrading. Unless otherwise stated, apps and workspaces are not restarted.
• Version support changes for Kubernetes (needs to be upgraded separately). Upgrading Kubernetes always causes apps and workspaces to restart.

• Version support changes for dependencies (need to be upgraded separately).

• Planning for system downtime if any of the following apply:

• You are upgrading a Dash Enterprise instance that is installed on a single server.

• You are upgrading the Kubernetes version (plan up to a few hours). During a Kubernetes upgrade, it is expected to see 503 errors when trying to access the App Manager and 404 errors when trying to visit apps.

• Making sure you are not nearing the system limits for pods and PVCs.
  To verify, go to any page in the App Manager, such as https://<your-dash-enterprise-server>/apps. If you see a warning banner
  at the top of the page that says “Nearing system limits,” address your high pod or PVC counts before upgrading.

• Applying license changes, if any.

• Creating a backup of your Dash Enterprise instance. You can restore from this backup if an issue occurs during or after an upgrade.

Checking Your Current Dash Enterprise Version

To check your current version of Dash Enterprise, log in to the KOTS Admin Console at https://admin-<your-dash-enterprise-server>.

The dashboard displays the version that you are currently using.

<img>

This version number corresponds to the version number displayed at the bottom of each page in the Dash Enterprise App Manager.

Performing an Upgrade

Exact upgrade steps depend on your environment. Contact us to upgrade Dash Enterprise.