HAProxy Enterprise Documentation 10.5

VMware VSphere

Follow these steps to install HAProxy ALOHA on 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/10.5/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.

Assign an IP address

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

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:

    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:

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

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

Assign a static IP address

  1. Start your appliance.

    The following message displays:

    Retrieve IP using DHCP or configure static ... 10sec (D/s)?
  2. Enter s to enter a static IP address.

    Note

    When no DHCP server is available, this is the default mode.

    The following message displays:

    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:

    Use netmask (255.255.255.0)?
  4. Enter the netmask you want to assign to the appliance.

    The following message displays:

    Use default gateway (192.186.0.1)?
  5. [Optional] Enter the IP address of the appliance's default gateway.

    The following message displays:

    Commit and save this configuration (N/y)?
  6. To save your configuration, enter y.

    The web UI's URL displays, for example:

    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

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.

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

Once logged in, run the initial configuration wizard.

OVF properties

Open Virtualization Format (OVF) is an open-source standard for packaging and distributing software applications for virtual machines (VM). In HAProxy ALOHA, you can use OVF properties in VMWare to set parameters on your virtual machine and have them apply automatically on boot. You can define the following OVF properties using the VMWare user interface or the command line:

OVF property

Description

Example

hostname

Hostname

MYALOHA

admin_password

Administrator's password

Stc1fl15oGv4

vami.ip0.aloha

IP address

192.168.0.200

vami.netmask0.aloha

Netmask

255.255.255.0

vami.gateway.aloha

Gateway

192.168.0.1

vami.DNS.aloha

DNS domain

8.8.8.8

Prerequisites

  • VMWare ESX version 5.5 or higher

  • HAProxy ALOHA version 11.0 or higher

Define OVF properties in the VMWare UI

  1. Extract aloha-albva.ovf and aloha-albva-disk1.vmdk from the aloha-albva-vsphere.zip archive you were provided by HAProxy Technologies.

  2. Log in to VMWare ESXi.

  3. Create a new virtual machine.

    https://cdn.haproxy.com/documentation/aloha/10-5/assets/0_create_new_vm-ada19440ef92fee28e57b6bb0d67c12b3c9762d2ffea052afbd1a7700d1515fa.png
  4. Enter the name of your appliance, and select aloha-albva.ovf and aloha-albva-disk1.vmdk.

    https://cdn.haproxy.com/documentation/aloha/10-5/assets/1_create_new_vm-3c6e82083b7f12f37504bb0eb580ed110088d4885ee07014d39476ac984d4078.png
  5. Specify the additional settings of your appliance.

    https://cdn.haproxy.com/documentation/aloha/10-5/assets/2_additional_settings-9b453f35489daaec0b4149d614324bcbc02fbf0f014a5b7565628ab6799e5026.png
  6. Deploy your virtual appliance.

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=<hostname> \
    --network="<network name>" --X:logLevel=verbose --X:injectOvfEnv  --powerOn \
    --prop:vami.ip0.aloha=<IP address> --prop:vami.netmask0.aloha=<subnet mask> \
    --prop:vami.gateway.<Gateway IP address> \
    aloha-albva.ovf vi://<username>:<password>\!@<VMware ESXi IP address>
    $ sudo ovftool --overwrite --name=MYALOHA --network="VM Network" \
    --X:logLevel=verbose --X:injectOvfEnv --powerOn \
    --prop:vami.ip0.aloha=192.168.0.200 --prop:vami.netmask0.aloha=255.255.255.0 \
    --prop:vami.gateway.192.168.0.1 aloha-albva.ovf vi://jdoe:Stc1fl15oGv4\!@10.10.1.24

    Note

    You may have to specify a datastore, for example: sudo ovftool --datastore=datastore0 [...].

  2. Log in to your VMware ESXi™ account.

    Your virtual appliance is up and running.

    https://cdn.haproxy.com/documentation/aloha/10-5/assets/define-ovf-properties-using-the-command-line-619fb489ce58f23dbd0b763b7129054d0a6a88a1651ae8dbd612dc6c9eca9abf.png

See also


Next up

VMware Workstation Player