You can upgrade HAProxy Enterprise to version 2.2r1 on the following operating systems:
Upgrade to HAProxy Enterprise 2.2r1
The following upgrade procedure installs a new major version of HAProxy Enterprise.
Take the server that you want to upgrade out of the cluster.
Install HAProxy Enterprise 2.2r1 by running the following command and replacing <HAProxy Enterprise Key> with the key you received when you registered:
$ wget https://www.haproxy.com/static/install_haproxy_enterprise.sh $ sudo bash ./install_haproxy_enterprise.sh \ --version 2.2r1 \ --key <HAProxy Enterprise key>
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:
$ # On Debian/Ubuntu $ sudo apt-get install hapee-2.2r1-lb-update
$ # On CentOS/RedHat/Oracle/Photon OS $ sudo yum install hapee-2.2r1-lb-update
$ # On SUSE $ sudo zypper install hapee-2.2r1-lb-update
$ # On FreeBSD $ sudo pkg install hapee-2.2r1-lb-update
Copy /etc/hapee-[previous-version]/hapee-lb.cfg over to /etc/hapee-2.2/hapee-lb.cfg and any associated files (maps, certificates, etc).
Optionally, you might want to validate your configuration against the new load balancer before disabling the old load balancer. Use the
-coption to check the configuration.
$ /opt/hapee-2.2/sbin/hapee-lb -c -f /etc/hapee-2.2/hapee-lb.cfg
Configuration file is valid
Disable the old HAProxy Enterprise version from starting with the system, as follows:
$ sudo systemctl disable hapee-<previous-version>-lb
Ensure that the new HAProxy Enterprise version starts with the system, as follows:
$ sudo systemctl enable hapee-2.2-lb
Stop the old HAProxy Enterprise daemon and start the new daemon:
$ sudo systemctl stop hapee-<previous-version>-lb $ sudo systemctl start hapee-2.2-lb
On older systems that do not have
$ sudo service hapee-2.2-lb start
tail -f /var/log/syslog(or distribution equivalent) to check for warnings or errors.
curl localhostto 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.
Put the upgraded server back into the cluster.
Repeat this procedure on secondary servers.
After you upgrade, see the section on additional packages 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:
$ # On Debian or Ubuntu $ sudo apt purge hapee-<previous-version>-lb $ sudo rm /etc/rsyslog.d/<previous-version>.conf $ sudo systemctl restart rsyslog $ # On CentOs/RedHat/Oracle/Photon OS $ sudo yum remove hapee-<previous-version>-lb $ sudo rm /etc/rsyslog.d/<previous-version>.conf $ sudo systemctl restart rsyslog $ # On SUSE $ sudo zypper remove hapee-<previous-version>-lb
Update HAProxy Enterprise
The update procedure installs the latest build for your current HAProxy Enterprise version in order to benefit from the latest bug fixes.
Optional: Save the current load balancer configuration as a backup.
$ sudo cp /etc/hapee-2.2/hapee-lb.cfg /etc/hapee-2.2/hapee-lb.cfg.current
Optional: Simulate the package upgrade to check for potential errors:
$ # On Debian/Ubuntu $ sudo apt update $ sudo apt upgrade --simulate $ # On RedHat/Oracle/Rocky/Alma $ sudo yum check-update $ # On SUSE $ 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.
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.2-lb, which will not drop traffic.
$ # On Debian/Ubuntu $ sudo apt update $ sudo apt upgrade $ # On RedHat/Oracle/Rocky/Alma $ sudo yum update $ # On SUSE $ sudo zypper update
Reload the HAProxy Enterprise service to start the new version:
$ sudo systemctl reload hapee-2.2-lb