HAProxy Enterprise Documentation 13.0

Virtual Appliance

The HAProxy ALOHA virtual appliance is distributed as a virtual machine image, which has been verified to work with the following hypervisors:

  • Citrix XenServer

  • Kernel-based Virtual Machine (KVM)

  • Microsoft Hyper-V

  • VMware vSphere

  • VMware Workstation Player

Install the ALOHA virtual appliance

Follow these steps to install HAProxy ALOHA for your chosen hypervisor.

Citrix XenServer

  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/13.0/va-installer. Enter your credentials to access the folder.

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

  4. Open XenCenter Client and connect to your Citrix XenServer

  5. Create a new virtual machine:

    1. Click File > Import.

    2. Browse to the file aloha-albva.xva.

    3. Complete the wizard to import the virtual machine.

Kernel-based Virtual Machine (KVM)

  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/13.0/va-installer. Enter your credentials to access the folder.

  3. Download the file aloha-albva-kvm.tgz and extract its contents.

  4. Be sure that you have installed the qemu-kvm and virt-manager system packages.

  5. Open Virtual Machine Manager (virt-manager) and create a new virtual machine:

    1. Click File > New Virtual Machine.

    2. Select Import existing disk image.

    3. For the storage volume, choose Browse local and then browse to the file aloha-albva.img.

    4. Set the operating system to Generic default.

    5. Complete the wizard to import the virtual machine.

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/13.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:

    1. Click New > Virtual Machine from the Actions menu.

    2. On the Connect Virtual Hard Disk screen, choose Use an existing virtual hard disk, and browse to the file aloha-albva.vhd.

    3. 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.

VMware VSphere

  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/13.0/va-installer. Enter your credentials to access the folder.

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

  4. Open vCenter (such as via the vSphere Client) and create a new virtual machine:

    1. Right click on your datacenter and choose Deploy OVF Template.

    2. Choose Local file and then upload the files aloha-albva.ovf and aloha-albva-disk1.vmdk.

    3. Complete the wizard to import the virtual machine.

VMware Workstation Player

  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/13.0/va-installer. Enter your credentials to access the folder.

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

  4. Open VMware Workstation Player and create a new virtual machine:

    1. Choose Player > File > Open and browse to the file aloha-albva.vmx.

    2. Once the virtual machine has been created, click Edit virtual machine settings.

    3. Under Network Adapter, change Network connection to Host-only so that you can access the VM.

    4. Exit the Virtual Machine Settings window and click Play virtual machine.

Log in to the appliance

To log in to the HAProxy ALOHA's command-line terminal, connect to the virtual machine and log in with the username and password admin.

https://cdn.haproxy.com/documentation/aloha/latest/assets/aloha-cli-login-b825fd30aecfb5e81d9db3b7d22cfc3a3a31cb82e2b9c83409dbff1d994bb117.png

At this point, you can change the admin user's password by typing passwd, which prompts you to enter a new password.

To log in to the HAProxy ALOHA's web user interface, 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.

https://cdn.haproxy.com/documentation/aloha/latest/assets/aloha-ui-login-6d406b470d740d5dbc0171afd5145b39062f92c9064660d84daff97bd8297caa.png

Once logged in, run the initial configuration wizard.


Next up

Initial Configuration