The upgrading procedure varies depending on whether you are going to a newer version:

  • From another major branch: for example, from 1.7r2 to 1.8r2

  • On the same branch: for example, from 1.6r1 to 1.6r2

  1. Save the current configuration (i.e. 1.x):

    cp -rp /etc/hapee-1.x /etc/hapee-1.x.save

  2. Remove the old packages:

    yum remove "hapee-*"

  3. Install the new packages:

    yum install "hapee-1.7r2-*"

  4. Copy the saved configuration:

    cp -rpf /etc/hapee-1.x.save /etc/hapee-1.x

  5. Restart HAProxy Enterprise services using init scripts or systemd.

    Warning

    You must run this procedure on the slave load-balancer.

Test HAProxy Enterprise

After the upgrade, test HAProxy Enterprise to make sure it runs correctly:

  1. Disable the old HAProxy Enterprise branch from starting with the system, as follows:

    disable hapee-<previousversion>-lb

  2. Ensure that the new HAProxy Enterprise daemon starts with the system, as follows:

    systemctl enable hapee-1.7-lb

  3. Stop the old HAProxy Enterprise daemon and start the new daemon:

    service hapee-<previousversion>-lb stop
service hapee-1.7-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 HAProxy Enterprise back into the cluster.

  7. After the new HAProxy Enterprise branch has been running for a while, you can uninstall the old HAProxy Enterprise branch. If there are problems, you can stop the new version and revert to the old version.

Upgrade HAProxy Enterprise

  1. Fail out the node by lowering its priority (if using VRRP) or retracting its advertisement (if using BGP/OSPF).

  2. Follow the procedure to install hapee-1.7r2

  3. Copy /etc/hapee-[previousversion]/hapee-lb.cfg over to /etc/hapee-1.7r2/hapee-lb.cfg and any associated files (maps/certificates/etc)

  4. Test HAProxy Enterprise to stop the old version and start the new one.

  5. Undo the change made in step 1 and proceed to the next node if everything continues smoothly. (If anything goes wrong, you can stop hapee-1.7r2-lb and restart hapee-<previousversion>-lb again.)

  6. Remove the repository URLs of the previous version and uninstall the old packages, after you are certain that you do not need to revert.

Upgrade HAProxy Enterprise within the same branch

Before you upgrade HAProxy Enterprise to a newer version, check that 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 version in a branch is mutually exclusive, which means that another HAProxy Enterprise version and HAProxy Enterprise 1.7r2 cannot be installed together on the same server

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

  1. Save the current configuration (i.e. 1.x):

    cp -rp /etc/hapee-1.x /etc/hapee-1.x.save

  2. Remove the old packages:

    yum remove "hapee-*"

  3. Install the new packages:

    yum install "hapee-1.7r2-*"

  4. Copy the saved configuration:

    cp -rpf /etc/hapee-1.x.save /etc/hapee-1.x

  5. Restart HAProxy Enterprise services using init scripts or systemd.

  6. Test HAProxy Enterprise to make sure that it runs correctly.

Warning

You must run this procedure on the slave load-balancer.