How to add an additional uplink to a vSwitch via CLI in Hyperion

Written By Christian Castagna (Administrator)

Updated at September 15th, 2025

→ 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 (optional). Install the package

rpm -ivh https://storage.googleapis.com/syneto_public_files/downloads/Syneto-Tools/Networking/syneto-nmctl-0.5.0-1.el9.x86_64.rpm

If the package is already installed, you do not need to run this command.

 

Step 4. List physical interfaces

syneto-nmctl list physical

EXAMPLE OUTPUT

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

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

 

Step 5. List all vSwitches

syneto-nmctl vswitch list

EXAMPLE

syneto-nmctl vswitch list

=== Virtual Switches ===
--- General purpose Virtual Switches ---
Management Network        vswitch0     bridge   activated
  └─ em2 (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 6. 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

Connection 'Management Uplink' (2e2fd3c2-a4a0-4483-9334-092aab45d358) successfully deleted.
[+] Creating bond0 with: em1,em2
Connection 'Management Uplink' (56361be4-934c-47c5-aef9-7f0fdf799fe7) successfully added.
Warning: There is another connection with the name 'em1'. Reference the connection by its uuid '365162e0-f99f-4268-b0ca-e34042d9e05f'
Connection 'em1' (365162e0-f99f-4268-b0ca-e34042d9e05f) successfully added.
Warning: There is another connection with the name 'em2'. Reference the connection by its uuid '5e2a3b71-b16b-43e6-9dbc-8d73515fdd9e'
Connection 'em2' (5e2a3b71-b16b-43e6-9dbc-8d73515fdd9e) successfully added.
Error: unknown connection 'vswitch0'.
Connection successfully activated (controller waiting for ports) (D-Bus active path: /org/freedesktop/NetworkManager/ActiveConnection/22)
Connection successfully activated (controller waiting for ports) (D-Bus active path: /org/freedesktop/NetworkManager/ActiveConnection/25)
[+] Reattaching vnet0 to vswitch0
[+] Reattaching vnet1 to vswitch0