Upgrade

Upgrade HAProxy Enterprise on Linux

To upgrade to a new, major version of HAProxy Enterprise (e.g. 2.8r1) from an older version, please use the Upgrade procedure. However, if you want to install the latest patches for your current version without upgrading to a new, major version, please use the Update procedure.

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 a new version 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.

    • If using Active/Active clustering, update your network to stop sending traffic to the load balancer. For example, if using DNS roundrobin, remove the load balancer from DNS.
    • If using Active/Standby clustering, then on the active load balancer edit /etc/hapee-extras/hapee-vrrp.cfg. Lower the priority value to less than the standby load balancer’s priority. This will put the active load balancer into the standby state and simultaneously activate the standby load balancer. Then restart the hapee-extras-vrrp service.
  2. Install HAProxy Enterprise by running the following command, specifying the desired version with --version, and replacing <HAProxy Enterprise Key> with the key you received when you registered. Below, we install HAProxy Enterprise 2.8r1:

    nix
    wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
    sudo bash ./install_haproxy_enterprise.sh \
    --version 2.8r1 \
    --key <HAProxy Enterprise key>
    nix
    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:

    nix
    sudo apt-get install hapee-2.8r1-lb-update
    nix
    sudo apt-get install hapee-2.8r1-lb-update
    nix
    sudo yum install hapee-2.8r1-lb-update
    nix
    sudo yum install hapee-2.8r1-lb-update
    nix
    sudo zypper install hapee-2.8r1-lb-update
    nix
    sudo zypper install hapee-2.8r1-lb-update
    nix
    sudo pkg install hapee-2.8r1-lb-update
    nix
    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.

    nix
    /opt/hapee-2.8/sbin/hapee-lb -c -f /etc/hapee-2.8/hapee-lb.cfg
    nix
    /opt/hapee-2.8/sbin/hapee-lb -c -f /etc/hapee-2.8/hapee-lb.cfg
    output
    text
    Configuration file is valid
    output
    text
    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:

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

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

    nix
    sudo systemctl stop hapee-<PREVIOUS VERSION>-lb
    sudo systemctl start hapee-2.8-lb
    nix
    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 load balancers after restoring the current load balancer to active service.

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:

nix
sudo apt purge hapee-<PREVIOUS VERSION>-lb
sudo rm /etc/rsyslog.d/<PREVIOUS VERSION>.conf
sudo systemctl restart rsyslog
nix
sudo apt purge hapee-<PREVIOUS VERSION>-lb
sudo rm /etc/rsyslog.d/<PREVIOUS VERSION>.conf
sudo systemctl restart rsyslog
nix
sudo apt purge hapee-<PREVIOUS VERSION>-lb
sudo rm /etc/rsyslog.d/<PREVIOUS VERSION>.conf
sudo systemctl restart rsyslog
nix
sudo apt purge hapee-<PREVIOUS VERSION>-lb
sudo rm /etc/rsyslog.d/<PREVIOUS VERSION>.conf
sudo systemctl restart rsyslog
nix
sudo yum remove hapee-<PREVIOUS VERSION>-lb
sudo rm /etc/rsyslog.d/<PREVIOUS VERSION>.conf
sudo systemctl restart rsyslog
nix
sudo yum remove hapee-<PREVIOUS VERSION>-lb
sudo rm /etc/rsyslog.d/<PREVIOUS VERSION>.conf
sudo systemctl restart rsyslog
nix
sudo zypper remove hapee-<PREVIOUS VERSION>-lb
nix
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. For example, on HAProxy Enterprise 2.8r1:

    nix
    sudo cp /etc/hapee-2.8/hapee-lb.cfg /etc/hapee-2.8/hapee-lb.cfg.current
    nix
    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:

    nix
    sudo apt update
    sudo apt upgrade --simulate
    nix
    sudo apt update
    sudo apt upgrade --simulate
    nix
    sudo apt update
    sudo apt upgrade --simulate
    nix
    sudo apt update
    sudo apt upgrade --simulate
    nix
    sudo yum check-update
    nix
    sudo yum check-update
    nix
    sudo zypper update --dry-run
    nix
    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.

    nix
    sudo apt update
    sudo apt upgrade
    nix
    sudo apt update
    sudo apt upgrade
    nix
    sudo apt update
    sudo apt upgrade
    nix
    sudo apt update
    sudo apt upgrade
    nix
    sudo yum update
    nix
    sudo yum update
    nix
    sudo zypper update
    nix
    sudo zypper update
  4. Reload the HAProxy Enterprise service to start the new version. For example, on HAProxy Enterprise 2.8r1:

    nix
    sudo systemctl reload hapee-2.8-lb
    nix
    sudo systemctl reload hapee-2.8-lb

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