Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

Merge branch 'docs'

  • Loading branch information...
commit 213f8016dd40722cd35216fdd615a19075694348 2 parents b2d215b + 78ccd78
@xaque208 xaque208 authored
Showing with 47 additions and 3 deletions.
  1. +47 −3 README.md
View
50 README.md
@@ -1,5 +1,49 @@
-DHCP
-===
+# DHCP module for Puppet
+Installs and manages a DHCP server.
-This module installs a dhcp server.
+## Features
+* Multiple subnet support
+* Host reservations
+* Secure dynamic DNS updates when combined with Bind
+
+## Usage
+Define the server and the zones it will be responsible for.
+
+ class { 'dhcp':
+ dnsdomain => [
+ 'dc1.example.net',
+ '1.0.10.in-addr.arpa',
+ ],
+ nameservers => ['10.0.1.20'],
+ ntpservers => ['us.pool.ntp.org'],
+ interfaces => ['eth0'],
+ dnsupdatekey => "/etc/bind/keys.d/$ddnskeyname",
+ require => Bind::Key[ $ddnskeyname ],
+ pxeserver => '10.0.1.50',
+ pxefilename => 'pxelinux.0',
+ }
+
+### dhcp::pool
+Define the pool attributes
+
+ dhcp::pool{ 'ops.dc1.example.net':
+ network => '10.0.1.0',
+ mask => '255.255.255.0',
+ range => '10.0.1.100 10.0.1.200',
+ gateway => '10.0.1.1',
+ }
+
+
+### dhcp::host
+Create host reservations.
+
+ dhcp::host {
+ 'server1': mac => "00:50:56:00:00:01", ip => "10.0.1.51";
+ 'server2': mac => "00:50:56:00:00:02", ip => "10.0.1.52";
+ 'server3': mac => "00:50:56:00:00:03", ip => "10.0.1.53";
+ }
+
+## Contributors
+Zach Leslie <zach.leslie@gmail.com>
+Ben Hughes <git@mumble.org.uk>
Please sign in to comment.
Something went wrong with that request. Please try again.