HAProxy ALOHA Documentation 12.5

Configuration Wizard

You can use the Wizard tab to set up the network configuration of HAProxy ALOHA.

Launch the wizard

On the web user interface, click the Wizard tab. Then click Next to start, or Cancel to quit.

Configure network interfaces

Use the Physical interfaces screen to configure the HAProxy ALOHA network adapters so that they are compatible with the switches and computers on your network.

  1. Select the network speed (Auto / 10 / 100 / 1000 Mbps) to match the supported speed of your network.

  2. Select negotiation mode (Auto / half duplex / full duplex).

  3. Write a description for the interface (optional).

  4. Click Next to go to the next step.


Configure membership in a VLAN

Use the VLANs configuration screen to join HAProxy ALOHA to a virtual local area network (VLAN). If you do not need to join a VLAN, click Next to go to the next step.

  1. Choose the network interface on which you want to create a virtual interface.

  2. Type the VLAN ID that you configured on your switch.

  3. Type a short description for this virtual interface (optional).

  4. Click Create.

    The result should look like the image below:

  5. Repeat these steps to create other virtual interfaces connected to VLANs.

  6. Click Next to go to the next step.

Configure static IP addresses

Use the IP addresses screen to assign static IP addresses to HAProxy ALOHA. This step is mandatory and you must add at least one address, even if it is only an address used to reach the HAProxy ALOHA web user interface. In the case of the virtual appliance, you can use this to replace the dynamically assigned address that HAProxy ALOHA was given on first install.

  1. Choose the network interface that you want to configure.

  2. Set the IP address/subnet mask, using the format: aaa.bbb.ccc.ddd/mm.

  3. Click Add.

    The result should look like the image below:

  4. Repeat these steps as required to assign more static IP addresses.

  5. Click Next to go to the next step.

Configure IP routes

Use the IP routes screen to add network routing information to HAProxy ALOHA. In a production environment, you should, at a minimum, configure the default gateway route that will be used to reach users and servers that are located on a different subnet.

  1. Choose a network interface through which you will send traffic destined for the specified network.

  2. For Network, enter the subnetwork. Use one of the following values:

    • A network prefix followed by a CIDR, e.g.

    • A network prefix followed by a subnet mask, e.g.

    • The special value default, which means the default gateway

  3. For Gateway, enter the destination IP address.

  4. Click Add.

    The result should look like the image below:

  5. Repeat these steps as required to set more routes.

  6. Click Next to go to the next step.

Configure high availability

Use the High availability screen to enable active-standby mode between two HAProxy ALOHA instances and create virtual IP addresses (VIPs) for your application services. If the primary HAProxy ALOHA loses connectivity, the VIP will automatically migrate to the standby HAProxy ALOHA and continue serving traffic.

  1. Choose the interface on which you would like to create the VIP.

  2. Enter the virtual IP address that you wish to create on the network. Be sure to use the same value when configuring this VIP on the standby HAProxy ALOHA instance.

  3. The vrID is the virtual router ID. Choose an integer between 0 and 255 and be sure to use the same value when configuring the standby HAProxy ALOHA instance in order to pair them.

  4. The Priority sets whether this HAProxy ALOHA instance should be the primary or standby instance. Choose an integer between 1 and 254, making sure that the primary instance has a higher number than the standby.


Next, enable synchronization of the load balancer configuration between the two HAProxy ALOHA instances.

  1. Choose HAProxy ALOHA instance's role in the cluster: Active (primary) or Passive (standby).

  2. Set Local address to the IP address that should be used for synchronization.

  3. Set Remote address to the IP address of the peer HAProxy ALOHA instance.

  4. Click Next to go to the next step.

Configure management

Use the Management screen to configure access to the server and web user interface, set the server's hostname, and enable SNMP monitoring.

  1. In the SSH section, check the Enable SSH box to enable SSH to HAProxy ALOHA server. You can also change the SSH port or keep the default value, 22.

  2. In the Hostname section, you can assign a different server hostname.

  3. In the Web Interface section, you can enable access to the web user interface over either HTTP or HTTPS. You can also restrict the IP address where the UI is hosted. It defaults to all IP adresses (denoted with an asterisk). You can also change the display language of the UI to either en for English or fr for French.

  4. In the SNMP section, enable Simple Network Management Protocol (SNMP) to allow an SNMP management server to collect device data from this HAProxy ALOHA instance.

    • Check the Enable SNMP box.

    • Set the IP address and port on which HAProxy ALOHA should accept SNMP requests. You can also set this to an asterisk to listen on all IP addresses assigned to the server.

    • For Network, enter a subnetwork to restrict the IP addresses from which SNMP requests are allowed to originate. Set this to a network prefix and CIDR, such as

    • For Community, enter a community string. This serves as a shared password that the SNMP management server must send with its request.

  5. Click Next to go to the next step.

Display the summary

This last step in the configuration wizard summarizes the completed steps and allows you to apply them.

Click Apply to install the configuration.

Next up

Firmware Updates