HAProxy Enterprise Documentation 1.6r2
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-1.6r2-lb-update
$ # On CentOS/RedHat/Oracle
$ sudo yum install hapee-1.6r2-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-1.6/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