Updating the App Manager

This topic describes how to update the version of the Replicated app manager running in your cluster. For information about the latest versions of the app manager, see App Manager Release Notes.

note

Downgrading the app manager to a version earlier than what is currently deployed is not supported.

Update the App Manager in Existing Clusters

Updating the version of the app manager in an existing cluster requires that you first update the kots CLI. You have the option to update to the latest version of the kots CLI or to a specific version.

You then run the kots CLI admin-console upgrade command to update the app manager to the same version as the version of the kots CLI that you use to perform the update. For example, if you use version 1.56.0 of the kots CLI to run the admin-console upgrade command, then the app manager is updated to 1.56.0.

Online Environments

To update the app manager in an online existing cluster:

1. (Optional) Run the kubectl kots version command to see the current version of the kots CLI.

2. Do one of the following actions to update your kots CLI version:

   • For the latest version, run curl https://kots.io/install | bash.

   • For a specific version, run curl https://kots.io/install/VERSION | bash, where VERSION is the desired app manager version.

3. Run the following command to update the app manager to the same version as the kots CLI:

   kubectl kots admin-console upgrade -n NAMESPACE

   Replace NAMESPACE with the namespace in your cluster where the app manager is installed.

   note

   For help information, run kubectl kots admin-console upgrade -h.

Air Gap Environments

For air gap installations, you first download the air gap bundle for the desired version of the app manager and push the images from the air gap bundle to a private image registry.

To update the app manager in an existing air gap cluster:

1. Download the desired version of the app manager air gap bundle from Github or from the customer download page provided by your vendor. The air gap bundle is named kotsadm.tar.gz.

2. Update your kots CLI version to the same version as the air gap bundle:

   curl https://kots.io/install/VERSION | bash

   Replace VERSION with the same version of the app manager that is in the air gap bundle that you downloaded.

3. Push the app manager images from the air gap bundle to a private registry:

   kubectl kots admin-console push-images ./kotsadm.tar.gz PRIVATE_REGISTRY_HOST \
     --registry-username RW_USERNAME \
     --registry-password RW_PASSWORD

   Replace:

   • PRIVATE_REGISTRY_HOST with the hostname for the private registry. For example, private.registry.host/app-name.
   • RW_USERNAME with the username for credentials with read and write permissions to the registry.
   • RW_PASSWORD with the password associated with the username.

4. Run the following command using registry read-only credentials to update the app manager:

   kubectl kots admin-console upgrade \
     --kotsadm-registry PRIVATE_REGISTRY_HOST \
     --registry-username RO_USERNAME \
     --registry-password RO_PASSWORD \
     -n NAMESPACE

   Replace:

   • PRIVATE_REGISTRY_HOST with the same private registry from the previous step. For example, private.registry.host/app-name.
   • RO_USERNAME with the username for credentials with read-only permissions to the registry.
   • RO_PASSWORD with the password associated with the username.
   • NAMESPACE with the namespace on your cluster where the app manager is installed.

Update the App Manager in Kubernetes Installer Clusters

To update the version of the app manager running in clusters created by the Kubernetes installer, you re-run the installation script. The installation script uses the specification provided by the application vendor to determine if any updates are required to the version of Kubernetes running in the cluster, or to any of the add-ons that the vendor included.

The version of the KOTS add-on provided in the Kubernetes installer specification determines the version of the app manager installed in your cluster. For example, if the version of the app manager running in your cluster is 1.92.0, and the vendor updates the KOTS add-on in the Kubernetes installer specification to use 1.92.1, then you can run the installation script to update the app manager version in your cluster to 1.92.1.

For information about how to re-run the installation script to update the app manager in Kubernetes installer clusters, see Updating Kubernetes Installer Clusters.