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)
- ACTIVE, MISSING, or FAILED
- 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¶
- 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.
- From the list view (Platform > AOS Cluster) click Add Node, then enter a name, tags (optional), address (IP or FQDN), username and password.
- 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¶
- Either from the list view (Platform > AOS Cluster) or the details view, click the Edit button for the VM to edit.
- Make your changes.
- Click Update to update the Apstra VM worker node.
Deleting Apstra VM¶
- Either from the list view (Platform > AOS Cluster) or the details view, click the Delete button for the Apstra VM to delete.
- Click Delete to delete the Apstra VM.