Add instruction about the use of --libdir
[pdns-ldap-backend.git] / USAGE.master
blob0247e748d81f3024b8765e815dd23a9050ab09a1
1 This documents the master support for the LDAP backend, and
2 the necessary changes to enable it.
4 Schema update
5 =============
7 First off adding master support to the LDAP backend needs
8 a schema update. This is required as some metadata must
9 be stored by PowerDNS, such as the last successfull transfer
10 to slaves. The new schema is available in
11 schema/pdns-domaininfo.schema.
13 Once the schema is loaded the zones for which you want to
14 be a master must be modified. The dn of the SOA record
15 *must* have the object class PdnsDomain, and thus the
16 PdnsDomainId attribute. This attribute is an integer
17 that *must* be unique across all zones served by the
18 backend. Furthermore the PdnsDomainType must be equal
19 to 'master' (lower case).
21 Here is an example LDIF of a zone that's ready for master
22 operation (assuming the 'tree' style):
24 dn: dc=example,dc=com,ou=dns,dc=mycompany,dc=com
25 objectClass: top
26 objectClass: domainRelatedObject
27 objectClass: dNSDomain2
28 objectClass: PdnsDomain
29 dc: example
30 associatedDomain: example.com
31 nSRecord: ns1.example.com
32 sOARecord: ns1.example.com. hostmaster.example.com. 2013031101 1800 600 1209600 600
33 mXRecord: 10 mx1.example.com
34 PdnsDomainId: 1
35 PdnsDomainType: master
36 PdnsDomainMaster: 192.168.0.2
38 You should have one attribute 'PdnsDomainMaster' per
39 master serving this zone.