Skip to main content
Astra Control Center
A newer release of this product is available.

Set up Astra Control Center

Contributors
PDFs

Astra Control Center supports and monitors ONTAP and Astra Data Store as the storage backend. 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.

Tasks

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. For Astra Data Store preview, you want to add the Kubernetes app cluster that contains applications that are using volumes provisioned by Astra Data Store preview.

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.
Note

When Astra Control manages a cluster, it keeps track of the cluster's default StorageClass. If you change the StorageClass using kubectl commands, Astra Control reverts the change. To change the default StorageClass in a cluster managed by Astra Control, use one of the following methods:

  • Use the Astra Control API PUT /managedClusters endpoint, and assign a different default StorageClass with the DefaultStorageClass parameter

  • Remove the cluster from Astra Control management and re-add it with a different default StorageClass selected
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 or Astra Data Store.

    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 discovered storage backend by navigating prompts from the Dashboard or the Backends menu.

What you'll need

  • You have added a cluster and it is managed by Astra Control.

    Note The managed cluster has a supported backend attached to it that can be discovered by Astra Control.

  • For Astra Data Store preview installations: You have added your Kubernetes app cluster.

    Note After you add your Kubernetes app cluster for Astra Data Store, the cluster appears as unmanaged in the list of discovered backends. You must next add the compute cluster that contains Astra Data Store and underlies the Kubernetes app cluster. You can do this from Backends in the UI. Select the Actions menu for the cluster, select Manage, and add the cluster. After the cluster state of unmanaged changes to the name of the Kubernetes cluster, you can proceed with adding a backend.
Steps

  1. Do one of the following:

    • From Dashboard:

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

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

    • From Backends:

      1. In the left navigation area, select Backends.

      2. Select Manage.

  2. Do one of the following depending on your backend type:

    • Astra Data Store:

      1. Select the Astra Data Store tab.

      2. Select the managed compute cluster and select Next.

      3. Confirm the backend details and select Manage storage backend.

    • ONTAP:

      1. Enter the ONTAP admin credentials and select Review.

      2. Confirm the backend details and select Manage.

    The backend appears in available state in the list with summary information.

Note You might need to refresh the page for the backend to appear.

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 Control 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 and provide the right credentials for that provider. For example, the UI accepts NetApp ONTAP S3 as the type and accepts 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 endpoint.

    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