Searching HAProxy Enterprise 1.9r1
Upgrading on Ubuntu 14.04 (Trusty)
Upgrading on Ubuntu 14.04 (Trusty)
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
Install HAProxy Enterprise 1.9r1
-
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
) -
Add the HAProxy Enterprise load balancer repository, as follows:
-
In the file
/etc/apt/sources.list.d/hapee.list
, add this content:deb https://www.haproxy.com/download/hapee/key/[YOURKEYHERE]-common/1.9r1/ubuntu-14.04/amd64/ trusty main
Replace the tag [YOURKEYHERE] with the key you received from HAProxy.
-
-
Add the HAProxy Enterprise components repository, as follows:
-
In the file
/etc/apt/sources.list.d/hapee.list
, add this content:deb https://www.haproxy.com/download/hapee/key/[YOURKEYHERE]-common/1.9r1/ubuntu-14.04/amd64/ trusty main
Replace the tag [YOURKEYHERE] with the key you received from HAProxy.
-
-
Add the HAProxy Enterprise 'extras' repository, as follows:
Note
The HAProxy Enterprise 'extras' repository includes components that are independent of HAProxy Enterprise versions.
-
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
Replace the tag [YOURKEYHERE] with the key you received from HAProxy.
-
-
Import your HAProxy Enterprise public key from HAProxy Technologies:
curl -s -L https://www.haproxy.com/download/hapee/key/[YOURKEYHERE]-common/HAPEE-key-1.9r1.asc | apt-key add -
-
To enable HTTPS (allow apt to access repositories over HTTPS), run:
apt-get install apt-transport-https
Update the
apt
repository code by runningapt-get update
Install the load balancer by running
apt-get install hapee-1.9r1-lb
Stop the old version of HAProxy Enterprise.
Start HAProxy Enterprise by running
service hapee-1.9r1-lb start
-
Remove the old packages and install the new ones using
apt
:apt-get install hapee-1.9r1-base "hapee-1.9r1-*"
Warning
The
hapee-1.9r1-base
package forces the uninstallation of any previous HAProxy Enterprise packages from the same branch. 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:
-
Disable the old HAProxy Enterprise branch from starting with the system, as follows:
systemctl disable hapee-<previousversion>-lb
-
Ensure that the new HAProxy Enterprise branch starts with the system, as follows:
systemctl enable hapee-1.9r1-lb
-
Stop the old HAProxy Enterprise daemon and start the new daemon:
service hapee-<previousversion>-lb stop service hapee-1.9r1-lb start
Run
tail -f /var/log/syslog
(or distribution equivalent) to check for warnings or errors.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.Put HAProxy Enterprise back into the cluster.
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
Fail out the node by lowering its priority (if using VRRP) or retracting its advertisement (if using BGP/OSPF).
Copy
/etc/hapee-[previousversion]/hapee-lb.cfg
over to/etc/hapee-1.9r1/hapee-lb.cfg
and any associated files (maps/certificates/etc)Test HAProxy Enterprise to stop the old version and start the new one.
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.9r1-lb
and restart hapee-<previousversion>-lb again.)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.9r1 cannot be installed together on the same server
HAProxy Enterprise repositories, GPG key, and customer subscription key remain the same
-
Remove the old packages and install the new ones using apt:
apt-get install hapee-1.9r1-base "hapee-1.9r1-*"
Warning
The hapee-1.9r1-base package forces the uninstallation of any previous HAProxy Enterprise packages from the same branch.
Restart HAProxy Enterprise services using init scripts or systemd.
-
Test HAProxy Enterprise to make sure that it runs correctly.
Warning
You must run this procedure on the slave load-balancer.