acc_operatorhub_install.adoc

sidebar	permalink	keywords	summary
sidebar	get-started/acc_operatorhub_install.html	how to install astra control center, operator, operatorhub, openshift, install astra control center operator, service mesh	If you use Red Hat OpenShift, you can install the Astra Control Center using an operator.

Install Astra Control Center using OpenShift OperatorHub

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.

Before you begin

• Meet environmental prerequisites: Before you begin installation, prepare your environment for Astra Control Center deployment.

  Tip	Deploy Astra Control Center in a third fault domain or secondary site. This is recommended for app replication and seamless disaster recovery.

• 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

• Ensure a routable FQDN: The Astra FQDN you plan to use can be routed to the cluster. This means that you either have a DNS entry in your internal DNS server or you are using a core URL route that is already registered.

• Obtain OpenShift permissions: You’ll need all necessary permissions and access to the Red Hat OpenShift Container Platform to perform the installation steps described.

• Configure a cert manager: 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.

• Set up Kubernetes ingress controller: If you have a Kubernetes ingress controller that manages external access to services, such as load balancing in a cluster, you need to set it up for use with Astra Control Center:

  1. Create the operator namespace:

     oc create namespace netapp-acc-operator

  2. Complete setup for your ingress controller type.

• (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:

  ../_include/access-netapp-image-registry.adoc

• Install a service mesh for secure communications: It is strongly recommended that Astra Control host cluster communications channels be secured using a supported service mesh.

  Important

  Integrating Astra Control Center with a service mesh can only be done during Astra Control Center installation and not independent of this process. Changing back from a meshed to an unmeshed environment is not supported.

  For Istio service mesh use, you’ll need to do the following:

  • Add an istio-injection:enabled label to the Astra namespace prior to deploying Astra Control Center.

  • Use the Generic ingress setting and provide an alternative ingress for external load balancing.

  • For Red Hat OpenShift clusters, you’ll need to define NetworkAttachmentDefinition on all associated Astra Control Center namespaces (netapp-acc-operator, netapp-acc, netapp-monitoring for application clusters, or any custom namespaces that have been substituted).

    cat <<EOF | oc -n netapp-acc-operator create -f -
    apiVersion: "k8s.cni.cncf.io/v1"
    kind: NetworkAttachmentDefinition
    metadata:
      name: istio-cni
    EOF
    
    cat <<EOF | oc -n netapp-acc create -f -
    apiVersion: "k8s.cni.cncf.io/v1"
    kind: NetworkAttachmentDefinition
    metadata:
      name: istio-cni
    EOF
    
    cat <<EOF | oc -n netapp-monitoring create -f -
    apiVersion: "k8s.cni.cncf.io/v1"
    kind: NetworkAttachmentDefinition
    metadata:
      name: istio-cni
    EOF

Steps

• [Download and extract Astra Control Center]

• Complete additional steps if you use a local registry

• Find the operator install page

• Install the operator

• Install Astra Control Center

Important

Do not delete the Astra Control Center operator (for example, kubectl delete -f astra_control_center_operator_deploy.yaml) at any time during Astra Control Center installation or operation to avoid deleting pods.

../_include/download-extract-acc.adoc

Complete additional steps if you use a local registry

If you are planning to push the Astra Control Center bundle to your local registry, you need to use the NetApp Astra kubectl command line plugin.

Install the NetApp Astra kubectl plugin

Complete these steps to install the most recent NetApp Astra kubectl command line plugin.

Before you begin

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.

If you already have the plugin installed from a previous installation, make sure you have the latest version before completing these steps.

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 registry

../_include/docker-podman-add-images.adoc

Find the operator install page

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

   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.

      

   Red Hat Ecosystem Catalog

   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’ll 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 Astra Control Center tab of the Astra Control Center operator, select Create AstraControlCenter.
   

2. Complete the Create AstraControlCenter form field:

   1. Keep or adjust the Astra Control Center name.

   2. Add labels for the Astra Control Center.

   3. Enable or disable Auto Support. Retaining Auto Support functionality is recommended.

   4. Enter the Astra Control Center FQDN or IP address. Do not enter http:// or https:// in the address field.

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

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

   7. Choose a volume reclaim policy of Retain, Recycle, or Delete. The default value is Retain.

   8. Select the scale size of the installation.

      Note	By default, Astra will use High Availability (HA) scaleSize of Medium, which deploys most services in HA and deploys multiple replicas for redundancy. With scaleSize as Small, Astra will reduce the number of replicas for all services except for essential services to reduce consumption.

   9. Select the ingress type:

      • Generic (ingressType: "Generic") (Default)

        Use this option when you have another ingress controller in use or would prefer to use your own ingress controller. After Astra Control Center is deployed, you’ll need to configure the ingress controller to expose Astra Control Center with a URL.

      • AccTraefik (ingressType: "AccTraefik")

        Use this option when you would prefer not to configure an ingress controller. This deploys the Astra Control Center traefik gateway as a Kubernetes "LoadBalancer" type service.

        Astra Control Center uses a service of the type "LoadBalancer" (svc/traefik in the Astra Control Center namespace), and requires that it be assigned an accessible external IP address. If load balancers are permitted in your environment and you don’t already have one configured, you can use MetalLB or another external service load balancer to assign an external IP address to the service. In the internal DNS server configuration, you should point the chosen DNS name for Astra Control Center to the load-balanced IP address.

        Note	For details about the service type of "LoadBalancer" and ingress, refer to Requirements.

   10. In Image Registry, use the default value unless you configured a local registry. For a local registry, replace this value with the local image registry path where you pushed the images in a previous step. Do not enter http:// or https:// in the address field.

   11. If you use an image registry that requires authentication, enter the image secret.

       Note	If you use a registry that requires authentication, create a secret on the cluster.

   12. Enter the admin first name.

   13. Configure resources scaling.

   14. Provide the default storage class.

       Note	If a default storage class is configured, ensure that it is the only storage class that has the default annotation.

   15. Define CRD handling preferences.

3. Select the YAML view to review the settings you have selected.

4. Select Create.

Create a registry secret

If you use a registry that requires authentication, create a secret on the OpenShift cluster and enter the secret name in the Create AstraControlCenter form field.

1. Create a namespace for the Astra Control Center operator:

   oc create ns [netapp-acc-operator or custom namespace]

2. Create a secret in this namespace:

   oc create secret docker-registry astra-registry-cred -n [netapp-acc-operator or custom namespace] --docker-server=[your_registry_path] --docker username=[username] --docker-password=[token]

   Note	Astra Control supports Docker registry secrets only.

3. Complete the remaining fields in the Create AstraControlCenter form field.

What’s next

Complete the remaining steps to verify that Astra Control Center installed successfully, set up an ingress controller (optional), and log in to the UI. Additionally, you’ll need to perform setup tasks after completing installation.