Installation

Hardware appliance

The HAProxy ALOHA hardware appliance ships as a rack mount server. First, you must connect HAProxy ALOHA appliance to your network, after which you can complete other configuration tasks using the web user interface.

Package contents Jump to heading

All HAProxy ALOHA load balancer packages contain the following items:

  • The HAProxy ALOHA appliance.
  • A European or US electric cable.
  • A serial cable to connect to the console.

Connect the appliance to your network Jump to heading

You can connect to HAProxy ALOHA using either:

  • an RJ45 ethernet cable.
  • an RJ45-to-serial console cable.

Connect using an ethernet cable Jump to heading

For this method, you need:

  • A desktop or laptop computer with an ethernet port.
  • An ethernet cable (both straight or crossover are allowed).

By default, HAProxy ALOHA configures eth0 with the IP address: 192.168.0.200/24.

  1. Turn on HAProxy ALOHA.

  2. Plug the ethernet cable into the HAProxy ALOHA eth0 port. Connect the other end to your computer’s network port.

  3. Configure the network adapter on your computer with the static IP address 192.168.0.1/24.

  4. Browse to HAProxy ALOHA web user interface at http://192.168.0.200:4444.

    Use the default credentials admin / admin to log in.

  5. Run the initial configuration wizard.

Connect using a console cable Jump to heading

For this method, you need:

  • A desktop or laptop computer with a serial port.
  • An RJ45-to-serial console cable (provided).
  1. Turn on HAProxy ALOHA.

  2. Plug the RJ45 connector end of the console cable into the HAProxy ALOHA console port. Connect the serial connector end to your computer’s serial port.

  3. Start Minicom:

    nix
    minicom -s
    nix
    minicom -s

    Configure it to 115200 8N1, hardware flow control.

  4. Press enter until a login prompt appears.

  5. Use the default credentials admin / admin to log in.

  6. Get root access by typing the command root.

  7. Run the following commands, replacing the uppercase keyword with your own settings:

    • Set the system hostname:

      nix
      config set system hostname <HOSTNAME>
      nix
      config set system hostname <HOSTNAME>
    • Set a static IP address for the eth0 network interface:

      nix
      config set network.eth0 ip-address <IP/NETMASK>
      nix
      config set network.eth0 ip-address <IP/NETMASK>
    • Set the default gateway:

      nix
      config set network.eth0 ip-route-default <GATEWAY>
      nix
      config set network.eth0 ip-route-default <GATEWAY>
    • Apply your configuration:

      nix
      service network restart
      nix
      service network restart
    • Connect HAProxy ALOHA to your network using the eth0 network port.

    • Try to ping HAProxy ALOHA using the IP address you configured. If the ping is successful, save the configuration:

      nix
      config save
      nix
      config save
  8. Browse to HAProxy ALOHA web user interface at http://<HAProxy ALOHA IP>:4444.

    Use the default credentials admin / admin to log in.

  9. Run the initial configuration wizard.

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