Skip to main content

Upgrade Astra Control Center using OpenShift OperatorHub

Contributors netapp-dbagwell
PDFs

If you installed Astra Control Center using its Red Hat-certified operator, you can upgrade Astra Control Center using an updated operator from OperatorHub. Use this procedure to upgrade Astra Control Center from the Red Hat Ecosystem Catalog or using the Red Hat OpenShift Container Platform.

Before you begin

  • Meet environmental prerequisites: Before you upgrade, ensure your environment still meets the minimum requirements for Astra Control Center deployment.

  • Ensure that you have enabled Astra Control Provisioner with Astra Trident running

    1. Determine the Astra Trident version you are running:

      kubectl get tridentversion -n trident
      Note If you are running Astra Trident 23.01 or earlier, use these instructions to upgrade to a more recent version of Astra Trident before upgrading to the Astra Control Provisioner. You can perform a direct upgrade to Astra Control Provisioner 24.02 if your Astra Trident is within a four-release window of version 24.02. For example, you can directly upgrade from Astra Trident 23.04 to Astra Control Provisioner 24.02.

    2. Verify that Astra Control Provisioner has been enabled. Astra Control Provisioner will not work with releases of Astra Control Center earlier than 23.10. Upgrade your Astra Control Provisioner so that it has the same version as the Astra Control Center you are upgrading to access the latest functionality.

  • Ensure healthy cluster operators and API services:

    • From your OpenShift cluster, ensure all cluster operators are in a healthy state:

      oc get clusteroperators

    • From your OpenShift cluster, ensure all API services are in a healthy state:

      oc get apiservices

  • OpenShift permissions: You have all necessary permissions and access to the Red Hat OpenShift Container Platform to perform the upgrade steps described.

  • (ONTAP SAN driver only) Enable multipath: If you are using an ONTAP SAN driver, be sure that multipath is enabled on all your Kubernetes clusters.

You should also consider the following:

  • Get access to the NetApp Astra Control image registry:

    You have the option to obtain installation images and functionality enhancements for Astra Control, such as Astra Control Provisioner, from the NetApp image registry.

    1. Record your Astra Control account ID that you'll need to log in to the registry.

      You can see your account ID in the Astra Control Service web UI. Select the figure icon at the top right of the page, select API access, and write down your account ID.

    2. From the same page, select Generate API token and copy the API token string to the clipboard and save it in your editor.

    3. Log into the Astra Control registry:

      docker login cr.astra.netapp.io -u <account-id> -p <api-token>
Steps

Access the operator install page

  1. Complete the corresponding procedure for either Openshift Container Platform or Ecosystem Catalog:

    Red Hat OpenShift web console

    1. Log in to the OpenShift Container Platform UI.

    2. From the side menu, select Operators > OperatorHub.

      Note You can upgrade only to the current version of Astra Control Center using this operator.

    3. Search for netapp-acc and select the NetApp Astra Control Center operator.

      This image shows the uninstall option from the operator page

    Red Hat Ecosystem Catalog

    1. Select the NetApp Astra Control Center operator.

    2. Select Deploy and use.

      This image shows the Astra Control Center overview page that is available from the RedHat Ecosystem Catalog

Uninstall the existing operator

  1. From the netapp-acc-operator page, select Uninstall to remove your existing operator.

    This image shows the uninstall option from the operator page

  2. Confirm the operation.

    Note This operation deletes the netapp-acc-operator but preserves the original associated namespace and resources, such as secrets.

Install the latest operator

  1. Navigate to the netapp-acc operator page again.

  2. Complete the Install Operator page and install the most recent operator:

    This image shows the uninstall option from the operator page

    Note The operator will be available in all cluster namespaces.

    1. Select the operator's netapp-acc-operator namespace (or custom namespace) that remains from the deleted operator's previous installation.

    2. Select a manual or automatic approval strategy.

      Note Manual approval is recommended. You should only have a single operator instance running per cluster.

    3. Select Install.

      Note If you selected a manual approval strategy, you'll be prompted to approve the manual install plan for this operator.

  3. From the console, go to the OperatorHub menu and confirm that the operator installed successfully.

Upgrade Astra Control Center

  1. From the Astra Control Center operator tab, select the Astra Control Center that remains from the previous installation and select Edit AstraControlCenter.
    This image shows the edit option for the original Astra Control Center

  2. Update the AstraControlCenter YAML:

    1. Enter the latest Astra Control Center version; for example, 24.02.0-69.

    2. In imageRegistry.name, update the image registry path as needed:

      • If you are using the Astra Control registry option, change the path to cr.astra.netapp.io.

      • If you configured a local registry, change or retain the local image registry path where you pushed the images in a previous step.

        Note Do not enter http:// or https:// in the address field.

    3. Update the imageRegistry.secret as needed.

      Note The operator uninstall process does not remove existing secrets. You only need to update this field if you create a new secret with a different name from the existing secret.

    4. Add the following to your crds configuration:

      crds:
  shouldUpgrade: true

  3. Save your changes.

  4. The UI confirms that the upgrade was successful.