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.8r1

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

Upgrade HAPEE from another major branch

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

  2. Install HAPEE 1.8.

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

  4. Test HAPEE 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.8-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.

Install HAPEE 1.8

  1. Create a new list repository source file in /etc/apt/sources.list.d/.

    Note

    The extension of the file must be list (i.e. hapee.list)

  2. Add the HAPEE load balancer repository, as follows:

    1. In the file /etc/apt/sources.list.d/hapee.list, add this content:

      deb https://www.haproxy.com/download/hapee/key/[YOURKEYHERE]-common/1.8/ubuntu-14.04/amd64/ trusty main
    2. Replace the tag [YOURKEYHERE] with the key you received from HAProxy.

  3. Add the HAPEE components repository, as follows:

    1. In the file /etc/apt/sources.list.d/hapee.list, add this content:

      deb https://www.haproxy.com/download/hapee/key/[YOURKEYHERE]-common/1.8/ubuntu-14.04/amd64/ trusty main
    2. Replace the tag [YOURKEYHERE] with the key you received from HAProxy.

  4. Add the HAPEE 'extras' repository, as follows:

    Note

    The HAPEE 'extras' repository includes components that are independent of HAPEE versions.

    1. In the file /etc/apt/sources.list.d/hapee.list, add this content:

      deb https://www.haproxy.com/download/hapee/key/[YOURKEYHERE]-plus/extras/ubuntu-14.04/amd64/ trusty main
    2. Replace the tag [YOURKEYHERE] with the key you received from HAProxy.

  5. Import HAProxy Technologies HAPEE public key:

    curl -s -L  https://www.haproxy.com/download/hapee/key/[YOURKEYHERE]-common/HAPEE-key-1.8.asc | apt-key add -
  6. To enable HTTPS (allow apt to access repositories over HTTPS), run:

    apt-get install apt-transport-https
  7. Update the apt repository code by running apt-get update

  8. Install the load balancer by running apt-get install hapee-1.8-lb

  9. Stop the old version of HAPEE.

  10. Start HAPEE by running service hapee-1.8-lb start

  11. Remove the old packages and install the new ones using apt:

    apt-get install hapee-1.8r1-base "hapee-1.8r1-*"

    Warning

    The hapee-1.8r1-base package forces the uninstallation of any previous HAPEE packages from the same branch.

  12. Restart HAPEE services using init scripts or systemd.

Warning

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

Test HAPEE

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

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

    disable hapee-<previousversion>-lb
  2. Ensure that the new HAPEE branch starts with the system, as follows:

    systemctl enable hapee-1.8-lb
  3. Stop the old HAPEE daemon and start the new daemon:

    service hapee-<previousversion>-lb stop
    service hapee-1.8r1-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 HAPEE back into the cluster.

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

Upgrade HAPEE within the same branch

Before you upgrade HAPEE 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 HAPEE version and HAPEE 1.8r1 cannot be installed together on the same server

  • HAPEE repositories, GPG key, and customer subscription key remain the same

  1. Remove the old packages and install the new ones using apt:

    apt-get install hapee-1.8r1-base "hapee-1.8r1-*"

    Warning

    The hapee-1.8r1-base package forces the uninstallation of any previous HAPEE packages from the same branch.

  2. Restart HAPEE services using init scripts or systemd.

  3. Test HAPEE to make sure that it runs correctly.

    Warning

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