Upgrade HAProxy Enterprise on BSD

You can upgrade HAProxy Enterprise on the following operating systems:

Upgrade HAProxy Enterprise Jump to heading #

The following upgrade procedure installs a new major version of HAProxy Enterprise.

1. Issues with the HAProxy Enterprise configuration can cause the load balancer to fail after an upgrade. Even if the service is performing as desired before the upgrade, the upgrade could introduce changes that cause a failure afterward.

   Validate the HAProxy Enterprise configuration file before proceeding with the upgrade.

   Use the hapee-lb command with the -c option to validate configuration files.

   Depending on your version, the command’s output indicates that the file is valid in these ways:

   • In version 2.8 and earlier, the command indicates a valid configuration by printing Configuration file is valid in addition to setting the zero return status.
   • In version 2.9 and later, the command sets the zero return status for a valid configuration but does not display a message. To display the message, include the -V option on the command line.

   Multiple configuration files

   If you have multiple configuration files in your application, be sure to check them all in the correct order.

   Validate the configuration file as follows:

   Validate the configuration file

   3.1r13.0r12.9r12.8r12.7r12.6r12.5r12.4r12.3r12.2r12.1r12.0r11.9r11.8r2

   AWS/BSD/Linux Docker

   nix
   sudo /opt/hapee-3.1/sbin/hapee-lb -c -f /etc/hapee-3.1/hapee-lb.cfg -V

   nix
   sudo /opt/hapee-3.1/sbin/hapee-lb -c -f /etc/hapee-3.1/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-3.1/sbin/hapee-lb -c -f /etc/hapee-3.1/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-3.1/sbin/hapee-lb -c -f /etc/hapee-3.1/hapee-lb.cfg -V

   AWS/BSD/Linux Docker

   nix
   sudo /opt/hapee-3.0/sbin/hapee-lb -c -f /etc/hapee-3.0/hapee-lb.cfg -V

   nix
   sudo /opt/hapee-3.0/sbin/hapee-lb -c -f /etc/hapee-3.0/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-3.0/sbin/hapee-lb -c -f /etc/hapee-3.0/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-3.0/sbin/hapee-lb -c -f /etc/hapee-3.0/hapee-lb.cfg -V

   AWS/BSD/Linux Docker

   nix
   sudo /opt/hapee-2.9/sbin/hapee-lb -c -f /etc/hapee-2.9/hapee-lb.cfg -V

   nix
   sudo /opt/hapee-2.9/sbin/hapee-lb -c -f /etc/hapee-2.9/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.9/sbin/hapee-lb -c -f /etc/hapee-2.9/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.9/sbin/hapee-lb -c -f /etc/hapee-2.9/hapee-lb.cfg -V

   AWS/BSD/Linux Docker

   nix
   sudo /opt/hapee-2.8/sbin/hapee-lb -c -f /etc/hapee-2.8/hapee-lb.cfg -V

   nix
   sudo /opt/hapee-2.8/sbin/hapee-lb -c -f /etc/hapee-2.8/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.8/sbin/hapee-lb -c -f /etc/hapee-2.8/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.8/sbin/hapee-lb -c -f /etc/hapee-2.8/hapee-lb.cfg -V

   AWS/BSD/Linux Docker

   nix
   sudo /opt/hapee-2.7/sbin/hapee-lb -c -f /etc/hapee-2.7/hapee-lb.cfg -V

   nix
   sudo /opt/hapee-2.7/sbin/hapee-lb -c -f /etc/hapee-2.7/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.7/sbin/hapee-lb -c -f /etc/hapee-2.7/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.7/sbin/hapee-lb -c -f /etc/hapee-2.7/hapee-lb.cfg -V

   AWS/BSD/Linux Docker

   nix
   sudo /opt/hapee-2.6/sbin/hapee-lb -c -f /etc/hapee-2.6/hapee-lb.cfg -V

   nix
   sudo /opt/hapee-2.6/sbin/hapee-lb -c -f /etc/hapee-2.6/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.6/sbin/hapee-lb -c -f /etc/hapee-2.6/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.6/sbin/hapee-lb -c -f /etc/hapee-2.6/hapee-lb.cfg -V

   AWS/BSD/Linux Docker

   nix
   sudo /opt/hapee-2.5/sbin/hapee-lb -c -f /etc/hapee-2.5/hapee-lb.cfg -V

   nix
   sudo /opt/hapee-2.5/sbin/hapee-lb -c -f /etc/hapee-2.5/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.5/sbin/hapee-lb -c -f /etc/hapee-2.5/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.5/sbin/hapee-lb -c -f /etc/hapee-2.5/hapee-lb.cfg -V

   AWS/BSD/Linux Docker

   nix
   sudo /opt/hapee-2.4/sbin/hapee-lb -c -f /etc/hapee-2.4/hapee-lb.cfg -V

   nix
   sudo /opt/hapee-2.4/sbin/hapee-lb -c -f /etc/hapee-2.4/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.4/sbin/hapee-lb -c -f /etc/hapee-2.4/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.4/sbin/hapee-lb -c -f /etc/hapee-2.4/hapee-lb.cfg -V

   AWS/BSD/Linux Docker

   nix
   sudo /opt/hapee-2.3/sbin/hapee-lb -c -f /etc/hapee-2.3/hapee-lb.cfg -V

   nix
   sudo /opt/hapee-2.3/sbin/hapee-lb -c -f /etc/hapee-2.3/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.3/sbin/hapee-lb -c -f /etc/hapee-2.3/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.3/sbin/hapee-lb -c -f /etc/hapee-2.3/hapee-lb.cfg -V

   AWS/BSD/Linux Docker

   nix
   sudo /opt/hapee-2.2/sbin/hapee-lb -c -f /etc/hapee-2.2/hapee-lb.cfg -V

   nix
   sudo /opt/hapee-2.2/sbin/hapee-lb -c -f /etc/hapee-2.2/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.2/sbin/hapee-lb -c -f /etc/hapee-2.2/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.2/sbin/hapee-lb -c -f /etc/hapee-2.2/hapee-lb.cfg -V

   AWS/BSD/Linux Docker

   nix
   sudo /opt/hapee-2.1/sbin/hapee-lb -c -f /etc/hapee-2.1/hapee-lb.cfg -V

   nix
   sudo /opt/hapee-2.1/sbin/hapee-lb -c -f /etc/hapee-2.1/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.1/sbin/hapee-lb -c -f /etc/hapee-2.1/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.1/sbin/hapee-lb -c -f /etc/hapee-2.1/hapee-lb.cfg -V

   AWS/BSD/Linux Docker

   nix
   sudo /opt/hapee-2.0/sbin/hapee-lb -c -f /etc/hapee-2.0/hapee-lb.cfg -V

   nix
   sudo /opt/hapee-2.0/sbin/hapee-lb -c -f /etc/hapee-2.0/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.0/sbin/hapee-lb -c -f /etc/hapee-2.0/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.0/sbin/hapee-lb -c -f /etc/hapee-2.0/hapee-lb.cfg -V

   AWS/BSD/Linux Docker

   nix
   sudo /opt/hapee-1.9/sbin/hapee-lb -c -f /etc/hapee-1.9/hapee-lb.cfg -V

   nix
   sudo /opt/hapee-1.9/sbin/hapee-lb -c -f /etc/hapee-1.9/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-1.9/sbin/hapee-lb -c -f /etc/hapee-1.9/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-1.9/sbin/hapee-lb -c -f /etc/hapee-1.9/hapee-lb.cfg -V

   AWS/BSD/Linux Docker

   nix
   sudo /opt/hapee-1.8/sbin/hapee-lb -c -f /etc/hapee-1.8/hapee-lb.cfg -V

   nix
   sudo /opt/hapee-1.8/sbin/hapee-lb -c -f /etc/hapee-1.8/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-1.8/sbin/hapee-lb -c -f /etc/hapee-1.8/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-1.8/sbin/hapee-lb -c -f /etc/hapee-1.8/hapee-lb.cfg -V

   Alerts and warnings that appear in the console output explain the errors encountered. An alert is a fatal condition and prohibits the service from starting. A warning indicates a condition that is not fatal now but may become fatal in the target release. Address all the errors until you receive the successful output: Configuration file is valid.

2. If the HAProxy Enterprise server is part of a high-availability cluster, take it out of the cluster:

   • If using Active/Active clustering, update your network to stop sending traffic to the load balancer. For example, if using DNS roundrobin, remove the load balancer from DNS.
   • If using Active/Standby clustering, then on the active load balancer edit /etc/hapee-extras/hapee-vrrp.cfg. Lower the priority value to less than the standby load balancer’s priority. This will put the active load balancer into the standby state and simultaneously activate the standby load balancer. Then restart the hapee-extras-vrrp service.

3. Install HAProxy Enterprise by running the following command and replacing <HAProxy Enterprise Key> with your HAProxy Enterprise license key:

   Install the software

   3.1r13.0r12.9r12.8r12.7r12.6r12.5r12.4r12.3r12.2r12.1r12.0r11.9r11.8r2

   nix
   wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
   sudo bash ./install_haproxy_enterprise.sh \
     --version 3.1r1 \
     --key <HAProxy Enterprise key>

   nix
   wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
   sudo bash ./install_haproxy_enterprise.sh \
     --version 3.1r1 \
     --key <HAProxy Enterprise key>

   nix
   wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
   sudo bash ./install_haproxy_enterprise.sh \
     --version 3.0r1 \
     --key <HAProxy Enterprise key>

   nix
   wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
   sudo bash ./install_haproxy_enterprise.sh \
     --version 3.0r1 \
     --key <HAProxy Enterprise key>

   nix
   wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
   sudo bash ./install_haproxy_enterprise.sh \
     --version 2.9r1 \
     --key <HAProxy Enterprise key>

   nix
   wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
   sudo bash ./install_haproxy_enterprise.sh \
     --version 2.9r1 \
     --key <HAProxy Enterprise key>

   nix
   wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
   sudo bash ./install_haproxy_enterprise.sh \
     --version 2.8r1 \
     --key <HAProxy Enterprise key>

   nix
   wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
   sudo bash ./install_haproxy_enterprise.sh \
     --version 2.8r1 \
     --key <HAProxy Enterprise key>

   nix
   wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
   sudo bash ./install_haproxy_enterprise.sh \
     --version 2.7r1 \
     --key <HAProxy Enterprise key>

   nix
   wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
   sudo bash ./install_haproxy_enterprise.sh \
     --version 2.7r1 \
     --key <HAProxy Enterprise key>

   nix
   wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
   sudo bash ./install_haproxy_enterprise.sh \
     --version 2.6r1 \
     --key <HAProxy Enterprise key>

   nix
   wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
   sudo bash ./install_haproxy_enterprise.sh \
     --version 2.6r1 \
     --key <HAProxy Enterprise key>

   nix
   wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
   sudo bash ./install_haproxy_enterprise.sh \
     --version 2.5r1 \
     --key <HAProxy Enterprise key>

   nix
   wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
   sudo bash ./install_haproxy_enterprise.sh \
     --version 2.5r1 \
     --key <HAProxy Enterprise key>

   nix
   wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
   sudo bash ./install_haproxy_enterprise.sh \
     --version 2.4r1 \
     --key <HAProxy Enterprise key>

   nix
   wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
   sudo bash ./install_haproxy_enterprise.sh \
     --version 2.4r1 \
     --key <HAProxy Enterprise key>

   nix
   wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
   sudo bash ./install_haproxy_enterprise.sh \
     --version 2.3r1 \
     --key <HAProxy Enterprise key>

   nix
   wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
   sudo bash ./install_haproxy_enterprise.sh \
     --version 2.3r1 \
     --key <HAProxy Enterprise key>

   nix
   wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
   sudo bash ./install_haproxy_enterprise.sh \
     --version 2.2r1 \
     --key <HAProxy Enterprise key>

   nix
   wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
   sudo bash ./install_haproxy_enterprise.sh \
     --version 2.2r1 \
     --key <HAProxy Enterprise key>

   nix
   wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
   sudo bash ./install_haproxy_enterprise.sh \
     --version 2.1r1 \
     --key <HAProxy Enterprise key>

   nix
   wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
   sudo bash ./install_haproxy_enterprise.sh \
     --version 2.1r1 \
     --key <HAProxy Enterprise key>

   nix
   wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
   sudo bash ./install_haproxy_enterprise.sh \
     --version 2.0r1 \
     --key <HAProxy Enterprise key>

   nix
   wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
   sudo bash ./install_haproxy_enterprise.sh \
     --version 2.0r1 \
     --key <HAProxy Enterprise key>

   nix
   wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
   sudo bash ./install_haproxy_enterprise.sh \
     --version 1.9r1 \
     --key <HAProxy Enterprise key>

   nix
   wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
   sudo bash ./install_haproxy_enterprise.sh \
     --version 1.9r1 \
     --key <HAProxy Enterprise key>

   nix
   wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
   sudo bash ./install_haproxy_enterprise.sh \
     --version 1.8r2 \
     --key <HAProxy Enterprise key>

   nix
   wget https://www.haproxy.com/static/install_haproxy_enterprise.sh
   sudo bash ./install_haproxy_enterprise.sh \
     --version 1.8r2 \
     --key <HAProxy Enterprise key>

4. 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, upgrade the lb-update package:

   Update modules

   3.1r13.0r12.9r12.8r12.7r12.6r12.5r12.4r12.3r12.2r12.1r12.0r11.9r11.8r2

   nix
   sudo pkg install hapee-3.1r1-lb-update

   nix
   sudo pkg install hapee-3.1r1-lb-update

   nix
   sudo pkg install hapee-3.0r1-lb-update

   nix
   sudo pkg install hapee-3.0r1-lb-update

   nix
   sudo pkg install hapee-2.9r1-lb-update

   nix
   sudo pkg install hapee-2.9r1-lb-update

   nix
   sudo pkg install hapee-2.8r1-lb-update

   nix
   sudo pkg install hapee-2.8r1-lb-update

   nix
   sudo pkg install hapee-2.7r1-lb-update

   nix
   sudo pkg install hapee-2.7r1-lb-update

   nix
   sudo pkg install hapee-2.6r1-lb-update

   nix
   sudo pkg install hapee-2.6r1-lb-update

   nix
   sudo pkg install hapee-2.5r1-lb-update

   nix
   sudo pkg install hapee-2.5r1-lb-update

   nix
   sudo pkg install hapee-2.4r1-lb-update

   nix
   sudo pkg install hapee-2.4r1-lb-update

   nix
   sudo pkg install hapee-2.3r1-lb-update

   nix
   sudo pkg install hapee-2.3r1-lb-update

   nix
   sudo pkg install hapee-2.2r1-lb-update

   nix
   sudo pkg install hapee-2.2r1-lb-update

   nix
   sudo pkg install hapee-2.1r1-lb-update

   nix
   sudo pkg install hapee-2.1r1-lb-update

   nix
   sudo pkg install hapee-2.0r1-lb-update

   nix
   sudo pkg install hapee-2.0r1-lb-update

   nix
   sudo pkg install hapee-1.9r1-lb-update

   nix
   sudo pkg install hapee-1.9r1-lb-update

   nix
   sudo pkg install hapee-1.8r2-lb-update

   nix
   sudo pkg install hapee-1.8r2-lb-update

5. Copy the configuration files from your existing instance to your new instance. In addition to the configuration files, copy any associated files such as maps, certificates, and so on. The default configuration file is:

   Configuration file location

   3.1r13.0r12.9r12.8r12.7r12.6r12.5r12.4r12.3r12.2r12.1r12.0r11.9r11.8r2

   text
   /etc/hapee-3.1/hapee-lb.cfg

   text
   /etc/hapee-3.1/hapee-lb.cfg

   text
   /etc/hapee-3.0/hapee-lb.cfg

   text
   /etc/hapee-3.0/hapee-lb.cfg

   text
   /etc/hapee-2.9/hapee-lb.cfg

   text
   /etc/hapee-2.9/hapee-lb.cfg

   text
   /etc/hapee-2.8/hapee-lb.cfg

   text
   /etc/hapee-2.8/hapee-lb.cfg

   text
   /etc/hapee-2.7/hapee-lb.cfg

   text
   /etc/hapee-2.7/hapee-lb.cfg

   text
   /etc/hapee-2.6/hapee-lb.cfg

   text
   /etc/hapee-2.6/hapee-lb.cfg

   text
   /etc/hapee-2.5/hapee-lb.cfg

   text
   /etc/hapee-2.5/hapee-lb.cfg

   text
   /etc/hapee-2.4/hapee-lb.cfg

   text
   /etc/hapee-2.4/hapee-lb.cfg

   text
   /etc/hapee-2.3/hapee-lb.cfg

   text
   /etc/hapee-2.3/hapee-lb.cfg

   text
   /etc/hapee-2.2/hapee-lb.cfg

   text
   /etc/hapee-2.2/hapee-lb.cfg

   text
   /etc/hapee-2.1/hapee-lb.cfg

   text
   /etc/hapee-2.1/hapee-lb.cfg

   text
   /etc/hapee-2.0/hapee-lb.cfg

   text
   /etc/hapee-2.0/hapee-lb.cfg

   text
   /etc/hapee-1.9/hapee-lb.cfg

   text
   /etc/hapee-1.9/hapee-lb.cfg

   text
   /etc/hapee-1.8/hapee-lb.cfg

   text
   /etc/hapee-1.8/hapee-lb.cfg

6. Validate the HAProxy Enterprise configuration file.

   Use the hapee-lb command with the -c option to validate configuration files.

   Depending on your version, the command’s output indicates that the file is valid in these ways:

   • In version 2.8 and earlier, the command indicates a valid configuration by printing Configuration file is valid in addition to setting the zero return status.
   • In version 2.9 and later, the command sets the zero return status for a valid configuration but does not display a message. To display the message, include the -V option on the command line.

   Multiple configuration files

   If you have multiple configuration files in your application, be sure to check them all in the correct order.

   Validate the configuration file as follows:

   Validate the configuration file

   3.1r13.0r12.9r12.8r12.7r12.6r12.5r12.4r12.3r12.2r12.1r12.0r11.9r11.8r2

   AWS/BSD/Linux Docker

   nix
   sudo /opt/hapee-3.1/sbin/hapee-lb -c -f /etc/hapee-3.1/hapee-lb.cfg -V

   nix
   sudo /opt/hapee-3.1/sbin/hapee-lb -c -f /etc/hapee-3.1/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-3.1/sbin/hapee-lb -c -f /etc/hapee-3.1/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-3.1/sbin/hapee-lb -c -f /etc/hapee-3.1/hapee-lb.cfg -V

   AWS/BSD/Linux Docker

   nix
   sudo /opt/hapee-3.0/sbin/hapee-lb -c -f /etc/hapee-3.0/hapee-lb.cfg -V

   nix
   sudo /opt/hapee-3.0/sbin/hapee-lb -c -f /etc/hapee-3.0/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-3.0/sbin/hapee-lb -c -f /etc/hapee-3.0/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-3.0/sbin/hapee-lb -c -f /etc/hapee-3.0/hapee-lb.cfg -V

   AWS/BSD/Linux Docker

   nix
   sudo /opt/hapee-2.9/sbin/hapee-lb -c -f /etc/hapee-2.9/hapee-lb.cfg -V

   nix
   sudo /opt/hapee-2.9/sbin/hapee-lb -c -f /etc/hapee-2.9/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.9/sbin/hapee-lb -c -f /etc/hapee-2.9/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.9/sbin/hapee-lb -c -f /etc/hapee-2.9/hapee-lb.cfg -V

   AWS/BSD/Linux Docker

   nix
   sudo /opt/hapee-2.8/sbin/hapee-lb -c -f /etc/hapee-2.8/hapee-lb.cfg -V

   nix
   sudo /opt/hapee-2.8/sbin/hapee-lb -c -f /etc/hapee-2.8/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.8/sbin/hapee-lb -c -f /etc/hapee-2.8/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.8/sbin/hapee-lb -c -f /etc/hapee-2.8/hapee-lb.cfg -V

   AWS/BSD/Linux Docker

   nix
   sudo /opt/hapee-2.7/sbin/hapee-lb -c -f /etc/hapee-2.7/hapee-lb.cfg -V

   nix
   sudo /opt/hapee-2.7/sbin/hapee-lb -c -f /etc/hapee-2.7/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.7/sbin/hapee-lb -c -f /etc/hapee-2.7/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.7/sbin/hapee-lb -c -f /etc/hapee-2.7/hapee-lb.cfg -V

   AWS/BSD/Linux Docker

   nix
   sudo /opt/hapee-2.6/sbin/hapee-lb -c -f /etc/hapee-2.6/hapee-lb.cfg -V

   nix
   sudo /opt/hapee-2.6/sbin/hapee-lb -c -f /etc/hapee-2.6/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.6/sbin/hapee-lb -c -f /etc/hapee-2.6/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.6/sbin/hapee-lb -c -f /etc/hapee-2.6/hapee-lb.cfg -V

   AWS/BSD/Linux Docker

   nix
   sudo /opt/hapee-2.5/sbin/hapee-lb -c -f /etc/hapee-2.5/hapee-lb.cfg -V

   nix
   sudo /opt/hapee-2.5/sbin/hapee-lb -c -f /etc/hapee-2.5/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.5/sbin/hapee-lb -c -f /etc/hapee-2.5/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.5/sbin/hapee-lb -c -f /etc/hapee-2.5/hapee-lb.cfg -V

   AWS/BSD/Linux Docker

   nix
   sudo /opt/hapee-2.4/sbin/hapee-lb -c -f /etc/hapee-2.4/hapee-lb.cfg -V

   nix
   sudo /opt/hapee-2.4/sbin/hapee-lb -c -f /etc/hapee-2.4/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.4/sbin/hapee-lb -c -f /etc/hapee-2.4/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.4/sbin/hapee-lb -c -f /etc/hapee-2.4/hapee-lb.cfg -V

   AWS/BSD/Linux Docker

   nix
   sudo /opt/hapee-2.3/sbin/hapee-lb -c -f /etc/hapee-2.3/hapee-lb.cfg -V

   nix
   sudo /opt/hapee-2.3/sbin/hapee-lb -c -f /etc/hapee-2.3/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.3/sbin/hapee-lb -c -f /etc/hapee-2.3/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.3/sbin/hapee-lb -c -f /etc/hapee-2.3/hapee-lb.cfg -V

   AWS/BSD/Linux Docker

   nix
   sudo /opt/hapee-2.2/sbin/hapee-lb -c -f /etc/hapee-2.2/hapee-lb.cfg -V

   nix
   sudo /opt/hapee-2.2/sbin/hapee-lb -c -f /etc/hapee-2.2/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.2/sbin/hapee-lb -c -f /etc/hapee-2.2/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.2/sbin/hapee-lb -c -f /etc/hapee-2.2/hapee-lb.cfg -V

   AWS/BSD/Linux Docker

   nix
   sudo /opt/hapee-2.1/sbin/hapee-lb -c -f /etc/hapee-2.1/hapee-lb.cfg -V

   nix
   sudo /opt/hapee-2.1/sbin/hapee-lb -c -f /etc/hapee-2.1/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.1/sbin/hapee-lb -c -f /etc/hapee-2.1/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.1/sbin/hapee-lb -c -f /etc/hapee-2.1/hapee-lb.cfg -V

   AWS/BSD/Linux Docker

   nix
   sudo /opt/hapee-2.0/sbin/hapee-lb -c -f /etc/hapee-2.0/hapee-lb.cfg -V

   nix
   sudo /opt/hapee-2.0/sbin/hapee-lb -c -f /etc/hapee-2.0/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.0/sbin/hapee-lb -c -f /etc/hapee-2.0/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-2.0/sbin/hapee-lb -c -f /etc/hapee-2.0/hapee-lb.cfg -V

   AWS/BSD/Linux Docker

   nix
   sudo /opt/hapee-1.9/sbin/hapee-lb -c -f /etc/hapee-1.9/hapee-lb.cfg -V

   nix
   sudo /opt/hapee-1.9/sbin/hapee-lb -c -f /etc/hapee-1.9/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-1.9/sbin/hapee-lb -c -f /etc/hapee-1.9/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-1.9/sbin/hapee-lb -c -f /etc/hapee-1.9/hapee-lb.cfg -V

   AWS/BSD/Linux Docker

   nix
   sudo /opt/hapee-1.8/sbin/hapee-lb -c -f /etc/hapee-1.8/hapee-lb.cfg -V

   nix
   sudo /opt/hapee-1.8/sbin/hapee-lb -c -f /etc/hapee-1.8/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-1.8/sbin/hapee-lb -c -f /etc/hapee-1.8/hapee-lb.cfg -V

   nix
   sudo docker exec hapee /opt/hapee-1.8/sbin/hapee-lb -c -f /etc/hapee-1.8/hapee-lb.cfg -V

   Alerts and warnings that appear in the console output explain the errors encountered. An alert is a fatal condition and prohibits the service from starting. A warning indicates a condition that is not fatal now but may become fatal in the target release. Address all the errors until you receive the successful output: Configuration file is valid.

7. Stop the old HAProxy Enterprise daemon and start the new daemon.

   Stop old service and start new one

   3.1r13.0r12.9r12.8r12.7r12.6r12.5r12.4r12.3r12.2r12.1r12.0r11.9r11.8r2

   nix
   sudo service hapee_<PREVIOUS VERSION>_lb onestop
   sudo service hapee_31_lb onestart

   nix
   sudo service hapee_<PREVIOUS VERSION>_lb onestop
   sudo service hapee_31_lb onestart

   nix
   sudo service hapee_<PREVIOUS VERSION>_lb onestop
   sudo service hapee_30_lb onestart

   nix
   sudo service hapee_<PREVIOUS VERSION>_lb onestop
   sudo service hapee_30_lb onestart

   nix
   sudo service hapee_<PREVIOUS VERSION>_lb onestop
   sudo service hapee_29_lb onestart

   nix
   sudo service hapee_<PREVIOUS VERSION>_lb onestop
   sudo service hapee_29_lb onestart

   nix
   sudo service hapee_<PREVIOUS VERSION>_lb onestop
   sudo service hapee_28_lb onestart

   nix
   sudo service hapee_<PREVIOUS VERSION>_lb onestop
   sudo service hapee_28_lb onestart

   nix
   sudo service hapee_<PREVIOUS VERSION>_lb onestop
   sudo service hapee_27_lb onestart

   nix
   sudo service hapee_<PREVIOUS VERSION>_lb onestop
   sudo service hapee_27_lb onestart

   nix
   sudo service hapee_<PREVIOUS VERSION>_lb onestop
   sudo service hapee_26_lb onestart

   nix
   sudo service hapee_<PREVIOUS VERSION>_lb onestop
   sudo service hapee_26_lb onestart

   nix
   sudo service hapee_<PREVIOUS VERSION>_lb onestop
   sudo service hapee_25_lb onestart

   nix
   sudo service hapee_<PREVIOUS VERSION>_lb onestop
   sudo service hapee_25_lb onestart

   nix
   sudo service hapee_<PREVIOUS VERSION>_lb onestop
   sudo service hapee_24_lb onestart

   nix
   sudo service hapee_<PREVIOUS VERSION>_lb onestop
   sudo service hapee_24_lb onestart

   nix
   sudo service hapee_<PREVIOUS VERSION>_lb onestop
   sudo service hapee_23_lb onestart

   nix
   sudo service hapee_<PREVIOUS VERSION>_lb onestop
   sudo service hapee_23_lb onestart

   nix
   sudo service hapee_<PREVIOUS VERSION>_lb onestop
   sudo service hapee_22_lb onestart

   nix
   sudo service hapee_<PREVIOUS VERSION>_lb onestop
   sudo service hapee_22_lb onestart

   nix
   sudo service hapee_<PREVIOUS VERSION>_lb onestop
   sudo service hapee_21_lb onestart

   nix
   sudo service hapee_<PREVIOUS VERSION>_lb onestop
   sudo service hapee_21_lb onestart

   nix
   sudo service hapee_<PREVIOUS VERSION>_lb onestop
   sudo service hapee_20_lb onestart

   nix
   sudo service hapee_<PREVIOUS VERSION>_lb onestop
   sudo service hapee_20_lb onestart

   nix
   sudo service hapee_<PREVIOUS VERSION>_lb onestop
   sudo service hapee_19_lb onestart

   nix
   sudo service hapee_<PREVIOUS VERSION>_lb onestop
   sudo service hapee_19_lb onestart

   nix
   sudo service hapee_<PREVIOUS VERSION>_lb onestop
   sudo service hapee_18_lb onestart

   nix
   sudo service hapee_<PREVIOUS VERSION>_lb onestop
   sudo service hapee_18_lb onestart

8. Run tail -f /var/log/messages (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 Jump to heading #

After you upgrade, see the section on enterprise modules 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:

nix
sudo pkg delete hapee-<PREVIOUS VERSION>-lb

nix
sudo pkg delete hapee-<PREVIOUS VERSION>-lb

Update HAProxy Enterprise Jump to heading #

The update procedure installs the latest build for your current HAProxy Enterprise version in order to benefit from the latest bug fixes.

nix
sudo pkg update
sudo pkg upgrade

nix
sudo pkg update
sudo pkg upgrade