AOS Cluster

Demand for compute resources can grow beyond the capacity of a single virtual machine (VM). Multiple VMs can be clustered, specifically for scaling off-box agents and IBA probe processing units (as of version 3.0).

When a worker VM is added to the main Apstra controller VM, it registers with the Apstra server VM through sysdb, collects facts about the VM (such as core/memory/disk configuration and usage), and launches a container on the local VM. The Apstra controller VM reacts to REST API requests, configures the worker VM for joining or leaving the cluster, and keeps track of cluster-wide runtime information. It also reacts to container configuration entities and schedules them to the worker VM.

Apstra server VMs include the following details:

Static Configuration
IP address or Fully-qualified Domain Name (FQDN) of the VM
Apstra VM name, such as controller (the main Apstra controller) or node1 (a worker node)
Controller or worker
The function of the node: iba and/or offbox
Capacity Score
Calculated by Apstra
Number of CPUs

If an error exists, a message appears here. For example, the following image shows the error message when an agent process has been restarted because an agent has crashed.

Container Service Usage
Current VM container server usage (Percentage)
Containers Count
Number of containers
Memory Usage
Current VM memory usage (percentage)
CPU Usage
Current VM CPU usage (percentage)
Disk Usage
Current VM disk usage per logical volume (GB and percentage)
The containers that are running on the node and the resources used by each container
Web interface username login credential, such as admin
Web interface password login credential

From the web interface, navigate to Platform > AOS Cluster. You can health check the VMs from here. To see more information, click an address.


Creating Apstra VM

  1. Install Apstra software on the VMs to be clustered, making sure they are all the same version as the main controller (which acts as the cluster manager). If they are not the same version, the controller will not accept them as part of the cluster.
  2. From the list view (Platform > AOS Cluster) click Add Node, then enter a name, tags (optional), address (IP or FQDN), username and password.
  3. Click Create. As the main Apstra controller connects to the new Apstra VM worker node, the state of the new Apstra VM changes from INIT to ACTIVE.

Editing Apstra VM

  1. Either from the list view (Platform > AOS Cluster) or the details view, click the Edit button for the VM to edit.
  2. Make your changes.
  3. Click Update to update the Apstra VM worker node.

Deleting Apstra VM

  1. Either from the list view (Platform > AOS Cluster) or the details view, click the Delete button for the Apstra VM to delete.
  2. Click Delete to delete the Apstra VM.