HAProxy Enterprise Documentation 13.0

Initial Configuration

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

Warning

Running the wizard will erase all previous network settings you have already saved.

Launch the wizard

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

https://cdn.haproxy.com/documentation/aloha/latest/assets/wizard-tab-fddaa737001392f61b395c88fde49a1181f89a443ef810c7414b43d2e33223a9.png

Configure physical interfaces

Use the Physical interfaces screen to configure the ALOHA's 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.

https://cdn.haproxy.com/documentation/aloha/latest/assets/config-wiz-step1-165c53ad10250106544eaf45931127a5ee1e50979d9ccaadde2032622f90dc92.png

Note

The number of interfaces may vary with the appliance model or the number of virtual network interfaces configured in a virtual appliance.

Configure membership in a VLAN

Use the VLANs configuration screen to join the 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:

    https://cdn.haproxy.com/documentation/aloha/latest/assets/config-wiz-step3-f2e74cb4febfa0398c57567ee9cf37e5f39bb185711179dc114f5bbea0519ff9.png
  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 the ALOHA. This step is mandatory and you must add at least one address, even if it is only an address used to reach the ALOHA's web user interface. In the case of the virtual appliance, you can use this to replace the dynamically assigned address that the 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:

    https://cdn.haproxy.com/documentation/aloha/latest/assets/config-wiz-step4-605fc3b6b42b6f229d68d47d3cffab51c479c71b040da4fb686910b5d27af32d.png
  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 the 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. 192.168.1.0/24

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

    • 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:

    https://cdn.haproxy.com/documentation/aloha/latest/assets/config-wiz-step5-02648b79582cc4fbc49d6977e0fe2e05beb59cd2b6af3a47ec80fbd207aff07b.png
  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 ALOHA instances and create virtual IP addresses (VIPs) for your application services. If the primary ALOHA loses connectivity, the VIP will automatically migrate to the standby 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 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 ALOHA instance in order to pair them.

    Note

    This ID must be unique on your network.

  4. The Priority sets whether this 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.

    https://cdn.haproxy.com/documentation/aloha/latest/assets/config-wiz-step6-1c604b7db0fbaf36a47b062909d33a601410b83a372799c12a0f747f466c433c.png

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

  1. Choose the 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 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 the 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.

    Note

    The protocol and the port for the web UI must be the same for both ALOHA instances in a cluster.

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

    • Check the Enable SNMP box.

    • Set the IP address and port on which the 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 192.168.1.0/24.

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

    https://cdn.haproxy.com/documentation/aloha/latest/assets/config-wiz-step7-867f088f323ba4ea5b9ffff8515787a899a60773b143ce2a0abf410fd17126bb.png
  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

License Registration