→ Applies to: Hyperion 9.x and above

PREREQUISITES
Ensure the appliance is running SynetoOS 6.0.1 or later

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)