HAProxy Enterprise Documentation 2.4r1

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 nodes to stay in sync.

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 node.

global
  module-path /opt/hapee-2.4/modules/
  module-load hapee-lb-update.so

dynamic-update
   update id /etc/hapee-2.4/redirects.map url http://10.0.0.1:80/redirects.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 content.

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.

See also

Dynamic Data Updates

Next up

Ring