7.3 Guardpot Agent Network Configuration
The Guardpot Agent CLI provides a menu-driven interface for managing all network settings directly on the agent machine. Upon launching the agent CLI, the main menu presents three options as shown in Figure 7.3-1:
Install Guardpot
Network Configuration
Update Guardpot CLI
Figure 7.3-1 – Guardpot Agent CLI Main Menu
This section covers Option 2: Network Configuration in detail.
7.3.1 Network Configuration Menu#
Selecting Network Configuration from the main menu opens the network management submenu with the following options:
Option | Description |
|---|---|
1. Show Current Configuration | Displays active network settings including DNS, bonds, static IPs, VLANs, and live interface status |
2. Assign Static IP | Assigns a static IP address to a selected interface or bond |
3. Remove Static IP | Removes a previously assigned static IP from an interface |
4. Bond Management | Create or delete network interface bonds |
5. VLAN Management | Add or delete VLAN interfaces |
6. Proxy Management | Configure, view, or remove proxy settings |
7. Re-apply Netplan from Saved State | Re-applies the saved Netplan configuration to the system |
8. Back | Returns to the main menu |
7.3.2 Show Current Configuration#
Selecting Option 1 displays a summary of the current network configuration, as shown in Figure 7.3.2-1.
Figure 7.3.2-1 – Show Current Configuration Output
The output is organized into the following sections:
Section | Description |
|---|---|
DNS | Configured DNS server addresses |
Bonds | Active network bonds and their member interfaces |
Static IPs | Statically assigned IP addresses per interface |
VLANs | Configured VLAN interfaces and their parameters |
Live Interface Status | Real-time status of each network interface, including state (Up / Down / Unknown) and MAC address |
7.3.3 Assign Static IP#
Selecting Option 2 launches the static IP assignment wizard, as shown in Figure 7.3.3-1.
Figure 7.3.3-1 – Assign Static IP Configuration
The wizard prompts for the following parameters:
Parameter | Description |
|---|---|
Select Interface or Bond | Lists all available interfaces and bonds (e.g., |
IP Address | The static IPv4 address to assign |
Subnet Prefix | Network prefix length (default: |
Gateway | Default gateway IP address |
DNS Servers | One or more DNS server addresses |
After entering all parameters, the configuration is applied and persisted via Netplan.
7.3.4 Remove Static IP#
Selecting Option 3 displays a list of interfaces with assigned static IP addresses, as shown in Figure 7.3.4-1.
Figure 7.3.4-1 – Remove Static IP Interface List
Each entry displays the interface name and its assigned IP address. Select the target entry by number to remove the static IP assignment. The change is applied immediately and the Netplan configuration is updated accordingly.
7.3.5 Bond Management#
Selecting Option 4 opens the Bond Management submenu, as shown in Figure 7.3.5-1.
Figure 7.3.5-1 – Bond Management Menu
Option | Description |
|---|---|
1. Create Bond | Combine two or more physical interfaces into a single logical bond |
2. Delete Bond | Remove an existing bond configuration |
3. Back | Return to the Network Configuration menu |
7.3.5.1 Create Bond#
To create a bond, at least two physical network interfaces must be connected to the machine. The wizard prompts you to select the member interfaces and choose a bonding mode.
Supported bonding modes include:
Mode | Description |
|---|---|
802.3ad (LACP) | Link Aggregation Control Protocol — requires switch support |
active-backup | One interface active at a time; failover on link failure |
balance-rr | Round-robin packet distribution across all interfaces |
balance-xor | XOR-based load balancing |
broadcast | Transmits on all interfaces simultaneously |
balance-tlb | Adaptive transmit load balancing |
balance-alb | Adaptive load balancing (includes receive balancing) |
7.3.5.2 Delete Bond#
Selecting Delete Bond lists all existing bond interfaces. Select the target bond by number to remove it. Member interfaces are released back to their individual states.
7.3.6 VLAN Management#
Selecting Option 5 opens the VLAN Management submenu, as shown in Figure 7.3.6-1.
Figure 7.3.6-1 – VLAN Management Menu
Option | Description |
|---|---|
1. Add VLAN | Create a new VLAN interface on top of an existing interface |
2. Delete VLAN | Remove an existing VLAN interface |
3. Back | Return to the Network Configuration menu |
7.3.6.1 Add VLAN#
Selecting Add VLAN launches the VLAN creation wizard, as shown in Figure 7.3.6.1-1.
Figure 7.3.6.1-1 – Add VLAN Configuration
Parameter | Description |
|---|---|
Link | The parent physical interface or bond to attach the VLAN to |
VLAN ID | Numeric VLAN identifier (1–4094) |
IP Address | Static IP address for this VLAN interface |
Subnet Prefix | Network prefix length (e.g., |
Gateway | Default gateway for this VLAN |
DNS Servers | DNS server addresses for this VLAN |
7.3.6.2 Delete VLANVLAN#
Selecting Delete VLAN displays all configured VLAN interfaces, as shown in Figure 7.3.6.2-1.
Figure 7.3.6.2-1 – Delete VLAN Interface List
Select the target VLAN by number to remove it. The associated Netplan configuration entry is deleted and the interface is brought down.
7.3.7 Proxy Management#
Selecting Option 6 opens the Proxy Management submenu, as shown in Figure 7.3.7-1.
Figure 7.3.7-1 – Proxy Management Menu
Option | Description |
|---|---|
1. Set / Update Proxy | Configure or update the system-wide proxy settings |
2. Show Proxy | Display the currently configured proxy settings |
3. Remove Proxy | Delete the existing proxy configuration |
4. Back | Return to the Network Configuration menu |
7.3.7.1 Set / Update Proxy#
Selecting Set / Update Proxy prompts for the following parameters:
Parameter | Description |
|---|---|
Proxy Host | IP address or DNS hostname of the proxy server |
Proxy Port | Port number the proxy listens on |
Username | Proxy authentication username (leave blank if not required) |
No Proxy | Comma-separated list of addresses or domains to bypass the proxy |
After confirming the entries, the proxy configuration is applied system-wide.
7.3.7.2 Show Proxy#
Selecting Show Proxy displays the currently active proxy configuration including the host, port, username, and no-proxy exceptions.
7.3.7.3 Remove Proxy#
Selecting Remove Proxy clears all proxy settings from the system. The agent will communicate directly without a proxy after this operation.
7.3.8 Re-apply Netplan from Saved State#
Selecting Option 7 re-applies the last saved Netplan configuration to the system. This is useful after manual edits or when network settings need to be restored to the last known-good state without rebooting.
Enter 7 at the Network Configuration menu and press Enter. The system applies the saved Netplan state and outputs a confirmation message upon success.
Note: This operation does not modify the saved configuration. It only re-applies what is already stored on disk.
Was this article helpful?
Your feedback helps us improve the documentation.