README
author Tero Marttila <tero.marttila@aalto.fi>
Tue, 24 Feb 2015 17:48:10 +0200
changeset 443 ef1d6f1cbf7c
parent 438 d45fc43c6073
child 447 6f0357759e9b
permissions -rw-r--r--
README
438
d45fc43c6073 split out pvl-hosts from pvl-verkko
Tero Marttila <tero.marttila@aalto.fi>
parents: 34
diff changeset
     1
= pvl-hosts =
34
491f7da9d29b pvl.verkko-dhcp: fix polling without syslog; README
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
     2
443
Tero Marttila <tero.marttila@aalto.fi>
parents: 438
diff changeset
     3
DNS/DHCP hosts management/integration for ISC bind9 and dhcpd.
Tero Marttila <tero.marttila@aalto.fi>
parents: 438
diff changeset
     4
Tero Marttila <tero.marttila@aalto.fi>
parents: 438
diff changeset
     5
Also includes network SNMP discovery.
Tero Marttila <tero.marttila@aalto.fi>
parents: 438
diff changeset
     6
Tero Marttila <tero.marttila@aalto.fi>
parents: 438
diff changeset
     7
== Hosts ==
Tero Marttila <tero.marttila@aalto.fi>
parents: 438
diff changeset
     8
The `pvl.hosts-* etc/hosts/test` tools read hosts files as input, which have an ini format, using section names as hostnames to configure attributes for that host:
Tero Marttila <tero.marttila@aalto.fi>
parents: 438
diff changeset
     9
Tero Marttila <tero.marttila@aalto.fi>
parents: 438
diff changeset
    10
    [foo]
Tero Marttila <tero.marttila@aalto.fi>
parents: 438
diff changeset
    11
        ip  = 127.0.0.1
Tero Marttila <tero.marttila@aalto.fi>
parents: 438
diff changeset
    12
Tero Marttila <tero.marttila@aalto.fi>
parents: 438
diff changeset
    13
    [bar]
Tero Marttila <tero.marttila@aalto.fi>
parents: 438
diff changeset
    14
        ip  = 127.0.0.2
Tero Marttila <tero.marttila@aalto.fi>
parents: 438
diff changeset
    15
Tero Marttila <tero.marttila@aalto.fi>
parents: 438
diff changeset
    16
The default mechanism uses the basename of the given config file as the domain name, so this example file would generate something like the following output for use in a `zone "test" { ... }` zonefile:
Tero Marttila <tero.marttila@aalto.fi>
parents: 438
diff changeset
    17
Tero Marttila <tero.marttila@aalto.fi>
parents: 438
diff changeset
    18
    $ pvl.hosts-dns --forward-zone=test etc/hosts/test
Tero Marttila <tero.marttila@aalto.fi>
parents: 438
diff changeset
    19
    foo                               A     127.0.0.1
Tero Marttila <tero.marttila@aalto.fi>
parents: 438
diff changeset
    20
    bar                               A     127.0.0.2
Tero Marttila <tero.marttila@aalto.fi>
parents: 438
diff changeset
    21
Tero Marttila <tero.marttila@aalto.fi>
parents: 438
diff changeset
    22
And correspondingly, the reverse zone for 127.0.0.0/8:
Tero Marttila <tero.marttila@aalto.fi>
parents: 438
diff changeset
    23
Tero Marttila <tero.marttila@aalto.fi>
parents: 438
diff changeset
    24
    $ pvl.hosts-dns --reverse-zone=127 etc/hosts/test
Tero Marttila <tero.marttila@aalto.fi>
parents: 438
diff changeset
    25
    1.0.0                             PTR   foo.test.
Tero Marttila <tero.marttila@aalto.fi>
parents: 438
diff changeset
    26
    2.0.0                             PTR   bar.test.
Tero Marttila <tero.marttila@aalto.fi>
parents: 438
diff changeset
    27