Upgrading Dash Enterprise

Your organization is responsible for performing Dash Enterprise upgrades. We’ll notify you when a new version is available.

To ensure you remain eligible for support, upgrade Dash Enterprise regularly. We recommend keeping your instance as close to the latest version as possible for best results.

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.

Contact us for upgrade help.

Checking the Current Version

helm ls --all-namespaces

Next to the namespace for the Dash Enterprise instance whose version you want to check, look at the CHART or APP VERSION.

Before Upgrading

Before upgrading Dash Enterprise, we strongly recommend carefully reading the changelog for the version that you want to upgrade to, as well as any intermediate versions.

Running the Upgrade

6.1.0 to 6.1.2

Prerequisites

• kubectl access to the cluster
• Helm v3.14 or later
• If performing the upgrade from an internet-restricted machine, then you have obtained the bundle of Dash Enterprise images for the version that you are upgrading to and you have pushed it to your private container registry.
• Make sure that the following variables are defined in your environment (note that the CHART_VERSION differs from what you set during your installation):
  txt export CHART_VERSION=6.1.2 export RELEASE_CHANNEL=standard export CHART_REGISTRY=oci://registry.replicated.com/dash-enterprise export RELEASE_NAME=dash-enterprise export NAMESPACE=<your-namespace>
  If installing from an image bundle that is already pushed to your private container registry, then you also need export SKIP_PUSH=1.

To upgrade Dash Enterprise from 6.1.0 to 6.1.2:
sh helm upgrade $RELEASE_NAME \ $CHART_REGISTRY/$RELEASE_CHANNEL/dash-enterprise \ --version "$CHART_VERSION" \ --namespace $NAMESPACE \ --reset-then-reuse-values
(the --reset-then-reuse-values flag applies all configuration settings that you applied during the original installation and that are not modified in this command).

6.0.X to 6.1.0

Prerequisites

• kubectl access to the cluster
• Helm v3.14 or later
• If performing the upgrade from an internet-restricted machine, then you have obtained the bundle of Dash Enterprise images for the version that you are upgrading to and you have pushed it to your private container registry.
• Make sure that the following variables are defined in your environment (note that the CHART_VERSION differs from what you set during your installation):
  txt export CHART_VERSION=6.1.0 export RELEASE_CHANNEL=standard export CHART_REGISTRY=oci://registry.replicated.com/dash-enterprise export RELEASE_NAME=dash-enterprise export NAMESPACE=<your-namespace>
  If installing from an image bundle that is already pushed to your private container registry, then you also need export SKIP_PUSH=1.

Configuration notices

• auth.keycloak.internalCaSecretName is deprecated in Dash Enterprise 6.1.0. See more information in the changelog.

To upgrade Dash Enterprise from 6.0.X to 6.1.0:

1. If you are affected by the auth.keycloak.internalCaSecretName deprecation, create a ConfigMap for your self-signed or internal CA certificate:
   sh CA_CONFIGMAP_NAME=keycloak-ca-cert kubectl create configmap $CA_CONFIGMAP_NAME \ --namespace=$NAMESPACE \ --from-file="$KEYCLOAK_CA_CERT" \ --dry-run=client -o yaml | kubectl apply -f -

2. Run one of the following commands:
   * If you are not affected by the auth.keycloak.internalCaSecretName deprecation:
   sh helm upgrade $RELEASE_NAME \ $CHART_REGISTRY/$RELEASE_CHANNEL/dash-enterprise \ --version "$CHART_VERSION" \ --namespace $NAMESPACE \ --reset-then-reuse-values
   (the --reset-then-reuse-values flag applies all configuration settings that you applied during the original installation and that are not modified in this command).

• If you are affected by the auth.keycloak.internalCaSecretName deprecation:
  sh helm upgrade $RELEASE_NAME \ $CHART_REGISTRY/$RELEASE_CHANNEL/dash-enterprise \ --version "$CHART_VERSION" \ --namespace $NAMESPACE \ --set auth.keycloak.internalCaCertConfigMapName=keycloak-ca-secret \ --reset-then-reuse-values
  (the --reset-then-reuse-values flag applies all configuration settings that you applied during the original installation and that are not modified in this command).