summaryrefslogtreecommitdiff
path: root/README
blob: c9bdcc0127eca67811c215a55360c29c88675c81 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
=================================================================
                     SLAPI-DNSNOTIFY README

More information is available here:

        http://memberwebs.com/stef/software/slapi-dnsnotify/

This is a SLAPI 'postoperation' plugin. The entry point is 'plugin_init'.
See below for an example of how to configure it.

An LDAP entry is assumed to be a zone if it has an sOARecord attribute.
The exact name of the attribute can be controlled with the soa-attribute
option. The information about the zone, such as name servers and zone
name are retrieved from the same LDAP entry, that is the one with the SOA
attribute on it.

Notification requests are handled by the notify-dns-slaves(5) tool. The
notifications are not sent immediately, and multiple notifications that
occur close together are combined into a single notification. See the
notify-delay option.

To increment the serial number of a zone automatically whenever something
in the zone changes, use the enable-auto-serial option. All LDAP entries
beneath the entry with the SOA attribute are assumed to be part of that
zone for purposes of incrementing the serial number.

Here is an example of how to configure this plugin with OpenLDAP, using
an LDAP base DN of dc=example,dc=com and with automatic incrementing of
the zone serial number and a notification delay of 10 seconds.

The following would go into your slapd.conf(5) file:

      plugin postoperation \
              /usr/local/lib/slapi-dnsnotify.so plugin_init \
              notify-delay=10 base-dn=ou=web,dc=ws,dc=local \
              enable-auto-serial

The above may all be specified on one line. The backslashes at the end
make it more readable and maintainable.