Skip to main content
NetApp Console setup and administration

Maintain the Console agent VM and operating system

Contributors netapp-tonias
PDFs

Maintaining the operating system on the Console agent host is your (the customer's) responsibility. For example, you (the customer) should apply security updates to the operating system on the agent host by following your company's standard procedures for operating system distribution.

Tip If you have an existing agent, you should be aware of changes to supported Linux operating systems.

Operating system patches and the agent

Apply OS security patches without stopping agent host services.

VM or instance type

If you create a Console agent from the Console, it deploys a VM instance in your cloud provider with a default configuration. After you create the agent, don't switch to a smaller VM instance with less CPU or RAM.

The following table lists the CPU and RAM requirements:

CPU

8 cores or 8 vCPUs

RAM

32 GB

Learn about the default configuration for the agent.

Monitor the agent

The Console notifies you when the agent VM is unhealthy, including disk space, RAM, and CPU issues. Monitor these notifications in the Notifications Center within the Console or configure email notifications. Occasional increases in disk space, memory, or CPU usage are normal, but if it happens frequently, you should take steps to resolve.

For example, the Console notifies you when an agent resource (CPU, RAM, or disk space) exceeds 90% of its total capacity for 30 consecutive minutes. Afterwards, if the resource usage drops below that threshold, the notification displays as resolved (green) in the Notifications Center.

Note Work with NetApp support if you have questions about modifying your agent VM.

Learn more.

Notification Action needed

Disk space is too high

Review the NetApp Knowledge Base article.

CPU usage is too high

Increase the CPU size of the agent VM in your cloud provider or on-premises, depending on where you installed it. Alternatively, create additional agents and distribute the workload across multiple agents. RAM utilization can vary based on your environment, ONTAP workloads, number of Cloud Volumes ONTAP systems, and the data services that you are using.

RAM usage is too high

Increase the RAM of the agent VM in your cloud provider or on-premises, depending on where you installed it. Alternatively, create additional agents and distribute the workload across multiple agents. RAM utilization can vary based on your environment, ONTAP workloads, number of Cloud Volumes ONTAP systems, and the data services that you are using.

Stopping and starting the agent VM

If you need to, stop and start the agent VM using your cloud provider's console or standard on-premises procedures.

Be aware that the Console agent must be operational at all times.

Connect to the Linux VM

If you need to connect to the Linux VM that the agent runs on, use the connectivity options from your cloud provider.

AWS

When you create the agent instance in AWS, provide an AWS access key and secret key. You can use this key pair to SSH to the instance. Use the user name 'ubuntu' for the EC2 Linux instance. For agents created prior to May 2023, use the user name 'ec2-user'.

AWS Docs: Connect to your Linux instance

Azure

When you create the agent VM in Azure, you specify a user name and choose to authenticate with a password or SSH public key. Use the authentication method that you chose to connect to the VM.

Azure Docs: SSH into your VM

Google Cloud

You can't specify an authentication method when you create an agent in Google Cloud. However, you can connect to the Linux VM instance using the Google Cloud Console or Google Cloud CLI (gcloud).

Google Cloud Docs: Connect to Linux VMs

Change the IP address for an agent

You can change the internal and public IP addresses of the agent instance assigned by your cloud provider if needed.

Steps

  1. Follow the instructions from your cloud provider to change the local IP address or public IP address (or both) for the agent instance.

  2. Restart the agent instance to register a new public IP address with the Console.

  3. If you changed the private IP address, update the backup location for Cloud Volumes ONTAP configuration files so that the backups are being sent to the new private IP address on the agent.

    Update the backup location for each Cloud Volumes ONTAP system.

    1. From the Cloud Volumes ONTAP CLI, set the privilege level to advanced:

      set -privilege advanced

    2. Run the following command to display the current backup target:

      system configuration backup settings show

    3. Run the following command to update the IP address for the backup target:

      system configuration backup settings modify -destination <target-location>

Edit an agent's URIs

You can add and remove the Uniform Resource Identifier (URI) for an agent.

Steps

  1. Select Administration > Agents.

  2. On the Overview page, select the action menu for a Console agent and select Edit agent.

    The Console agent must be active to edit it.

  3. Expand the Agent URIs bar to view agent URIs.

  4. Add and remove URIs and then select Apply.