HAProxy Enterprise Documentation 2.1r1

Dynamic-update

The dynamic-update section lets HAProxy Enterprise pull updated ACL and Map files from a remote server. This allows a cluster of HAProxy Enterprise instances to stay in sync.

Tip

In order to use the dynamic-update section you first need to install HAProxy Enterprise's Update module.

$ # On Debian/Ubuntu
$ sudo apt-get install hapee-2.1r1-lb-update
$ # On CentOS/RedHat/Oracle
$ sudo yum install hapee-2.1r1-lb-update
$ # On SUSE
$ sudo zypper install hapee-2.1r1-lb-update
$ # On FreeBSD
$ sudo pkg install hapee-2.1r1-lb-update

After the Update module is installed, we can list one or more update lines in a dynamic-update section. Each specifies a file to pull from a remote server to the current load balancer instance.

dynamic-update
   update id /etc/hapee-2.1/forbid.map  url http://10.0.0.1:80/forbid.map  delay 5m  timeout 5s  retries 3  map  log  dontlog-normal

The following configuration fields are available for update.

Field name

Description

id

the path of the local file to update; It must exist when HAProxy Enterprise starts.

url

the URL from which to download updated contents.

delay

how often to download updates; The default is 5 minutes (5m).

timeout

how long to wait when trying to connect to the remote server; It defaults to 5 seconds (5s).

retries

the number of times to retry connecting to the remote server.

map

informs that the downloaded file should be interpreted as a Map file instead of an ACL file.

log

enables logging; Logs will be sent to the destination set by the global section's log directive.

dontlog-normal

disables logging of successful updates.


Next up

Binds