Layer 4 (LVS)

Load balance UDP with HAProxy ALOHA

HAProxy Enterprise also has UDP support

Looking for UDP load balancing support in HAProxy Enterprise instead? Visit the HAProxy Enterprise UDP load balancing page.

To load balance UDP services with HAProxy ALOHA, use a Linux Virtual Server (LVS) load balancer in NAT mode to perform the load balancing at layer 4. In this scenario, responses from servers flow through HAProxy ALOHA (that is, not Direct Server Return).

Enable destination NAT Jump to heading

Configure LVS so that it translates the destination IP from the public IP on which HAProxy ALOHA listens to the backend server’s private IP.

  1. In the web UI’s LB Layer4 tab, add the mode nat directive to your existing configuration.

    haproxy
    director web 10.0.0.3:8000 UDP
    balance leastconn
    mode nat
    server web1 10.0.0.20:8000 weight 10 check
    haproxy
    director web 10.0.0.3:8000 UDP
    balance leastconn
    mode nat
    server web1 10.0.0.20:8000 weight 10 check
  2. Click OK and Apply.

  3. To make the changes persist after a reboot, go to the Setup tab and click Save within the Configuration section.

Enable source NAT Jump to heading

Create iptables NAT rules to translate the client’s source IP to the HAProxy ALOHA appliance’s IP.

There are two example configurations.

  • One network interface

    text
    --------+-------- 10.0.0.0/24, VIPs, backend servers
    |
    | eth0
    +---------+
    | |
    | ALOHA |
    | |
    +---------+
    text
    --------+-------- 10.0.0.0/24, VIPs, backend servers
    |
    | eth0
    +---------+
    | |
    | ALOHA |
    | |
    +---------+
  • Two network interfaces

    text
    --------+-------- 10.0.0.0/24, VIPs
    |
    | eth0
    +---------+
    | |
    | ALOHA |
    | |
    +---------+
    | eth1
    |
    --------+-------- 10.0.3.0/24, backend servers
    text
    --------+-------- 10.0.0.0/24, VIPs
    |
    | eth0
    +---------+
    | |
    | ALOHA |
    | |
    +---------+
    | eth1
    |
    --------+-------- 10.0.3.0/24, backend servers

    Info

    In configurations having two network interfaces, if you have failover configured on one VIP, configure a VIP with failover on the other interface as well.

  1. In the NAT tab, click Insert to add a new NAT rule.

  2. In the New Rule area, fill in the fields as directed below.

    Field Description
    IN Inbound network interface.
    OUT Outbound network interface. In a configuration with one network interface, this should be the same as the inbound interface. In a configuration with two interfaces, this interface should be different from the inbound interface.
    Protocol UDP.
  3. In the Before area, fill in the fields as directed below.

    Field Value Example
    Source Blank
    Source port Blank
    Destination VIP address 10.0.0.3
    Destination port UDP port or range 8000, or 50000-51000
  4. In the After area, fill in the fields as directed below.

    Field Value Example
    Source VIP address (Note: If you enter a local IP address, it cannot be shared between the members of a cluster.) 10.0.0.3
    Source port Blank
    Destination Blank
    Destination port Blank
  5. Check your configuration.

    • One network interface.

    Source NAT for UDP One Interface

    • Two network interfaces.

    Source NAT for UDP Two Interfaces

  6. Click Add and Apply.

  7. To make the changes persist after a reboot, go to the Setup tab and click Save within the Configuration section.

Enable LVS connection tracking Jump to heading

NAT relies on the connection tracking information so that it can translate all of the packets in a session in the same way.

  1. Click the Services tab.

  2. Locate the lvs service and click Setup.

  3. Enable connection tracking through the conntrack keyword.

    text
    service lvs
    ############ Linux Virtual Server, layer 3/4 load balancing
    conntrack
    text
    service lvs
    ############ Linux Virtual Server, layer 3/4 load balancing
    conntrack
  4. Click OK and then Close.

  5. Locate the lvs service and click Restart.

  6. To make the changes persist after a reboot, go to the Setup tab and click Save within the Configuration section.

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