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-*` 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          = 192.0.2.1

    12

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

    13

    14

    [bar]

    15

        ip          = 192.0.2.2

    16

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

    17

    19

    20

    $ bin/pvl.hosts-forward etc/hosts/example.com 

    21

    foo                               A     192.0.2.1

    22

    bar                               A     192.0.2.2

    23

    25

    27

    1                                 PTR   foo.example.com.

    28

    2                                 PTR   bar.example.com.

    29

    30

And the associated DHCP hosts:

    31

    32

    $ bin/pvl.hosts-dhcp etc/hosts/example.com 

    33

    host foo {

    34

        option host-name foo;

    35

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

    36

        fixed-address 192.0.2.1;

    37

    }

    38

    39

    host bar {

    40

        option host-name bar;

    41

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

    42

        fixed-address 192.0.2.2;

    43

    }

    44

    45

=== Include directories ===

    46

Host configs can be included:

    47

    48

    $ cat etc/hosts/test/test

    49

    include = test.d/

    50

    51

    $ cat etc/hosts/test/test.d/foo 

    52

    ip = 192.0.2.1

    53

    54

    $ cat etc/hosts/test/test.d/bar 

    55

    ip = 192.0.2.2

    56

    57

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

    58

    foo                               A     192.0.2.1

    59

    bar                               A     192.0.2.2

    60

    61

And an entire directory of hosts-files, containing sub-domains, can be given:

    62

    63

    $ ls etc/hosts/test/

    64

    asdf.test  test  test.d

    65

    66

    $ cat etc/hosts/test/asdf.test 

    67

    [quux]

    68

        ip  = 192.0.2.5

    69

    70

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

    71

    foo                               A     192.0.2.1

    72

    bar                               A     192.0.2.2

    73

    quux.asdf                         A     192.0.2.5

    74

    75

Note that the (include) directory name itself is NOT treated as a domain name. However, the file names which are included are.

    76

    77

Including a directory of files is equivalent to substituiting each file as a named section at the level of the include = statement. Note that this means that included files are treated directly as host definitions, IOW, you should NOT include a section name in an included host file unless you want to declare an additional subdomain:

    78

    79

    $ cat etc/hosts/wrong.test 

    80

    include = wrong.d/

    81

    82

    $ etc/hosts/wrong.d/host

    83

    [host]

    84

        ip  = 192.0.2.6

    85

    86

Using the --root-zone option to generate the full FQDN for the host:

    87

    88

    $ bin/pvl.hosts-forward --root-zone etc/hosts/wrong.test 

    89

    host.host.wrong.test              A     192.0.2.6

    90

    91

=== Host aliases ===

    92

Hosts can specify DNS aliases:

    93

    94

    [foo]

    95

        ip          = 127.0.0.1

    96

        alias       = test1

    97

    98

    [bar]

    99

        ip          = 127.0.0.2

   100

        alias       = test2

   101

   102

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

   103

    foo                               A     127.0.0.1

   104

    test1                             CNAME foo

   105

    bar                               A     127.0.0.2

   106

    test2                             CNAME bar

   107

   108

=== Generated hosts ===

   109

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

   110

   111

    [asdf{1-3}]

   112

        ip  = 10.100.100.$

   113

   114

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

   115

    asdf1@asdf                        A     10.100.100.1

   116

    asdf2@asdf                        A     10.100.100.2

   117

    asdf3@asdf                        A     10.100.100.3

   118

   119

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

   120

   121

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

   122

   123

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

   124

       ip  = 10.100.100.$${10}

   125

   126

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

   127

    asdf01@asdf2                      A     10.100.100.11

   128

    asdf03@asdf2                      A     10.100.100.13

   129

    asdf05@asdf2                      A     10.100.100.15

   130

   131

This feature can be used for generating reverse delegations:

   132

   133

    [foo-{240-247}]

   134

        forward =

   135

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

   136

        ip      = 10.0.0.$

   137

   138

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

   139

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

   140

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

   141

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

   142

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

   143

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

   144

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

   145

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

   146

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

   147

   148

=== DHCP Options ===

   149

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

   150

   151

    [foo]

   152

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

   153

   154

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

   155

    host foo {

   156

        option host-name foo;

   157

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

   158

    }

   159

   160

=== DHCP Boot options ===

   161

The hosts can specify DHCP boot server/file options:

   162

   163

    [foo]

   164

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

   165

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

   166

   167

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

   168

    host foo {

   169

        option host-name foo;

   170

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

   171

        next-server boot.lan;

   172

        filename debian/wheezy/pxelinux.0;

   173

    }

   174

   175

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

   176

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

   177

   178

    [foo.dhcp]

   179

        [[asdf]]

   180

            ip              = 10.1.0.1

   181

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

   182

   183

    [bar.dhcp]

   184

        [[asdf]]

   185

            ip              = 10.2.0.1

   186

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

   187

   188

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

   189

    host asdf-eth1 {

   190

        option host-name asdf;

   191

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

   192

        fixed-address 10.1.0.1;

   193

    }

   194

   195

    host asdf-eth2 {

   196

        option host-name asdf;

   197

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

   198

        fixed-address 10.2.0.1;

   199

    }

   200