HAProxy Enterprise Documentation 12.5

Firmware Updates

In this section, you will learn how to check which version of the firmware you currently have and how to download and install a newer version.

Check your current firmware version

To obtain the current version of the firmware that you have installed:

  1. In the ALOHA web user interface, go to the Setup tab.

  2. Find the firmware version number in the System section, where it is labelled Version.

    https://cdn.haproxy.com/documentation/aloha/12-5/assets/aloha-firmware-version-c53901ab5be5b3686d2c1c065ed8b0f6d79524956a6677aff2dcc3b8f5ab5bb8.png

Alternatively:

  1. Log in to the ALOHA command-line interface.

  2. Read the file /usr/share/factory/version to see the Version.

    $ cat /usr/share/factory/version
    
    Product: aloha
    Model: albva
    Branch: 13.0
    Version: 13.0.4
    Build: 1312
    Date: 2021-05-17 08:32:31
    URL: http://www.haproxy.com/download/aloha/13.0

Install the latest firmware

Follow these steps to install the latest version of the firmware.

Note

The ALOHA firmware version number is comprised of three digits separated by dots.

<major version> . <minor version> . <patch version>

Major and minor versions include new features and bug fixes, while patch versions include only bug fixes.

  1. Obtain your credentials for accessing the HAProxy ALOHA downloads. You can create a new support ticket in the HAProxy Technologies Customer Portal to request your credentials.

  2. Browse to the website https://www.haproxy.com/download/aloha/12.5. Enter your credentials to access the folder.

  3. Go into the folder with the highest number. (e.g. 13.0.5)

  4. Download the file for your appliance model.

    • For the virtual appliance, the file is prefixed with albva (e.g. albva-13.0.5-1312.bin).

    • For the hardware appliance, the file is prefixed with the hardware model (e.g. alb5200-13.0.5-1312.bin for the ALB5200 model).

  5. If you run two ALOHA instances in active-standby mode, then update the standby instance first:

    • On the active instance, ensure that your current load balancer configuration has been synced to the standby instance. Then save the configuration by going to the Setup tab and clicking Save in the Configuration section.

    • On the standby instance, go to the Setup tab and in the Firmware section click Browse to upload the .bin file.

    • Click Update and then Reboot.

    • If everything looks normal, promote the standby instance to be the primary, active instance by increasing its VRRP weight.

      • From the Services tab, click the setup-icon Setup icon on the network service line.

      • Update the vrrp prio number to be greater than the current primary instance's value.

      • The standby becomes the new primary and handles the traffic.

      • We recommend monitoring the ALOHA until you are confident that it is functioning correctly.

        You can still swap the active and standby back by lowering the instance's vrrp prio number to its original value. You can also revert by following the steps in the Roll back section below.

  6. Update the other ALOHA instance.

    • Go to the Setup tab and, in the Firmware section, click Browse to upload the .bin file.

    • Click Update and then Reboot.

    • If you are running two ALOHA instances, you can change the original standby node to be on standby again. On the standby instance, go to the Services tab, click the setup-icon Setup icon on the network service line. Lower the vrrp prio number to the value before the upgrade.

At this stage, your ALOHA instances have been updated to the new firmware. During this update, the load balancer configuration may have been migrated to use new keywords if older keywords were obsoleted. If you go to the Setup tab and click Save in the Configuration section, then the new configuration is made permanent. You can still roll back to the previous firmware, but the configuration will not be reverted. In rare cases, the new configuration may be incompatible with the older firmware.

Roll back an update

Note

A rollback will not revert the load balancer configuration if you have saved it on the Setup tab. In rare cases, it may be incompatible with the older firmware.

By default, the ALOHA stores two firmware images:

  • the current running firmware

  • the firmware that was running before the last upgrade

Follow these steps to revert to the firmware that was running before the last upgrade:

  1. On the Setup tab, and scroll down to the Firmware area.

  2. Look at the Next boot image radio buttons. The box checked indicates the currently running firmware.

  3. Check the other box pointing to the old image.

  4. Click Update and then Reboot.


Next up

Administration