HAProxy Enterprise Documentation 12.5

IP Addresses / DHCP

DHCP configuration

You can perform the first network configuration of an ALOHA Virtual Appliance either manually or by Dynamic Host Configuration Protocol (DHCP).

DHCP enables a server to assign automatically an IP address to a computer from a defined range of numbers (i.e. a scope) configured for a given network.

The diagram below shows the booting process and the different ways of configuration applicable.

https://cdn.haproxy.com/documentation/aloha/12-5/assets/config_diagram-478e572c2496bdca64bd291a9097c04bc4fb9c7ab6b65653c2096e1784d2eaa3.png

Default network configuration

Note

This is the default mode, when there is no DHCP server on the network

The ALOHA's default IP address configured on eth0 is 192.168.0.200.

The first prompt looks like this:

https://cdn.haproxy.com/documentation/aloha/12-5/assets/first_boot_prompt-89eee470dbc600d21acf45d21e877a8ba1279f9ff7039c1bf9315940ab73f4bd.png

As shown above, the Web User Interface (WUI) is available on the URL http://192.168.0.200:4444/.

Open a browser and point to that URL to get access to the WUI.

Note

If you cannot reach the ALOHA Load-Balancer IP address from your machine, see Manual Network Configuration.

Network configuration using DHCP

When the ALOHA can reach a DHCP server, it uses it to get its network configuration. The first prompt looks like this:

https://cdn.haproxy.com/documentation/aloha/12-5/assets/ip_from_dhcp-c0297fe206ee7e4c8fbcb2ad7be8e222868de26a77b24173ea7583952ecb5673.png

As shown above, the Web User Interface (WUI) is available on the URL http://10.0.4.146:4444/.

Note

This may be different in your environment.

Network configuration using console wizard

During the boot phase, when the prompt below appears.

You have 10 seconds to choose between DHCP (type D) or static (type s) configuration.

Use the console wizard

  1. Type s to configure a static IP.

    The appliance asks for the following:

    https://cdn.haproxy.com/documentation/aloha/12-5/assets/boot_prompt_first_ip-b54d5a0e6b50c0285c2ba501108eb4c1d0242eaff47faefd43bdaf710e1f989c.png
    • The IP address you want to configure on the appliance

    • The subnet

    • The appliance's default gateway

    The image below shows an example of configuration:

    https://cdn.haproxy.com/documentation/aloha/12-5/assets/boot_static_ip-de7c726cc67dad479450019265bd20f8eda3a835d0773c7bf2ef01214c132551.png
  2. Type y to validate your configuration.

You can now access the ALOHA's WUI at the address https://10.0.0.17:4444/.

Manual network configuration

To update manually the ALOHA's default IP configuration, you connect to the console using the default credentials (admin/admin).

  1. Get root access by running the command root.

  2. Type the commands below:

    • Set up the device hostname: config set system hostname <HOSTNAME>

    • Set up the ip address for eth0: config set network.eth0 ip-address <IP/NETMASK>

    • Setup the default gateway: config set network.eth0 ip-route-default <GATEWAY>

    • Apply your configuration: service network restart

    • Plug the Aloha's eth0 network interface.

    • Try to ping the ALOHA.

    • If ping is successful, then save the configuration: config save

Automatic network configuration using VMWare OVF properties

Open Virtualization Format (OVF) is an open-source standard for packaging and distributing software applications for virtual machines (VM).

In ALOHA, you can use OVF properties in VMWare to set parameters on your virtual machine and have them apply automatically on boot.

To use this feature, you must use VMWare ESX version >= 5.5 and ALOHA version >= 11.0.

You can define the following OVF properties using the VMWare user interface or the command line:

  • hostname

  • admin_password

  • vami.ip0.aloha

  • vami.netmask0.aloha

  • vami.gateway.aloha

  • vami.DNS.aloha

Define OVF properties in VMWare UI

  1. In VMWare, create a new virtual machine:

    https://cdn.haproxy.com/documentation/aloha/12-5/assets/1_create_new_vm-c6bc22ac295840398ed06163ff4edb9cea9f89f59a0d416084885505dbdc22dc.png
  2. Go to the "Additional Settings" window and specify the properties for your virtual machine:

    https://cdn.haproxy.com/documentation/aloha/12-5/assets/2_additional_settings-2656393b95c27f4382e020b990c12e57c436d64e3bf75fda62a6310f424a092d.png
  3. Click "Finish" to apply the properties at boot.

Define OVF properties using the command line

  1. Define your OVF properties using the command line with your network information, as follows:

    $ sudo ovftool --overwrite --name=ALOHA11  --network="VM Network"
    --X:logLevel=verbose    --X:injectOvfEnv  --powerOn
    --prop:vami.ip0.aloha=<IP> --prop:vami.netmask0.aloha=<NETMASK>
    --prop:vami.gateway.<GW> --prop:vami.DNS.aloha=<DNS> aloha-albva.ovf   vi://USER:PASS@ESX_SERVER
  2. On boot, ALOHA displays the parameters that you set using OVF properties. It then waits about 5 seconds for your confirmation to save the configuration.

    https://cdn.haproxy.com/documentation/aloha/12-5/assets/3_aloha_boot_ovf_props-57639bd512a07abbbf4026c3bfb239f5a8b0253f5c2daed58cbd53427458d894.png

Manually configure IP addresses

IP addresses

Set up IP addresses

Note

  • This IP address is a local address.

  • This procedure should be applied to both members of a cluster, with a different IP for each one.

  1. Browse the ALOHA WUI.

  2. Open the Services tab.

  3. Click Setup setup_icon on the line corresponding to the network interface you want to manage.

  4. Add, remove, or edit the IP address directive using the syntax below:

    ip address <ip/mask>
    service network eth0
    ip address 192.168.1.11/24
  5. Click OK.

  6. Click Close.

  7. The line corresponding to the Network Interface now appears in orange with the flag Need apply.

    https://cdn.haproxy.com/documentation/aloha/12-5/assets/interface_need_apply-d3eb8e065aa75e5f84a096bbab4f8da49b8cf7ab6f169115a7d365652664dc88.png
  8. Click Reload.

In case of a problem:

  • Check for duplicate IPs

Set up IP aliases

You set up IP aliases in the same way as IP addresses.

When you add an IP alias, we recommend that you use a /32 subnet.

Static routes

Static routing is when a router uses a manually-configured routing entry instead of information from a dynamic routing traffic. Static routes are manually configured by adding in entries into a routing table. Unlike dynamic routing, static routes are fixed and do not change if the network is changed or reconfigured.

Add static routes

  1. Browse the ALOHA WUI.

  2. Open the Services tab.

  3. Click Setup setup_icon on the line corresponding to the network interface you want to manage.

  4. Add, remove, or edit the IP route directive using the syntax below:

    ip route <ip/mask> <gw>
    service network eth0
      ip address 192.168.1.11/24
      ip route default 192.168.1.1
      ip route 10.0.0.0/24 192.168.1.2
      ip route 172.16.0.0/24 192.168.1.2
  5. Click OK.

  6. Click Close.

  7. The line corresponding to the Network Interface now appears in orange with the flag Need apply.

    https://cdn.haproxy.com/documentation/aloha/12-5/assets/interface_need_apply-d3eb8e065aa75e5f84a096bbab4f8da49b8cf7ab6f169115a7d365652664dc88.png
  8. Click Reload reload_icon.

In case of a problem:

  • Try to ping the gateway

  • Check the ALOHA routing table

Troubleshooting

Duplicated IPs

To troubleshoot duplicated IPs, you can use the ARP who-has diagnostic tool.

This tool checks if the MAC address associated with the IP address is the one expected or not:

  • If yes, the problem may be on an upper layer

  • If not, the MAC address of the server has the duplicated IP

Ping

You can use the ping diagnostic tool to try to reach an IP address on the network.