→ Applies to: Hyperion 9.x and above

All commands in this article are intended to be executed via Hyperion CLI.

Step 1. Connect to Hyperion appliance via SSH as admin

ssh admin@<your_ip_address_or_hostname>

Step 2. Become Super User

sudo su

Step 3. List physical interfaces

syneto-nmctl list physical

EXAMPLE OUTPUT

[root@syneto-os-14091a30 ~]# syneto-nmctl list physical

=== Physical Interfaces ===
enp71s0f3u1u1c2 [link up] - Ethernet (unknown speed)
em1 [link up] - Ethernet 1000baseT
em2 [link up] - Ethernet 1000baseT

Make note of the name of the physical interfaces to add to the vSwitch.

Step 4. List all vSwitches

syneto-nmctl vswitch list

EXAMPLE

[root@syneto-os-14091a30 ~]# syneto-nmctl vswitch list
[+] First run detected - creating initial network configuration backup...
[+] Creating network configuration backup 'backup_20250925_120201'...
[+] Backup completed successfully:
 - JSON backup: /var/lib/syneto-nmctl/backups/backup_20250925_120201.json
 - Type: Default backup (first run)

=== Virtual Switches ===
DEBUG: Filtering out vnet interface: vnet0 for bridge: Management Network
DEBUG: Filtering out vnet interface: vnet1 for bridge: Management Network
--- General purpose Virtual Switches ---
Management Network    vswitch0   bridge  activated
 └─ em1 (Management Uplink)
cni0           cni0     bridge  activated
virbr0          virbr0    bridge  activated

--- VLAN-Dedicated Virtual Switches ---

Make note of the vSwitch where the second uplink needs to be added.

Step 5. Add an additional uplink to an existing vSwitch (replace <vswitch_name>, <uplink1> and <uplink2> with the correct information)

syneto-nmctl vswitch change --name <vswitch_name> --uplink <uplink1>,<uplink2>

EXAMPLE

syneto-nmctl vswitch change --name vswitch0 --uplink em1,em2

EXAMPLE OUTPUT

[root@syneto-os01 support]# syneto-nmctl vswitch change --name vswitch0 --uplink em1,em2
[+] Found bridge device: 'vswitch0'
[+] Preserving vswitch0 MAC address for stability
[+] Creating bond0 with: em1,em2
[+] Ensuring vswitch0 MAC address persistence: 6a:3e:8e:e3:bc:f5
[+] Restoring vswitch0 MAC address to: 7c:c2:55:c0:10:92
[+] Restoring vswitch0 MAC address to: 7c:c2:55:c0:10:92
[root@syneto-os01 support]# syneto-nmctl vswitch list

=== Virtual Switches ===
--- General purpose Virtual Switches ---
Management Network        vswitch0     bridge   activated
  └─ bond0 (vswitch0 Uplink)
cni0                      cni0         bridge   activated
virbr0                    virbr0       bridge   activated

--- VLAN-Dedicated Virtual Switches ---

Step 6. Check if the additional uplink has been added to the vSwitch

syneto-nmctl bond list

EXAMPLE OUTPUT

[root@syneto-os01 support]# syneto-nmctl bond list
=== Bond Interfaces ===
vswitch0 Uplink           bond0        bond     activated [mode: active-backup]
  └─ em1 (em1)
  └─ em2 (em2)