→ Applies to: Hyperion 9.x and above

PREREQUISITES
– Ensure the appliance is running SynetoOS 6.0.1 or later
– Ensure the appliance is running Syneto-nmctl version 2.0.0 (b43108a) or later. For upgrade instructions, refer to “How to Upgrade Syneto-nmctl in Hyperion”.

This article lists the steps to create two vSwitches, one for untagged traffic and one for VLAN traffic in Hyperion.

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 all virtual switches

syneto-nmctl vswitch list

EXAMPLE OUTPUT

[root@1st-Hyperion-6-1 admin]# syneto-nmctl vswitch list

=== Virtual Switches ===
--- General purpose Virtual Switches ---
Management Network      vswitch0      bridge      activated
  └─ ens192 (Management Network Uplink) [carrier]
virbr0                 virbr0        bridge      activated
cni0                   cni0          bridge      activated

Step 4. List all uplinks

syneto-nmctl list physical

EXAMPLE OUTPUT

[root@1st-Hyperion-6-1 admin]# syneto-nmctl list physical

=== Physical Interfaces ===
ens224 00:0c:29:89:8a:98 [link up] - Ethernet 10GbaseT
ens192 00:0c:29:89:8a:8e [link up] - Ethernet 10GbaseT
ens256 00:0c:29:89:8a:a2 [link up] - Ethernet 10GbaseT
ens161 00:0c:29:89:8a:ac [link up] - Ethernet 10GbaseT

Step 5. Configure the default vSwitch by binding it to one or more physical uplinks (replace <vswitch_name> with the name to give the switch and <eth_name> with the uplink/s to connect)

syneto-nmctl vswitch change --name <vswitch_name> --uplink <eth_name>

EXAMPLE

syneto-nmctl vswitch change --name vswitch0 --uplink ens224,ens192,ens256,ens161

Step 6. List all virtual switches

syneto-nmctl vswitch list

EXAMPLE OUTPUT

[root@1st-Hyperion-6-1 admin]# syneto-nmctl vswitch list

=== Virtual Switches ===
--- General purpose Virtual Switches ---
Management Network        vswitch0     bridge   activated
  └─ Connected: vswitch0
  └─ bond0 (bond0)
      └─ ens224 [carrier]
      └─ ens192 [carrier]
      └─ ens256 [carrier]
      └─ ens161 [carrier]
virbr0                    virbr0       bridge   activated
cni0                      cni0         bridge   activated

Step 7 (optional). Mark the default vSwitch as master (replace <vswitch_name> with the correct vSwitch)

syneto-nmctl vswitch set-master --name <vswitch_name>

EXAMPLE

syneto-nmctl vswitch set-master --name vswitch0

Step 8. Create a vSwitch for untagged traffic (replace <vswitch_untagged_name> with the correct untagged vSwitch name)

syneto-nmctl vswitch create --name <vswitch_untagged_name> --uplink none

EXAMPLE

syneto-nmctl vswitch create --name untagged --uplink none

Step 9. Connect the vSwitch from Step 8 to the default vSwitch from Step 5 (replace <vswitch_untagged_name> with the correct untagged vSwitch and <vswitch_name> with the correct vSwitch)

syneto-nmctl vswitch connect --bridge <vswitch_untagged_name> --to <vswitch_name>

EXAMPLE

syneto-nmctl vswitch connect --bridge untagged --to vswitch0

Step 10. Create a vSwitch for VLAN traffic (replace <vswitch_vlan_name> with the correct VLAN vSwitch name)

syneto-nmctl vswitch create --name <vswitch_vlan_name> --uplink none

EXAMPLE

syneto-nmctl vswitch create --name vlan --uplink none

Step 11. Connect the vSwitch from Step 10 to the default vSwitch (replace <vswitch_vlan_name> with the correct VLAN vSwitch and <vswitch_name> with the correct vSwitch from Step 5)

syneto-nmctl vswitch connect --bridge <vswitch_vlan_name> --to <vswitch_name>

EXAMPLE

syneto-nmctl vswitch connect --bridge vlan --to vswitch0

Step 12 (Optional). Attach the VM Network created in Step 8 to a vSwitch port group configured for untagged traffic (replace <virtual_network_name> with the correct virtual network name and <vswitch_untagged_name> with the correct vSwitch untagged)

syneto-nmctl network change —-name <virtual_network_name> --vswitch <vswitch_untagged_name>

EXAMPLE

syneto-nmctl network change —-name VM\ Network --vswitch untagged

Step 13 (Optional). Create VLANs ("How to Create a VLAN via CLI in Hyperion")

Video Example