HAProxy Enterprise Documentation 2.0r1

Docker

You can upgrade HAProxy Enterprise to version 2.0r1 as a Docker container.

Upgrade to HAProxy Enterprise 2.0r1 using the base image

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

  1. Log into the hapee-registry.haproxy.com Docker registry, using the key you were given when you registered as the username and password.

    $ sudo docker login https://hapee-registry.haproxy.com
  2. Pull the HAProxy Enterprise image.

    $ sudo docker pull hapee-registry.haproxy.com/hapee-business:2.0r1
  3. Create an HAProxy Enterprise configuration file (i.e. hapee-lb.cfg) that defines your load balancer settings.

  4. Stop and remove any previously running HAProxy Enterprise containers:

    $ sudo docker stop <OLD CONTAINER NAME>
    $ sudo docker rm <OLD CONTAINER NAME>
  5. Start the new Docker container, referencing the directory containing your configuration file as a volume by using the -v flag.

    $ sudo docker run \
        --name hapee-2.0 \
        -d \
        -p 80:80 \
        -p 443:443 \
        -v $(pwd):/etc/hapee-2.0  \
        --restart=unless-stopped \
        hapee-registry.haproxy.com/hapee-business:2.0r1

Upgrade to HAProxy Enterprise 2.0r1 using the Plus image

The hapee-business-plus Docker image is HAProxy Enterprise with the following, additional modules and libraries installed:

  • 51Degrees

  • Javascript Challenge

  • Data Plane API

  • Digital Element NetAcuity

  • Fingerprint

  • HTML DOM

  • MaxMind

  • ModSecurity

  • Real-Time Dashboard

  • ReCAPTCHA

  • SSO

  • Update

  • WAF Advanced

  • WAF Offloader

  1. Log into the hapee-plus-registry.haproxy.com Docker registry, using the key you were given when you registered as the username and password.

    $ sudo docker login https://hapee-plus-registry.haproxy.com
  2. Pull the HAProxy Enterprise image.

    $ sudo docker pull hapee-plus-registry.haproxy.com/hapee-business-plus:2.0r1
  3. Create an HAProxy Enterprise configuration file (i.e. hapee-lb.cfg) that defines your load balancer settings.

  4. Stop and remove any previously running HAProxy Enterprise containers:

    $ sudo docker stop <OLD CONTAINER NAME>
    $ sudo docker rm <OLD CONTAINER NAME>
  5. Start the Docker container, referencing the directory containing your configuration file as a volume by using the -v flag.

    $ sudo docker run \
        --name hapee-2.0 \
        -d \
        -p 80:80 \
        -p 443:443 \
        -v $(pwd):/etc/hapee-2.0  \
        --restart=unless-stopped \
        hapee-plus-registry.haproxy.com/hapee-business-plus:2.0r1

Reload the container

When you make changes to the configuration file, you will need to reload the container before they'll take effect.

  1. Make sure that the following line is included in the global section of your HAProxy Enterprise configuration file. It ensures that you can perform a hitless reload, which means no traffic is dropped.

    global
      stats socket /tmp/stats expose-fd listeners
  2. Restart the Docker container with this command:

    $ sudo docker kill --signal USR2 hapee-2.0

Next up

Community to Enterprise