Set up Astra Control Center

Contributors netapp-dbagwell netapp-mwallis netapp-amitha Download PDF of this page

After you install Astra Control Center, log in to the UI, and change your password, you’ll want to set up a license, add clusters, manage storage, and add buckets.

Add a license for Astra Control Center

You can add a new license using the UI or API to gain full Astra Control Center functionality. Without a license, your usage of Astra Control Center is limited to managing users and adding new clusters.

What you’ll need

When you downloaded Astra Control Center from the NetApp Support Site, you also downloaded the NetApp license file (NLF). Ensure you have access to this license file.

Note To update an existing evaluation or full license, see Update an existing license.

Add a full or evaluation license

Astra Control Center licenses measure CPU resources using Kubernetes CPU units. The license needs to account for the CPU resources assigned to the worker nodes of all the managed Kubernetes clusters. Before you add a license, you need to obtain the license file (NLF) from the NetApp Support Site.

You can also try Astra Control Center with an evaluation license, which lets you use Astra Control Center for 90 days from the date you download the license. You can sign up for a free trial by registering here.

Note If your installation grows to exceed the licensed number of CPU units, Astra Control Center prevents you from managing new applications. An alert is displayed when capacity is exceeded.
Steps
  1. Log in to the Astra Control Center UI.

  2. Select Account > License.

  3. Select Add License.

  4. Browse to the license file (NLF) that you downloaded.

  5. Select Add License.

The Account > License page displays the license information, expiration date, license serial number, account ID, and CPU units used.

Note If you have an evaluation license, be sure you store your account ID to avoid data loss in the event of Astra Control Center failure if you are not sending ASUPs.

Add cluster

To begin managing your apps, add a Kubernetes cluster and manage it as a compute resource. You have to add a cluster for Astra Control Center to discover your Kubernetes applications.

Tip We recommend that Astra Control Center manage the cluster it is deployed on first before you add other clusters to Astra Control Center to manage. Having the initial cluster under management is necessary to send Kubemetrics data and cluster-associated data for metrics and troubleshooting. You can use the Add Cluster feature to manage a cluster with Astra Control Center.
Important
What you’ll need
Before you add a cluster, review and perform the necessary prerequisite tasks.
Steps
  1. From the Dashboard in the Astra Control Center UI, select Add in the Clusters section.

  2. In the Add Cluster window that opens, upload a kubeconfig.yaml file or paste the contents of a kubeconfig.yaml file.

    Note The kubeconfig.yaml file should include only the cluster credential for one cluster.

    Shows the screen to upload kubeconfig.yaml for cluster.

    Important If you create your own kubeconfig file, you should define only one context element in it. See Kubernetes documentation for information about creating kubeconfig files.
  3. Provide a credential name. By default, the credential name is auto-populated as the name of the cluster.

  4. Select Configure storage.

  5. Select the storage class to be used for this Kubernetes cluster, and select Review.

    Note You should select a Trident storage class backed by ONTAP storage.

    Shows the storage class to be used for the cluster.

  6. Review the information, and if everything looks good, select Add cluster.

Result

The cluster enters the Discovering status and then changes to Running. You have successfully added a Kubernetes cluster and are now managing it in Astra Control Center.

Important After you add a cluster to be managed in Astra Control Center, it might take a few minutes to deploy the monitoring operator. Until then, the Notification icon turns red and logs a Monitoring Agent Status Check Failed event. You can ignore this, because the issue resolves when Astra Control Center obtains the correct status. If the issue does not resolve in a few minutes, go to the cluster, and run oc get pods -n netapp-monitoring as the starting point. You will need to look into the monitoring operator logs to debug the problem.

Add a storage backend

You can add a storage backend so that Astra Control can manage its resources. Managing storage clusters in Astra Control as a storage backend enables you to get linkages between persistent volumes (PVs) and the storage backend as well as additional storage metrics.

You can add a storage backend in the following ways:

  • Configure storage when you are adding a cluster. See Add cluster.

  • Add a discovered storage backend using either the Dashboard or the Backends option.

You can add an already discovered storage backend using these options:

Add storage backend using Dashboard

  1. From the Dashboard do one of the following:

    1. From the Dashboard Storage backend section, select Manage.

    2. From the Dashboard Resource Summary > Storage backends section, select Add.

  2. Enter the ONTAP admin credentials and select Review.

  3. Confirm the backend details and select Manage.

    The backend appears in the list with summary information.

Add storage backend using Backends option

  1. In the left navigation area, select Backends.

  2. Select Manage.

  3. Enter the ONTAP admin credentials and select Review.

  4. Confirm the backend details and select Manage.

    The backend appears in the list with summary information.

  5. To see details of the backend storage, select it.

    Tip Persistent volumes used by apps in the managed compute cluster are also displayed.

Add a bucket

Adding object store bucket providers is essential if you want to back up your applications and persistent storage or if you want to clone applications across clusters. Astra Control stores those backups or clones in the object store buckets that you define.

When you add a bucket, Astra Control marks one bucket as the default bucket indicator. The first bucket that you create becomes the default bucket.

You don’t need a bucket if you are cloning your application configuration and persistent storage to the same cluster.

Use any of the following bucket types:

  • NetApp ONTAP S3

  • NetApp StorageGRID S3

  • Generic S3

Note Although Astra Control Center supports Amazon S3 as a Generic S3 bucket provider, Astra Control Center might not support all object store vendors that claim Amazon’s S3 support.

For instructions on how to add buckets using the Astra API, see Astra Automation and API information.

Steps
  1. In the left navigation area, select Buckets.

    1. Select Add.

    2. Select the bucket type.

      Note When you add a bucket, select the correct bucket provider type with credentials that are correct for that provider. For example, the UI accepts NetApp ONTAP S3 as the type with StorageGRID credentials; however, this will cause all future app backups and restores using this bucket to fail.
    3. Create a new bucket name or enter an existing bucket name and optional description.

      Tip The bucket name and description appear as a backup location that you can choose later when you’re creating a backup. The name also appears during protection policy configuration.
    4. Enter the name or IP address of the S3 server.

    5. If you want this bucket to be the default bucket for all backups, check the Make this bucket the default bucket for this private cloud option.

      Note This option does not appear for the first bucket you create.
    6. Continue by adding credential information.

Add S3 access credentials

Add S3 access credentials at any time.

Steps
  1. From the Buckets dialog, select either the Add or Use existing tab.

    1. Enter a name for the credential that distinguishes it from other credentials in Astra Control.

    2. Enter the access ID and secret key by pasting the contents from your clipboard.

What’s next?

Now that you’ve logged in and added clusters to Astra Control Center, you’re ready to start using Astra Control Center’s application data management features.

Find more information