Install Astra Control Center using OpenShift OperatorHub

Contributors netapp-dbagwell netapp-mwallis

If you use Red Hat OpenShift, you can install Astra Control Center using the Red Hat certified operator. Use this procedure to install Astra Control Center from the Red Hat Ecosystem Catalog or using the Red Hat OpenShift Container Platform.

After you complete this procedure, you must return to the installation procedure to complete the remaining steps to verify installation success and log on.

What you’ll need
  • Before you begin installation, prepare your environment for Astra Control Center deployment.

  • 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
  • Create an FQDN address for Astra Control Center in your data center.

  • Obtain the necessary permissions and access to the Red Hat OpenShift Container Platform to perform the installation steps described.

  • If a cert-manager already exists in the cluster, you need to perform some prerequisite steps so that Astra Control Center does not install its own cert-manager. By default, Astra Control Center installs its own cert-manager during installation.

Download and unpack the Astra Control Center bundle

  1. Download the Astra Control Center bundle (astra-control-center-[version].tar.gz) from the NetApp Support Site.

  2. Download the zip of Astra Control Center certificates and keys from the NetApp Support Site.

  3. (Optional) Verify the signature of the bundle:

    openssl dgst -sha256 -verify AstraControlCenter-public.pub -signature astra-control-center-[version].tar.gz.sig astra-control-center-[version].tar.gz
  4. Extract the images:

    tar -vxzf astra-control-center-[version].tar.gz

Install the NetApp Astra kubectl plugin

The NetApp Astra kubectl command line plugin saves time when performing common tasks associated with deploying and upgrading Astra Control Center.

What you’ll need

NetApp provides plugin binaries for different CPU architectures and operating systems. You need to know which CPU and operating system you have before you perform this task.

Steps
  1. List the available NetApp Astra kubectl plugin binaries, and note the name of the file you need for your operating system and CPU architecture:

    Note The kubectl plugin library is part of the tar bundle and is extracted into the folder kubectl-astra.
    ls kubectl-astra/
  2. Move the correct binary into the current path and rename it to kubectl-astra:

    cp kubectl-astra/<binary-name> /usr/local/bin/kubectl-astra

Add the images to your local registry

  1. Complete the appropriate step sequence for your container engine:

Docker
  1. Change to the acc directory extracted from the tar bundle:

    Example:

cd ../acc
  1. Push the package images in the Astra Control Center image directory to your local registry. Make the following substitutions before running the command:

    • Replace <BUNDLE_FILE> with the name of the Astra Control bundle file (acc.manifest.yaml).

    • Replace <MY_FULL_REGISTRY_PATH> with the URL of the Docker repository; for example, https://exampledownloads.jfrog.io/docker-astra-control/v1/.

    • Replace <MY_REGISTRY_USER> with the user name.

    • Replace <MY_REGISTRY_TOKEN> with an authorized token for the registry.

      kubectl astra packages push-images -m <BUNDLE_FILE> -r <MY_FULL_REGISTRY_PATH> -u <MY_REGISTRY_USER> -p <MY_REGISTRY_TOKEN>
Podman
  1. Log in to your registry:

    podman login <MY_FULL_REGISTRY_PATH>
  2. Run the following script, making the <YOUR_REGISTRY> substitution as noted in the comments:

    # You need to be at the root of the tarball.
    # You should see these files to confirm correct location:
    #   acc.manifest.yaml
    #   acc/
    
    # Replace <YOUR_REGISTRY> with your own registry (e.g registry.customer.com or registry.customer.com/testing, etc..)
    export REGISTRY=<YOUR_REGISTRY>
    export PACKAGENAME=acc
    export PACKAGEVERSION=22.11.0-82
    export DIRECTORYNAME=acc
    for astraImageFile in $(ls ${DIRECTORYNAME}/images/*.tar) ; do
      # Load to local cache
      astraImage=$(podman load --input ${astraImageFile} | sed 's/Loaded image(s): //')
    
      # Remove path and keep imageName.
      astraImageNoPath=$(echo ${astraImage} | sed 's:.*/::')
    
      # Tag with local image repo.
      podman tag ${astraImage} ${REGISTRY}/netapp/astra/${PACKAGENAME}/${PACKAGEVERSION}/${astraImageNoPath}
    
      # Push to the local repo.
      podman push ${REGISTRY}/netapp/astra/${PACKAGENAME}/${PACKAGEVERSION}/${astraImageNoPath}
    done

Find the operator install page

  1. Complete one of the following procedures to access the operator install page:

    • From Red Hat Openshift web console:
      Astra Control Center install page

      1. Log in to the OpenShift Container Platform UI.

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

      3. Select the NetApp Astra Control Center operator.

      4. Select Install.

    • From Red Hat Ecosystem Catalog:
      Astra Control Center overview page

      1. Select the NetApp Astra Control Center operator.

      2. Select Deploy and Use.

Install the operator

  1. Complete the Install Operator page and install the operator:

    Note The operator will be available in all cluster namespaces.
    1. Select the operator namespace or netapp-acc-operator namespace will be created automatically as part of the operator 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 will be prompted to approve the manual install plan for this operator.
  2. From the console, go to the OperatorHub menu and confirm that the operator installed successfully.

Install Astra Control Center

  1. From the console within the details view of the Astra Control Center operator, select Create instance in the Provided APIs section.

  2. Complete the Create AstraControlCenter form field:

    1. Keep or adjust the Astra Control Center name.

    2. (Optional) Enable or disable Auto Support. Retaining Auto Support functionality is recommended.

    3. Enter the Astra Control Center address. Do not enter http:// or https:// in the address.

    4. Enter the Astra Control Center version; for example, 21.12.60.

    5. Enter an account name, email address, and admin last name.

    6. Retain the default volume reclaim policy.

    7. In Image Registry, enter your local container image registry path. Do not enter http:// or https:// in the address.

    8. If you use a registry that requires authentication, enter the secret.

    9. Enter the admin first name.

    10. Configure resources scaling.

    11. Retain the default storage class.

    12. Define CRD handling preferences.

  3. Select Create.

What’s next

Verify the successful installation of Astra Control Center and complete the remaining steps to log in. Additionally, you will complete the deployment by also performing setup tasks.