HAProxy Enterprise Documentation 2.3r1

Linux

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

Install HAProxy Enterprise 2.3r1 on CentOS
CentOS
8 7
Install HAProxy Enterprise 2.3r1 on Debian
Debian
10 9
Install HAProxy Enterprise 2.3r1 on RedHat
RedHat
8 7
Install HAProxy Enterprise 2.3r1 on Ubuntu
Ubuntu
20.04 18.04 16.04
Install HAProxy Enterprise 2.3r1 on SUSE
SUSE
15.0
Install HAProxy Enterprise 2.3r1 on Oracle
Oracle
8 7
Install HAProxy Enterprise 2.3r1 on Photon OS
Photon OS
3.0

Upgrade to HAProxy Enterprise 2.3r1

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.3r1 by running the following command and replacing <HAProxy Enterprise Key> with the key you received when you registered:

    $ curl -s https://www.haproxy.com/static/install_haproxy_enterprise.sh | sudo bash /dev/stdin 2.3r1 <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:

    $ # On Debian/Ubuntu
    $ sudo apt-get install hapee-2.3r1-verify-lb-update
    $ # On CentOS/RedHat/Oracle/Photon OS
    $ sudo yum install hapee-2.3r1-verify-lb-update
    $ # On SUSE
    $ sudo zypper install hapee-2.3r1-verify-lb-update
    $ # On FreeBSD
    $ sudo pkg install hapee-2.3r1-verify-lb-update
  4. Copy /etc/hapee-[previous-version]/hapee-lb.cfg over to /etc/hapee-2.3/hapee-lb.cfg and any associated files (maps, certificates, etc).

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

    $ sudo systemctl disable hapee-<previous-version>-lb
  6. Ensure that the new HAProxy Enterprise version starts with the system, as follows:

    $ sudo systemctl enable hapee-2.3-lb
  7. Stop the old HAProxy Enterprise daemon and start the new daemon:

    $ sudo systemctl hapee-<previous-version>-lb stop
    $ sudo systemctl hapee-2.3-lb start

    On older systems that do not have systemctl, use:

    $ sudo service hapee-2.3-lb start
  8. Run tail -f /var/log/syslog (or distribution equivalent) to check for warnings or errors.

  9. 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.

  10. Put the upgraded server back into the cluster.

  11. Repeat this procedure on secondary servers.

Post-upgrade

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

$ # On CentOs/RedHat/Oracle/Photon OS
$ sudo yum remove hapee-<previous-version>-lb

$ # 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.

$ # On Debian/Ubuntu
$ sudo apt update
$ sudo apt upgrade

$ # On CentOs/RedHat/Oracle/Photon OS
$ sudo yum update

$ # On SUSE
$ sudo zypper update

Next up

BSD