To upgrade to HAProxy Enterprise 1.6r2 from a previous version you will need to install HAProxy Enterprise 1.6r2 and any additional modules you were using before you can switch to it and uninstall the previous version.

Supported Operating Systems

HAProxy Enterprise can be upgraded to version 1.6r2 on the following Operating Systems.

images/os/icons8-centos.png
CentOS
7 6
images/os/icons8-debian.png
Debian
8
images/os/icons8-redhat.png
RedHat
7 6
images/os/icons8-ubuntu.png
Ubuntu
16.04 14.04
images/os/icons8-suse.png
SUSE
images/os/icons8-oracle.png
Oracle
7 6

Upgrade to HAProxy Enterprise 1.6r2

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

    $ curl -s https://cdn.haproxy.com/static/install_haproxy_enterprise.sh | sudo bash /dev/stdin 1.6r2 <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 or Ubuntu
    $ sudo apt-get install hapee-1.6r2-lb-update
    
    $ # On CentOS or RedHat
    $ sudo yum install hapee-1.6r2-lb-udpate
    
    $ # On SUSE
    $ sudo zypper install hapee-1.6r2-lb-update
  4. Copy /etc/hapee-[previousversion]/hapee-lb.cfg over to /etc/hapee-1.6/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-<previousversion>-lb
  6. Ensure that the new HAProxy Enterprise version starts with the system, as follows:

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

    $ sudo systemctl hapee-<previousversion>-lb stop
    $ sudo systemctl hapee-1.6-lb start

    On older systems that do not have systemctl, use:

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

  9. Run wget localhost to ensure that HAProxy 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.

Upgrade to HAProxy Enterprise 1.6r2 from 1.6r1

When upgrading HAProxy Enterprise 1.6r1 to 1.6r2, the following conditions apply:

  • The directory names do not change.

  • The configuration files are located in the same place.

  • The init scripts keep the same names.

  • Each release of a version is mutually exclusive, which means that another release of an HAProxy Enterprise version cannot run together on the same server.

  • HAProxy Enterprise repositories, GPG key, and customer subscription key remain the same.

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

  2. Run the following command to install the new release:

    $ curl -s https://cdn.haproxy.com/static/install_haproxy_enterprise.sh | sudo bash /dev/stdin 1.6r2 <HAProxy Enterprise key>
  3. Restart the service:

    $ sudo systemctl hapee-1.6-lb start

    On older systems that do not have systemctl, use:

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

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

  6. Put the upgraded server back into the cluster.

  7. Repeat this procedure on secondary servers.

    Note

    Release upgrades do not require an uninstallation of the previous version.

Post-upgrade

For the additional modules, see their corresponding documentations for instructions on how to enable and configure each package.

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 RedHat or CentOS
$ sudo yum remove <package_name>

$ # On Debian or Ubuntu
$ sudo apt purge <package_name>

$ # On SUSE
$ sudo zypper remove <package_name>

Updating 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 CentOS or RedHat
$ yum update

$ # On Debian or Ubuntu
$ apt update
$ apt upgrade

$ # On SUSE
$ zypper update