HAProxy ALOHA Documentation 14.0

Additional Modules Partition

You can install additional packages, such as the Data Plane API and the WAF, on the virtual appliance or the HAProxy ALOHA 5300 and newer hardware appliances. However, on the virtual appliance, these features require that you mount an additional disk partition to store their files.

Prerequisites

To use additional packages on virtual appliances, you must:

  • Allocate at least 6 GB of RAM to each of your HAProxy ALOHA virtual appliances. This number comes from benchmarking memory usage of the additional packages while taking into account the RAM needed to run other services on the system. Note that insufficient memory may cause HAProxy ALOHA to reboot due to a watchdog process that monitors memory.

  • Attach a new disk to your HAProxy ALOHA virtual appliances.

The sections below will guide you through attaching a new disk under a VMware® vSphere® hypervisor. Please see your hypervisor documentation if you use another hypervisor.

VMWare vSphere: Attach a new disk

You need to attach to HAProxy ALOHA virtual appliance a new hard drive that will store additional modules.

  1. Log in to your VMware® vSphere® Client, then power off your HAProxy ALOHA Virtual Appliance.

  2. Select Actions > Edit Setting.

    https://cdn.haproxy.com/documentation/aloha/latest/assets/vsphere-aloha1-2e8c5cd013884154ebefadf34f7e03e2c80c2b39bc6552294a78d544768f762e.png

    The Virtual Hardware tab displays.

  3. Select Add New Device > Hard Disk.

  4. Create a new 30 GB or larger disk in the New Hard Disk field.

  5. Power on your HAProxy ALOHA Virtual Appliance.

Mount a new partition

You need to edit the HAProxy ALOHA configuration so that the new /dev/sdb1 partition is mounted on the /app mountpoint at startup.

  1. Log in to your HAProxy ALOHA web UI as an administrator.

    For example, log in to http://172.16.24.237:4444/.

    https://cdn.haproxy.com/documentation/aloha/latest/assets/aloha-wui-c7da4f5b31a2c882b364b57515e932bb7ab0825be1492468083e9c259821b221.png
  2. Select the Tools tab, then edit the file /etc/config.rc through the File Manager.

    https://cdn.haproxy.com/documentation/aloha/latest/assets/aloha-wui-config-rc-02d80ed1a0e859267a467cb76250390af202ad36bb53a15de76958e4ebc393f0.png

    Add the following directives at the end of the service system section, then click Save:

    Directive

    Action

    app_auto_mount

    Automatically mounts the partition on /app.

    app_auto_format

    Automatically formats the /app partition, if needed.

    app_device_size <Size in bytes>

    Specify the size in bytes of the /app partition.

    For example: app_device_size 30000000000.

  3. Select the Setup tab, then save your modifications.

    https://cdn.haproxy.com/documentation/aloha/latest/assets/aloha-wui-config-save-b44324f486725737fac81297931eaba33ced548168872be7993cbebbdee9172b.png
  4. Restart HAProxy ALOHA.


Next up

Administration