Upgrade

Upgrade HAProxy Enterprise on Linux

You can upgrade HAProxy Enterprise to version 2.8r1 on the following operating systems:

HAProxy Enterprise version Release date End of life Supported OS
2.8r1 Oct 2023 Feb 2028
  • AlmaLinux 8, 9
  • Debian 11, 12
  • Oracle 8, 9
  • Photon OS 3.0
  • RHEL 8, 9
  • Rocky Linux 8, 9
  • SUSE 15.5
  • Ubuntu 20.04, 22.04

Upgrade to HAProxy Enterprise 2.8r1 Jump to heading

The following upgrade procedure installs a new major version of HAProxy Enterprise.

  1. Take the server that you want to upgrade out of the cluster.

  2. Install HAProxy Enterprise 2.8r1 by running the following command and replacing <HAProxy Enterprise Key> with the key you received when you registered:

    bash
    wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
    sudo bash ./install_haproxy_enterprise.sh \
    --version 2.8r1 \
    --key <HAProxy Enterprise key>
    bash
    wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
    sudo bash ./install_haproxy_enterprise.sh \
    --version 2.8r1 \
    --key <HAProxy Enterprise key>
  3. Update additional modules: you may be running additional modules with HAProxy Enterprise, which you must also reinstall when you upgrade to a new release. Install a package using its name, for example:

    bash
    sudo apt-get install hapee-2.8r1-lb-update
    bash
    sudo apt-get install hapee-2.8r1-lb-update
    bash
    sudo yum install hapee-2.8r1-lb-update
    bash
    sudo yum install hapee-2.8r1-lb-update
    bash
    sudo zypper install hapee-2.8r1-lb-update
    bash
    sudo zypper install hapee-2.8r1-lb-update
    bash
    sudo pkg install hapee-2.8r1-lb-update
    bash
    sudo pkg install hapee-2.8r1-lb-update
  4. Copy /etc/hapee-<PREVIOUS VERSION>/hapee-lb.cfg over to /etc/hapee-2.8/hapee-lb.cfg and any associated files (maps, certificates, etc).

  5. Optionally, you might want to validate your configuration against the new load balancer before disabling the old load balancer. Use the -c option to check the configuration.

    bash
    /opt/hapee-2.8/sbin/hapee-lb -c -f /etc/hapee-2.8/hapee-lb.cfg
    bash
    /opt/hapee-2.8/sbin/hapee-lb -c -f /etc/hapee-2.8/hapee-lb.cfg
    output
    bash
    Configuration file is valid
    output
    bash
    Configuration file is valid

    Multiple configuration files

    If you have multiple configuration files in your application, be sure to check them all in the correct order.

  6. Disable the old HAProxy Enterprise version from starting with the system, as follows:

    bash
    sudo systemctl disable hapee-<PREVIOUS VERSION>-lb
    bash
    sudo systemctl disable hapee-<PREVIOUS VERSION>-lb
  7. Ensure that the new HAProxy Enterprise version starts with the system, as follows:

    bash
    sudo systemctl enable hapee-2.8-lb
    bash
    sudo systemctl enable hapee-2.8-lb
  8. Stop the old HAProxy Enterprise daemon and start the new daemon:

    bash
    sudo systemctl stop hapee-<PREVIOUS VERSION>-lb
    sudo systemctl start hapee-2.8-lb
    bash
    sudo systemctl stop hapee-<PREVIOUS VERSION>-lb
    sudo systemctl start hapee-2.8-lb
  9. Run tail -f /var/log/syslog (or distribution equivalent) to check for warnings or errors.

  10. Run curl localhost to ensure that HAProxy Enterprise is responding. Adjust address/port as needed, and use a local address that is currently active on the box and not a VRRP IP.

  11. Put the upgraded server back into the cluster.

  12. Repeat this procedure on secondary servers.

Post-upgrade Jump to heading

After you upgrade, see the section on enterprise modules on how to enable and configure each one.

After the new HAProxy Enterprise version has been running for a while, you can uninstall the old HAProxy Enterprise version. To uninstall a package:

bash
sudo apt purge hapee-<PREVIOUS VERSION>-lb
sudo rm /etc/rsyslog.d/<PREVIOUS VERSION>.conf
sudo systemctl restart rsyslog
bash
sudo apt purge hapee-<PREVIOUS VERSION>-lb
sudo rm /etc/rsyslog.d/<PREVIOUS VERSION>.conf
sudo systemctl restart rsyslog
bash
sudo apt purge hapee-<PREVIOUS VERSION>-lb
sudo rm /etc/rsyslog.d/<PREVIOUS VERSION>.conf
sudo systemctl restart rsyslog
bash
sudo apt purge hapee-<PREVIOUS VERSION>-lb
sudo rm /etc/rsyslog.d/<PREVIOUS VERSION>.conf
sudo systemctl restart rsyslog
bash
sudo yum remove hapee-<PREVIOUS VERSION>-lb
sudo rm /etc/rsyslog.d/<PREVIOUS VERSION>.conf
sudo systemctl restart rsyslog
bash
sudo yum remove hapee-<PREVIOUS VERSION>-lb
sudo rm /etc/rsyslog.d/<PREVIOUS VERSION>.conf
sudo systemctl restart rsyslog
bash
sudo zypper remove hapee-<PREVIOUS VERSION>-lb
bash
sudo zypper remove hapee-<PREVIOUS VERSION>-lb

Update HAProxy Enterprise Jump to heading

The update procedure installs the latest build for your current HAProxy Enterprise version in order to benefit from the latest bug fixes.

  1. Optional: Save the current load balancer configuration as a backup.

    bash
    sudo cp /etc/hapee-2.8/hapee-lb.cfg /etc/hapee-2.8/hapee-lb.cfg.current
    bash
    sudo cp /etc/hapee-2.8/hapee-lb.cfg /etc/hapee-2.8/hapee-lb.cfg.current
  2. Optional: Simulate the package upgrade to check for potential errors:

    bash
    sudo apt update
    sudo apt upgrade --simulate
    bash
    sudo apt update
    sudo apt upgrade --simulate
    bash
    sudo apt update
    sudo apt upgrade --simulate
    bash
    sudo apt update
    sudo apt upgrade --simulate
    bash
    sudo yum check-update
    bash
    sudo yum check-update
    bash
    sudo zypper update --dry-run
    bash
    sudo zypper update --dry-run

    Search the output for hapee, which will show the new package version. If there are no errors, perform the upgrade.

  3. Upgrade the packages on your system. Note that a prompt may display asking whether the system can restart service automatically during the upgrade. To avoid any disruption to service, you can uncheck HAProxy Enterprise from this list and then manually call systemctl reload hapee-2.8-lb, which will not drop traffic.

    bash
    sudo apt update
    sudo apt upgrade
    bash
    sudo apt update
    sudo apt upgrade
    bash
    sudo apt update
    sudo apt upgrade
    bash
    sudo apt update
    sudo apt upgrade
    bash
    sudo yum update
    bash
    sudo yum update
    bash
    sudo zypper update
    bash
    sudo zypper update
  4. Reload the HAProxy Enterprise service to start the new version:

    bash
    sudo systemctl reload hapee-2.8-lb
    bash
    sudo systemctl reload hapee-2.8-lb

If this page was useful, please, Leave the feedback.