reservations.json 4.45 KB
Newer Older
1 2 3 4 5 6 7 8 9 10
# This is an example configuration file for DHCPv6 server in Kea
# that showcases how to do host reservations. It is
# assumed that one subnet (2001:db8:1::/64) is available directly
# over ethX interface. A number of hosts have various combinations
# of addresses and prefixes reserved for them.

{ "Dhcp6":

{
# Kea is told to listen on ethX interface only.
11 12 13
  "interfaces-config": {
    "interfaces": [ "ethX" ]
  },
14 15 16 17 18 19 20 21 22 23 24 25 26 27

# We need to specify lease type. As of May 2014, three backends are supported:
# memfile, mysql and pgsql. We'll just use memfile, because it doesn't require
# any prior set up.
  "lease-database": {
    "type": "memfile"
  },

# This is pretty basic stuff, it has nothing to do with reservations.
  "preferred-lifetime": 3000,
  "valid-lifetime": 4000,
  "renew-timer": 1000,
  "rebind-timer": 2000,

28 29
# Kea supports two types of identifiers in DHCPv6: hw-address (hardware/MAC address
# of the client) and duid (DUID inserted by the client). When told to do so, Kea can
30 31 32
# check for each of these identifier types, but it takes a costly database lookup
# to do so. It is therefore useful from a performance perspective to use only
# the reservation types that are actually used in a given network.
33 34
    "host-reservation-identifiers": [ "duid", "hw-address" ],

35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52
# The following list defines subnets. Subnet, pools and interface definitions
# are the same as in the regular scenario, without host reservations.
# least subnet and pool entries.
  "subnet6": [
    {
      "subnet": "2001:db8:1::/48",

      "pools": [ { "pool": "2001:db8:1::/80" } ],

      "pd-pools": [
          {
              "prefix": "2001:db8:1:8000::",
              "prefix-len": 56,
              "delegated-len": 64
          }
      ],
      "interface": "ethX",

53 54 55 56 57
# Host reservations. Define several reservations, note that
# they are all within the range of the pool of the dynamically
# allocated address. The server will exclude the addresses from this
# pool and only assign them to the client which has a reservation for
# them.
58 59
      "reservations": [
# This is a simple host reservation. The host with DUID matching
60
# the specified value will get an address of 2001:db8:1::100.
61 62 63 64 65 66
          {
              "duid": "01:02:03:04:05:0A:0B:0C:0D:0E",
              "ip-addresses": [ "2001:db8:1::100" ]
          },
# This is similar to the previous one, but this time the reservation is done
# based on hardware/MAC address. The server will do its best to extract
67 68 69
# the hardware/MAC address from received packets (see 'mac-sources' directive
# for details). This particular reservation also specifies two extra options
# to be available for this client. If there are options with the same code
70 71
# specified in a global, subnet or class scope, the values defined at host level
# take precedence.
72 73
          {
              "hw-address": "00:01:02:03:04:05",
74 75 76 77 78 79 80 81 82 83
              "ip-addresses": [ "2001:db8:1::101" ],
              "option-data": [
              {
                  "name": "dns-servers",
                  "data": "3000:1::234"
              },
              {
                  "name": "nis-servers",
                  "data": "3000:1::234"
              }]
84
          },
85
# This is a bit more advanced reservation. The client with the specified
86
# DUID will get a reserved address, a reserved prefix and a hostname.
Tomek Mrugalski's avatar
Tomek Mrugalski committed
87 88 89 90
# This reservation is for an address that it not within the dynamic pool.
# Finally, this reservation features vendor specific options for CableLabs,
# which happen to use enterprise-id 4491. Those particular values will
# be returned only to the client that has a DUID matching this reservation.
91 92
          {
              "duid": "01:02:03:04:05:06:07:08:09:0A",
Tomek Mrugalski's avatar
Tomek Mrugalski committed
93
              "ip-addresses": [ "2001:db8:1:cafe::1" ],
94
              "prefixes": [ "2001:db8:2:abcd::/64" ],
Tomek Mrugalski's avatar
Tomek Mrugalski committed
95 96 97 98 99 100 101 102 103 104 105
              "hostname": "foo.example.com",
              "option-data": [ {
                  "name": "vendor-opts",
                  "data": "4491"
              },
              {
                  "name": "tftp-servers",
                  "space": "vendor-4491",
                  "data": "3000:1::234"
              } ]

106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129
          }
      ]
    }
  ]
},

# The following configures logging. Kea will log all debug messages
# to /var/log/kea-debug.log file.
"Logging": {
    "loggers": [
        {
            "name": "kea-dhcp6",
            "output_options": [
                {
                    "output": "/var/log/kea-debug.log"
                }
            ],
            "debuglevel": 99,
            "severity": "DEBUG"
        }
    ]
}

}