Virtual appliance

Install HAProxy ALOHA on Microsoft Hyper-V

This section describes how to install the virtual appliance on Microsoft Hyper-V.

Install the virtual appliance on Microsoft Hyper-V Jump to heading

Follow these steps to install HAProxy ALOHA on Microsoft Hyper-V.

  1. From the HAProxy Technologies Customer Portal, create a new support ticket to request your download credentials.

  2. Browse to the URL https://www.haproxy.com/download/aloha/16.0/va-installer. Enter your credentials to access the folder.

  3. Download the file aloha-albva-hyperv.zip and extract its contents.

  4. Open Hyper-V Manager and create a new virtual machine:

    • Click New > Virtual Machine from the Actions menu.
    • On the Connect Virtual Hard Disk screen, choose Use an existing virtual hard disk, and browse to the file aloha-albva.vhd.
    • Complete the wizard to import the virtual machine.
  5. The virtual machine is created, but not yet running. Right click it and select Settings. Under Network Adapter, set Virtual Switch to Default Switch and then apply the change.

  6. Right click the virtual machine and choose Start.

Assign an IP address Jump to heading

You must assign an IP address belonging to the internal network to your HAProxy ALOHA appliance. Although you have the option of using DHCP to assign an IP address dynamically, which is useful for connecting to the HAProxy ALOHA for the first time before you’ve set up a static IP, it is typical to prefer a static IP, since you will want HAProxy ALOHA to have a predictable address on your network.

When starting your appliance for the first time, you can either:

  • use DHCP to assign an IP address dynamically, then assign a static address either through the web user interface or the CLI, or
  • assign a static address to the appliance immediately.

Once you have assigned an IP address, you can then connect to the HAProxy ALOHA web UI and change IP address assignments using the graphical interface.

Use DHCP Jump to heading

By default, DHCP automatically assigns an IP address to your HAProxy ALOHA virtual appliance at first boot.

  1. Start your virtual appliance. The following message displays:

    text
    Retrieve IP using DHCP or configure static ... 10sec (D/s)?
    text
    Retrieve IP using DHCP or configure static ... 10sec (D/s)?
  2. Enter D for DHCP or wait for 10 seconds. The web UI’s URL displays, for example:

    text
    Access WEB User Interface: http://192.168.1.71:4444
    text
    Access WEB User Interface: http://192.168.1.71:4444

Later, you should assign a static IP address to the appliance.

Save the changed configuration by executing config save in the CLI.

Assign a static IP address Jump to heading

  1. Start your appliance. The following message displays:

    text
    Retrieve IP using DHCP or configure static ... 10sec (D/s)?
    text
    Retrieve IP using DHCP or configure static ... 10sec (D/s)?
  2. Enter s to enter a static IP address. When no DHCP server is available, this is the default mode. The following message displays:

    text
    Configure IP manually
    Use IP address (192.186.0.200)?
    text
    Configure IP manually
    Use IP address (192.186.0.200)?
  3. Enter the IP address you want to assign to the appliance. The following message displays:

    text
    Use netmask (255.255.255.0)?
    text
    Use netmask (255.255.255.0)?
  4. Enter the netmask you want to assign to the appliance. The following message displays:

    text
    Use default gateway (192.186.0.1)?
    text
    Use default gateway (192.186.0.1)?
  5. Optional: Enter the IP address of the appliance’s default gateway. The following message displays:

    text
    Commit and save this configuration (N/y)?
    text
    Commit and save this configuration (N/y)?
  6. To save your configuration, enter y. The web UI’s URL displays, for example:

    text
    Access WEB User Interface: http://192.168.0.200:4444
    text
    Access WEB User Interface: http://192.168.0.200:4444

You can now access the HAProxy ALOHA web UI at the address http://<IP Address>:4444/.

Log in to the web user interface Jump to heading

Copy the Access WEB User Interface address that’s displayed when you connect to the command-line terminal. This takes you to a login screen.

To log in, use the username and password admin.

Once logged in, run the initial configuration wizard.

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