Network

VLAN

An HAProxy ALOHA network interface may be connected to a switch interface through a VLAN trunk link. You can then create a VLAN interface on the HAProxy ALOHA instance to route traffic over the relevant VLAN.

VLAN Diagram

This feature is based on the VLAN tagging capability.

Create a VLAN interface Jump to heading

To create a VLAN interface, you have to create a new service network:

  1. In the Services tab, click network setup to display the current configuration of your network interfaces.

    Interface Setup Bonding

  2. Add a directive to create a new VLAN interface.

    The syntax is as follows:

    service network eth<id>.<vlanid>
    service network eth<id>.<vlanid>

    In the example below, we create VLANs 100, 200, and 300 on interface eth0:

    service network eth0.100 ip address 172.16.100.4/255.255.255.192 service network eth0.200 ip address 172.16.100.65/255.255.255.192 service network eth0.300 ip address 172.16.100.129/255.255.255.192
    service network eth0.100 ip address 172.16.100.4/255.255.255.192 service network eth0.200 ip address 172.16.100.65/255.255.255.192 service network eth0.300 ip address 172.16.100.129/255.255.255.192

    A physical network interface can support both its own IP configuration (untagged network) and one or more VLAN (tagged) interfaces. In this configuration, traffic with a VLAN tag matching a defined VLAN goes to the VLAN, and traffic without a VLAN tag goes to the untagged network.

    The untagged network does not serve as a default destination for tagged traffic that does not match any of the defined VLANs. Tagged traffic that does not match a defined VLAN is dropped.

    This configuration is not recommended because it relies on switches and routers to ensure untagged networks and tagged networks remain isolated. If an interface is intended to support multiple network schemes, a separate VLAN should be created for each scheme.

    Below, we define two networks, one for untagged traffic and one for traffic tagged for VLAN 100. Traffic having any other tag is dropped. This configuration is not recommended.

    service network eth0 ip address 172.16.100.4/255.255.255.192 service network eth0.100 ip address 172.16.100.65/255.255.255.192
    service network eth0 ip address 172.16.100.4/255.255.255.192 service network eth0.100 ip address 172.16.100.65/255.255.255.192
  3. Apply the configuration:

    • If you just created the VLAN interface, click Restart on the network line.
    • If you just updated an existing VLAN interface, click Reload.

    You can manage IP configuration and VRRP settings in the same way as for a physical interface.

  4. To make your changes persistent after a reboot, click the Setup tab. Then click Save under Configuration.

Verify the VLAN interface Jump to heading

The VLAN interface should have been assigned to the physical interface, for example VLAN 100 on physical interface eth0. To check this, use the ip command to verify that the MAC addresses (the link/ether value) for the physical interface and its VLAN network are the same.

Below, we verify that the MAC addresses are the same on eth0 and eth0.100. Both show matching link/ether values of 08:00:27:8d:c0:4d.

nix
sudo ip addr show
nix
sudo ip addr show
output
text
...
2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP group default qlen 1000
link/ether 08:00:27:8d:c0:4d brd ff:ff:ff:ff:ff:ff
altname enp0s3
inet 172.16.100.4/26 scope global eth0
valid_lft forever preferred_lft forever
inet6 fe80::a00:27ff:fe8d:c04d/64 scope link
valid_lft forever preferred_lft forever
3: eth0.100@eth0: <BROADCAST,MULTICAST> mtu 1500 qdisc noop state DOWN group default qlen 1000
link/ether 08:00:27:8d:c0:4d brd ff:ff:ff:ff:ff:ff
inet 172.16.100.65/26 scope global eth0.100
valid_lft forever preferred_lft forever
output
text
...
2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP group default qlen 1000
link/ether 08:00:27:8d:c0:4d brd ff:ff:ff:ff:ff:ff
altname enp0s3
inet 172.16.100.4/26 scope global eth0
valid_lft forever preferred_lft forever
inet6 fe80::a00:27ff:fe8d:c04d/64 scope link
valid_lft forever preferred_lft forever
3: eth0.100@eth0: <BROADCAST,MULTICAST> mtu 1500 qdisc noop state DOWN group default qlen 1000
link/ether 08:00:27:8d:c0:4d brd ff:ff:ff:ff:ff:ff
inet 172.16.100.65/26 scope global eth0.100
valid_lft forever preferred_lft forever

Do you have any suggestions on how we can improve the content of this page?