Firmware Updates

Install the firmware in the UI

If you run two HAProxy ALOHA instances in active-standby mode, then updating one at a time is preferable to avoid downtime. Start with the standby instance, then once completed switch it into active mode so that you can update the current active instance.

To update the standby instance:

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

2. Click Update.

3. Click Reboot.

4. Promote the standby instance to be the active instance:

   1. From the Services tab, click the Setup icon on the network service line.

   2. Update the vrrp prio number to be greater than the current primary instance's value. This will configure the VRRP group so that the system with the higher priority number will become the new primary instance, avoiding network disruptions during the firmware update process.

   3. Click OK then Close.

      The standby becomes the new active instance and handles the traffic. We recommend monitoring HAProxy 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.

To update the other HAProxy ALOHA instance:

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

2. Click Update.

3. Click Reboot.

4. If you are running two HAProxy ALOHA instances, you can change the original standby instance to be on standby again:

   1. On the standby instance, go to the Services tab, click the Setup icon on the network service line.

   2. Lower the vrrp prio number to the value before the update.

   3. Click OK then Close.

Install the firmware in the CLI

If you run two HAProxy ALOHA instances in active-standby mode, then updating one at a time is preferable to avoid downtime. Start with the standby instance, then once completed switch it into active mode so that you can update the current active instance.

1. Once you have downloaded the updated firmware as outlined above, copy it to /tmp using scp:

   $ scp firmware-file.bin admin@ALOHA_IP:/tmp

2. Type sudo su to complete the steps as root user:

   $ admin@ALOHA1:~$ sudo su

3. In the file /etc/config.rc update the vrrp prio number to be greater than the current primary instance's value. For example:

   service network eth0
      ######### Interface eth0
      ip autoconfig
      ip address 192.168.0.200/255.255.255.0
      ip route default 192.168.0.1
      vrrp inst default prio 100

4. Apply changes:

   $ bash-3.00# service network restart

5. Install the firmware using update-boot-image; replace firmware-file.bin with the name of the file:

   $ bash-3.00# update-boot-image /tmp/firmware-file.bin

6. Ensure the changes are saved:

   $ bash-3.00# config save

7. The standby becomes the new active instance and handles the traffic. We recommend monitoring HAProxy 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.

8. To update the other (now standby) instance, repeat the same steps.

9. Once done, you can change the original standby instance to be on standby again by editing the /etc/config.rc file and lowering the vrrp prio number to the value before the update.