1

= pvl-hosts =

     2

     3

DNS/DHCP hosts management/integration for ISC bind9 and dhcpd.

     4

     5

Also includes network SNMP discovery.

     6

     7

== Hosts ==

     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:

     9

    10

    [foo]

    11

        ip          = 127.0.0.1

    12

        ethernet    = 00:11:22:33:44:55

    13

    14

    [bar]

    15

        ip          = 127.0.0.2

    16

        ethernet    = 01:23:45:67:89:ab

    17

    18

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:

    19

    20

    $ pvl.hosts-dns --forward-zone=test etc/hosts/test

    21

    foo                               A     127.0.0.1

    22

    bar                               A     127.0.0.2

    23

    24

And correspondingly, the reverse zone for 127.0.0.0/8:

    25

    26

    $ pvl.hosts-dns --reverse-zone=127 etc/hosts/test

    27

    1.0.0                             PTR   foo.test.

    28

    2.0.0                             PTR   bar.test.

    29

    30

And the associated DHCP hosts:

    31

    32

    $ bin/pvl.hosts-dhcp etc/hosts/test

    33

    host foo {

    34

        option host-name foo;

    35

        hardware ethernet 00:11:22:33:44:55;

    36

        fixed-address 127.0.0.1;

    37

    }

    38

    39

    host bar {

    40

        option host-name bar;

    41

        hardware ethernet 01:23:45:67:89:ab;

    42

        fixed-address 127.0.0.2;

    43

    }

    44

    61

=== Host aliases ===

    62

Hosts can specify DNS aliases:

    63

    64

    [foo]

    65

        ip          = 127.0.0.1

    66

        alias       = test1

    67

    68

    [bar]

    69

        ip          = 127.0.0.2

    70

        alias       = test2

    71

    72

    $ bin/pvl.hosts-forward --forward-zone alias.test etc/hosts/alias.test 

    73

    foo                               A     127.0.0.1

    74

    test1                             CNAME foo

    75

    bar                               A     127.0.0.2

    76

    test2                             CNAME bar

    77

    78

=== Generated hosts ===

    79

The hosts file format supports something similar to bind9's $GENERATE directive for hosts:

    80

    81

    [asdf{1-3}]

    82

        ip  = 10.100.100.$

    83

    84

    $ bin/pvl.hosts-dns --forward-zone=asdf etc/hosts/asdf 

    85

    asdf1@asdf                        A     10.100.100.1

    86

    asdf2@asdf                        A     10.100.100.2

    87

    asdf3@asdf                        A     10.100.100.3

    88

    89

Note that the generate directives are interpreted and compiled directly by pvl.hosts. 

    90

    91

Most of the $GENERATE options should be supported, with a little clever hackery:

    92

    93

    [asdf{1-5/2}{0,2}]

    94

       ip  = 10.100.100.$${10}

    95

    96

    $ bin/pvl.hosts-dns --forward-zone=asdf2 etc/hosts/asdf2

    97

    asdf01@asdf2                      A     10.100.100.11

    98

    asdf03@asdf2                      A     10.100.100.13

    99

    asdf05@asdf2                      A     10.100.100.15

   100

   101

This feature can be used for generating reverse delegations:

   102

   103

    [foo-{240-247}]

   104

        forward =

   105

        reverse = $.240/29.0.0.10.in-addr.arpa

   106

        ip      = 10.0.0.$

   107

   108

    $ bin/pvl.hosts-dns --reverse-zone=10 etc/hosts/reverse 

   109

    240.0.0                           CNAME 240.240/29.0.0.10.in-addr.arpa.

   110

    241.0.0                           CNAME 241.240/29.0.0.10.in-addr.arpa.

   111

    242.0.0                           CNAME 242.240/29.0.0.10.in-addr.arpa.

   112

    243.0.0                           CNAME 243.240/29.0.0.10.in-addr.arpa.

   113

    244.0.0                           CNAME 244.240/29.0.0.10.in-addr.arpa.

   114

    245.0.0                           CNAME 245.240/29.0.0.10.in-addr.arpa.

   115

    246.0.0                           CNAME 246.240/29.0.0.10.in-addr.arpa.

   116

    247.0.0                           CNAME 247.240/29.0.0.10.in-addr.arpa.

   117

   118

=== DHCP Options ===

   119

The hosts need not specify any fixed ip address, leaving IP address allocation to dhcpd:

   120

   121

    [foo]

   122

        ethernet    = 00:11:22:33:44:55 

   123

   124

    $ bin/pvl.hosts-dhcp etc/hosts/dhcp1 

   125

    host foo {

   126

        option host-name foo;

   127

        hardware ethernet 00:11:22:33:44:55;

   128

    }

   129

   130

=== DHCP Boot options ===

   131

The hosts can specify DHCP boot server/file options:

   132

   133

    [foo]

   134

        ethernet    = 00:11:22:33:44:55

   135

        boot        = boot.lan:debian/wheezy/pxelinux.0

   136

   137

    $ bin/pvl.hosts-dhcp etc/hosts/boot.dhcp 

   138

    host foo {

   139

        option host-name foo;

   140

        hardware ethernet 00:11:22:33:44:55;

   141

        next-server boot.lan;

   142

        filename debian/wheezy/pxelinux.0;

   143

    }

   144

   145

=== DHCP hosts in multiple subnets/domains ===

   146

A host with different interfaces in multiple domains must specify unique interface names:

   147

   148

    [foo.dhcp]

   149

        [[asdf]]

   150

            ip              = 10.1.0.1

   151

            ethernet.eth1   = 00:11:22:33:44:55

   152

   153

    [bar.dhcp]

   154

        [[asdf]]

   155

            ip              = 10.2.0.1

   156

            ethernet.eth2   = 55:44:33:22:11:00

   157

   158

    $ bin/pvl.hosts-dhcp etc/hosts/dhcp2 

   159

    host asdf-eth1 {

   160

        option host-name asdf;

   161

        hardware ethernet 00:11:22:33:44:55;

   162

        fixed-address 10.1.0.1;

   163

    }

   164

   165

    host asdf-eth2 {

   166

        option host-name asdf;

   167

        hardware ethernet 55:44:33:22:11:00;

   168

        fixed-address 10.2.0.1;

   169

    }

   170