{ "Dhcp4":
{
- // Kea is told to listen on ethX interface only.
+ // Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ],
+ "interfaces": [ "eth0" ],
// This specifies what type of socket Kea uses. Currently supported
// are 'raw' (which is the default) and 'udp'. Raw has the benefit
"hosts-databases": [
{
// Name of the database to connect to.
- "name": "kea",
+ "name": "keatest",
// Host on which the database resides.
"host": "localhost",
// Database password.
- "password": "kea",
+ "password": "keatest",
// Port on which the database is available.
"port": 3306,
"type": "mysql",
// User name to be used to access the database.
- "user": "kea",
+ "user": "keatest",
// Read only mode.
"readonly": false,
},
{
// Name of the database to connect to.
- "name": "kea",
+ "name": "keatest",
// Host on which the database resides.
"host": "localhost",
// Database password.
- "password": "kea",
+ "password": "keatest",
// Port on which the database is available.
"port": 5432,
"type": "postgresql",
// User name to be used to access the database.
- "user": "kea",
+ "user": "keatest",
// Connection reconnect wait time.
// This parameter governs how long Kea waits before attempting
// Specifies a list of interfaces on which the Kea DHCPv4
// server should listen to the DHCP requests.
"interfaces": [
- "ethX"
+ "eth0"
],
// Enumeration which indicates what interface should be used
// Specifies that this shared network is selected for the
// requests received on the particular interface.
- "interface": "ethX",
+ "interface": "eth0",
// Shared network level flag specifying whether the client
// identifier should be used for identifying clients.
"4o6-subnet": "2001:db8:1:1::/64",
// Subnet level authoritative flag.
- "authoritative": true,
+ "authoritative": false,
// Subnet level bootfile name, set in 'file' field.
"boot-file-name": "",
// Specifies that this subnet is selected for the requests
// received on the particular interface.
- "interface": "ethX",
+ "interface": "eth0",
// Subnet level flag specifying whether the client identifier
// should be used for identifying clients.
"hosts-databases": [
{
// Name of the database to connect to.
- "name": "kea",
+ "name": "keatest",
// Host on which the database resides.
"host": "localhost",
// Database password.
- "password": "kea",
+ "password": "keatest",
// Port on which the database is available.
"port": 3306,
"type": "mysql",
// User name to be used to access the database.
- "user": "kea",
+ "user": "keatest",
// Read only mode.
"readonly": false,
},
{
// Name of the database to connect to.
- "name": "kea",
+ "name": "keatest",
// Host on which the database resides.
"host": "localhost",
// Database password.
- "password": "kea",
+ "password": "keatest",
// Port on which the database is available.
"port": 5432,
"type": "postgresql",
// User name to be used to access the database.
- "user": "kea"
+ "user": "keatest"
},
{
+ // Name of the database to connect to.
+ "name": "keatest",
+
// Database password.
- "password": "kea",
+ "password": "keatest",
// Port on which the database is available.
"port": 9042,
"type": "mysql",
// User name to be used to access the database.
- "user": "kea",
+ "user": "keatest",
// Connection reconnect wait time.
// This parameter governs how long Kea waits before attempting
// Specifies a list of interfaces on which the Kea DHCPv4
// server should listen to the DHCP requests.
"interfaces": [
- "ethX"
+ "eth0"
],
// Enumeration which indicates what interface should be used
// Specifies that this shared network is selected for the
// requests received on the particular interface.
- "interface": "ethX",
+ "interface": "eth0",
// Shared network level flag specifying whether the client
// identifier should be used for identifying clients.
"4o6-subnet": "2001:db8:1:1::/64",
// Subnet level authoritative flag.
- "authoritative": true,
+ "authoritative": false,
// Subnet level bootfile name, set in 'file' field.
"boot-file-name": "",
// Specifies that this subnet is selected for the requests
// received on the particular interface.
- "interface": "ethX",
+ "interface": "eth0",
// Subnet level flag specifying whether the client identifier
// should be used for identifying clients.
{
"code": 114,
"data": "https://default.example.org",
- "name": "default-url"
+ "name": "v4-captive-portal"
},
// Option code 115 is unassigned.
"name": "v4-portparams"
},
- // Type: string
- {
- "code": 160,
- "data": "portal",
- "name": "v4-captive-portal"
- },
-
// Option codes 161-209 are unassigned.
/*
{ "Dhcp4":
{
-// Kea is told to listen on ethX interface only.
+// Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// We need to specify lease type. Exactly one lease-database section
{
"pools": [ { "pool": "192.0.2.1 - 192.0.2.200" } ],
"subnet": "192.0.2.0/24",
- "interface": "ethX"
+ "interface": "eth0"
}
],
{ "Dhcp4": {
-// Kea is told to listen on ethX interface only.
+// Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// Let's use the simplest backend: memfile and use some reasonable values
"pools": [ { "pool": "192.0.2.1 - 192.0.2.200" } ],
"subnet": "192.0.2.0/24",
"client-class": "VoIP",
- "interface": "ethX"
+ "interface": "eth0"
},
// This one doesn't have any client-class specified, so everyone
"hw-address": "1a:1b:1c:1d:1e:1f",
"client-classes": [ "VoIP" ]
} ],
- "interface": "ethX"
+ "interface": "eth0"
},
// The following list defines a subnet with pools. For some pools
} ],
"subnet": "192.0.4.0/23",
- "interface": "ethY"
+ "interface": "eth1"
}
],
{ "Dhcp4": {
-// Kea is told to listen on ethX interface only.
+// Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// Let's use the simplest backend: memfile and use some reasonable values
"pools": [ { "pool": "192.0.2.1 - 192.0.2.200" } ],
"subnet": "192.0.2.0/24",
"client-class": "VoIP",
- "interface": "ethX"
+ "interface": "eth0"
},
// This one doesn't have any client-class specified, so everyone
// is allowed in. The normal subnet selection rules still apply,
"hw-address": "1a:1b:1c:1d:1e:1f",
"client-classes": [ "VoIP" ]
} ],
- "interface": "ethX",
+ "interface": "eth0",
"require-client-classes": [ "second_subnet" ]
},
"pool": "192.0.5.1 - 192.0.5.200"
} ],
"subnet": "192.0.4.0/23",
- "interface": "ethY"
+ "interface": "eth1"
},
// This subnet is divided in two pools for unknown and known
// (i.e. which have a reservation) clients. The built-in KNOWN and
// UNKNOWN classes are set or not at host reservation lookup (KNOWN if
// this returns something, UNKNOWN if this finds nothing) and client
-//classes depending on it are evaluated.
+// classes depending on it are evaluated.
// This happens after subnet selection and before address allocation
-//from pools.
+// from pools.
{
"pools": [
{
// either "all" or "server1" will be used by this instance.
"server-tag": "server1",
- // Kea is told to listen on ethX interface only.
+ // Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// Use memfile lease database backend.
"Dhcp4":
{
"interfaces-config": {
- "interfaces": [ "eno33554984" ]
+ "interfaces": [ "eth0" ]
},
"lease-database": {
"subnet4": [
{ "subnet": "10.10.10.0/24",
// Don't forget the "4o6-" before "interface" here!
- "4o6-interface": "eno33554984",
+ "4o6-interface": "eth0",
"4o6-subnet": "2001:db8:1:1::/64",
"pools": [ { "pool": "10.10.10.100 - 10.10.10.199" } ] }
],
{ "Dhcp4":
{
-// Kea is told to listen on ethX interface only.
+// Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// We need to specify the database used to store leases. As of June
// Note: flexible identifier requires flex_id hook library to be
// loaded to work.
{
- "flex-id": "s0mEVaLue",
+ "flex-id": "'s0mEVaLue'",
"ip-address": "192.0.2.206"
}
],
// Add names of your network interfaces to listen on.
"interfaces-config": {
// The DHCPv4 server listens on this interface.
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// Control socket is required for communication between the Control
{
// Kea is told to listen on specific interfaces only.
"interfaces-config": {
- // You should probably list your network interfaces here (e.g. "en0")
- "interfaces": [ "en0" ]
+ // You should probably list your network interfaces here (e.g. "eth1961")
+ "interfaces": [ "eth1961" ]
},
// Set up the storage for leases.
// Set the subnet ID (aka RADIUS NAS port).
"id": 14,
"subnet": "192.0.2.0/24",
- "interface": "en0",
+ "interface": "eth1961",
"pools": [
{
// Red pool (10-19 are for reservations)
{"Dhcp4":
{
-// Kea is told to listen on the ethX interface only.
+// Kea is told to listen on the eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// Set up the storage for leases.
{
"pools": [ { "pool": "192.0.2.1 - 192.0.2.200" } ],
"subnet": "192.0.2.0/24",
- "interface": "ethX"
+ "interface": "eth0"
}
],
{ "Dhcp4":
{
-// Kea is told to listen on ethX interface only.
+// Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// We need to specify the database used to store leases. As of
{
"pools": [ { "pool": "192.0.2.1 - 192.0.2.200" } ],
"subnet": "192.0.2.0/24",
- "interface": "ethX"
+ "interface": "eth0"
}
],
{ "Dhcp4":
{
-// Kea is told to listen on ethX interface only.
+// Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// We need to specify the database used to store leases. As of
{ "Dhcp4":
{
-// Kea is told to listen on ethX interface only.
+// Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
"type": "mysql",
"reconnect-wait-time": 3000, // expressed in ms
"max-reconnect-tries": 3,
- "name": "kea",
- "user": "kea",
- "password": "kea",
+ "name": "keatest",
+ "user": "keatest",
+ "password": "keatest",
"host": "localhost",
"port": 3306,
"trust-anchor": "my-ca",
{
"pools": [ { "pool": "192.0.2.10 - 192.0.2.200" } ],
"subnet": "192.0.2.0/24",
- "interface": "ethX",
+ "interface": "eth0",
"id": 1
}
],
{ "Dhcp4":
{
-// Kea is told to listen on ethX interface only.
+// Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
"type": "postgresql",
"reconnect-wait-time": 3000, // expressed in ms
"max-reconnect-tries": 3,
- "name": "kea",
- "user": "kea",
- "password": "kea",
+ "name": "keatest",
+ "user": "keatest",
+ "password": "keatest",
"host": "localhost"
}
],
{
"pools": [ { "pool": "192.0.2.10 - 192.0.2.200" } ],
"subnet": "192.0.2.0/24",
- "interface": "ethX",
+ "interface": "eth0",
"id": 1
}
],
{ "Dhcp4":
{
-// Kea is told to listen on ethX interface only.
+// Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// We need to specify the database used to store leases. As of April
// Note: flexible identifier requires flex_id hook library to be
// loaded to work.
{
- "flex-id": "s0mEVaLue",
+ "flex-id": "'s0mEVaLue'",
"ip-address": "192.0.2.206"
}
{ "Dhcp4":
{
-// Kea is told to listen on ethX interface only.
+// Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// We need to specify the database used to store leases. As of
// As with any other configuration, you need to tell Kea the interface
// names, so it would listen to incoming traffic.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// You also need to tell where to store lease information.
{ "Dhcp4":
{
-// Kea is told to listen on ethX interface only.
+// Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// We need to specify the database used to store leases. As of
{
"pools": [ { "pool": "192.0.2.1 - 192.0.2.200" } ],
"subnet": "192.0.2.0/24",
- "interface": "ethX"
+ "interface": "eth0"
}
],
]
}
],
-// Kea is told to listen on ethX interface only.
+// Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": ["ethX"]
+ "interfaces": ["eth0"]
},
// We need to specify the database used to store leases.
"lease-database": {
// here. We tell Kea that it is directly available over local interface.
"subnet4": [
{
- "interface": "ethX",
+ "interface": "eth0",
"pools": [
{
"pool": "192.0.2.50-192.0.2.50"
]
}
],
-// Kea is told to listen on ethX interface only.
+// Kea is told to listen on eth0 interface only.
"interfaces-config": {
"interfaces": [
- "ethX"
+ "eth0"
]
},
// We need to specify the database used to store leases.
// here. We tell Kea that it is directly available over local interface.
"subnet4": [
{
- "interface": "ethX",
+ "interface": "eth0",
"pools": [
{
"pool": "192.0.2.50-192.0.2.50"
{ "Dhcp4":
{
-// Kea is told to listen on ethX interface only.
+// Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// We need to specify the database used to store leases. As of
{
"pools": [ { "pool": "192.0.2.1 - 192.0.2.200" } ],
"subnet": "192.0.2.0/24",
- "interface": "ethX"
+ "interface": "eth0"
}
],
// It attempts to showcase some of the more advanced features.
// Topology wise, it's a basic scenario with one IPv6 subnet configured.
// It is assumed that one subnet (2001:db8:1::/64) is available directly
-// over ethX interface.
+// over eth0 interface.
//
// The following features are currently showcased here:
// 1. Configuration of MAC/hardware address sources in DHCPv6
{ "Dhcp6":
{
- // Kea is told to listen on ethX network interface only.
+ // Kea is told to listen on eth0 network interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ],
+ "interfaces": [ "eth0" ],
// This makes interfaces to be re-detected at each (re-)configuration.
// By default it is true.
"prefix": "2001:db8:abcd::",
"prefix-len": 48,
"delegated-len": 64,
- "excluded-prefix": "2001:db8:abcd:1234::",
- "excluded-prefix-len": 72,
+ "excluded-prefix": "2001:db8:abcd:0:1234::",
+ "excluded-prefix-len": 80,
// Another user-context for this PD pool. Again, you can put
// anything you want in there as long as it's valid JSON and
], // end of pools
"subnet": "2001:db8:1::/64",
- "interface": "ethX",
+ "interface": "eth0",
// Sometimes the relay may use an odd IPv6 address that's not matching
// the subnet. This is discouraged, but there are valid cases when it
"hosts-databases": [
{
// Name of the database to connect to.
- "name": "kea",
+ "name": "keatest",
// Host on which the database resides.
"host": "localhost",
// Database password.
- "password": "kea",
+ "password": "keatest",
// Port on which the database is available.
"port": 3306,
"type": "mysql",
// User name to be used to access the database.
- "user": "kea",
+ "user": "keatest",
// Read only mode.
"readonly": false,
},
{
// Name of the database to connect to.
- "name": "kea",
+ "name": "keatest",
// Host on which the database resides.
"host": "localhost",
// Database password.
- "password": "kea",
+ "password": "keatest",
// Port on which the database is available.
"port": 5432,
"type": "postgresql",
// User name to be used to access the database.
- "user": "kea",
+ "user": "keatest",
// Connection reconnect wait time.
// This parameter governs how long Kea waits before attempting
// Specifies a list of interfaces on which the Kea DHCPv6
// server should listen to the DHCP requests.
"interfaces": [
- "ethX"
+ "eth0"
],
// Boolean flag indicating if the available interfaces should
// Specifies that this shared network is selected for the
// requests received on the particular interface.
- "interface": "ethX",
+ "interface": "eth0",
// Specifies the content of the interface-id option used
// by relays to identify the interface on the relay to
// Specifies that this subnet is selected for the requests
// received on the particular interface.
- "interface": "ethX",
+ "interface": "eth0",
// Specifies the content of the interface-id option used
// by relays to identify the interface on the relay to
"hosts-databases": [
{
// Name of the database to connect to.
- "name": "kea",
+ "name": "keatest",
// Host on which the database resides.
"host": "localhost",
// Database password.
- "password": "kea",
+ "password": "keatest",
// Port on which the database is available.
"port": 3306,
"type": "mysql",
// User name to be used to access the database.
- "user": "kea",
+ "user": "keatest",
// Read only mode.
"readonly": false,
},
{
// Name of the database to connect to.
- "name": "kea",
+ "name": "keatest",
// Host on which the database resides.
"host": "localhost",
// Database password.
- "password": "kea",
+ "password": "keatest",
// Port on which the database is available.
"port": 5432,
"type": "postgresql",
// User name to be used to access the database.
- "user": "kea"
+ "user": "keatest"
},
{
+ // Name of the database to connect to.
+ "name": "keatest",
+
// Database password.
- "password": "kea",
+ "password": "keatest",
// Port on which the database is available.
"port": 9042,
"type": "mysql",
// User name to be used to access the database.
- "user": "kea",
+ "user": "keatest",
// Connection reconnect wait time.
// This parameter governs how long Kea waits before attempting
// Specifies a list of interfaces on which the Kea DHCPv6
// server should listen to the DHCP requests.
"interfaces": [
- "ethX"
+ "eth0"
],
// Boolean flag indicating if the available interfaces should
// Specifies that this shared network is selected for the
// requests received on the particular interface.
- "interface": "ethX",
+ "interface": "eth0",
// Specifies the content of the interface-id option used
// by relays to identify the interface on the relay to
// Specifies that this subnet is selected for the requests
// received on the particular interface.
- "interface": "ethX",
+ "interface": "eth0",
// Specifies the content of the interface-id option used
// by relays to identify the interface on the relay to
{ "Dhcp6":
{
-// Kea is told to listen on ethX interface only.
+// Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// We need to specify lease type. Exactly one lease-database section
{
"pools": [ { "pool": "2001:db8:1::/80" } ],
"subnet": "2001:db8:1::/64",
- "interface": "ethX"
+ "interface": "eth0"
}
],
{ "Dhcp6":
{
-// Kea is told to listen on ethX interface only.
+// Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// Let's use the simplest backend: memfile and use some reasonable values
// One packet can belong to zero or more classes.
"client-classes": [
-// The first class attempts to match all packets coming in on ethX interface.
+// The first class attempts to match all packets coming in on eth0 interface.
{
"name": "lab",
- "test": "pkt.iface == 'ethX'",
+ "test": "pkt.iface == 'eth0'",
"option-data": [{
"name": "dns-servers",
"data": "2001:db8::1"
"pools": [ { "pool": "2001:db8:1::/80" } ],
"subnet": "2001:db8:1::/64",
"client-class": "cable-modems",
- "interface": "ethX"
+ "interface": "eth0"
},
// The following subnet contains a class reservation for a client using
"duid": "01:02:03:04:05:0A:0B:0C:0D:0E",
"client-classes": [ "cable-modems" ]
} ],
- "interface": "ethX"
+ "interface": "eth0"
},
// The following subnet contains a pool with a class constraint: only
{
"pools": [
{
- "pool": "2001:db8:3::/80",
+ "pool": "2001:db8:4::/80",
"client-class": "cable-modems"
} ],
"subnet": "2001:db8:4::/64",
- "interface": "ethY"
+ "interface": "eth1"
}
],
{ "Dhcp6":
{
-// Kea is told to listen on ethX interface only.
+// Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// Let's use the simplest backend: memfile and use some reasonable values
"pools": [ { "pool": "2001:db8:1::/80" } ],
"subnet": "2001:db8:1::/64",
"client-class": "cable-modems",
- "interface": "ethX"
+ "interface": "eth0"
},
// The following subnet contains a class reservation for a client using
// DUID 01:02:03:04:05:0A:0B:0C:0D:0E. This client will always be assigned
"duid": "01:02:03:04:05:0A:0B:0C:0D:0E",
"client-classes": [ "cable-modems" ]
} ],
- "interface": "ethX",
+ "interface": "eth0",
"require-client-classes": [ "second_subnet" ]
},
// The following subnet contains a pool with a class constraint: only
{
"pools": [
{
- "pool": "2001:db8:3::/80",
+ "pool": "2001:db8:4::/80",
"client-class": "cable-modems"
} ],
"subnet": "2001:db8:4::/64",
- "interface": "ethY"
+ "interface": "eth1"
},
// This subnet is divided in two pools for unknown and known
// (i.e. which have a reservation) clients. The built-in KNOWN and
// UNKNOWN classes are set or not at host reservation lookup (KNOWN if
// this returns something, UNKNOWN if this finds nothing) and client
-//classes depending on it are evaluated.
+// classes depending on it are evaluated.
// This happens after subnet selection and before address allocation
-//from pools.
+// from pools.
{
"pools": [
{
// either "all" or "server2" will be used by this instance.
"server-tag": "server2",
- // Kea is told to listen on ethX interface only.
+ // Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// Use memfile lease database backend.
{
"interfaces-config": {
// Enable unicast
- "interfaces": [ "eno33554984/2001:db8:1:1::1" ]
+ "interfaces": [ "eth0/2001:db8:1::1" ]
},
"lease-database": {
"subnet6": [
{ "subnet": "2001:db8:1:1::/64",
- "interface": "eno33554984",
+ "interface": "eth0",
"pools": [ { "pool": "2001:db8:1:1::1:0/112" } ] }
],
"htype": 1
},
-// Kea is told to listen on ethX interface only.
+// Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// We need to specify the database used to store leases. As of
{
"pools": [ { "pool": "2001:db8:1::/80" } ],
"subnet": "2001:db8:1::/64",
- "interface": "ethX"
+ "interface": "eth0"
}
],
{ "Dhcp6":
{
-// Kea is told to listen on ethX interface only.
+// Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// We need to specify the database used to store leases. As of
"delegated-len": 64
}
],
- "interface": "ethX"
+ "interface": "eth0"
}
],
{ "Dhcp6":
{
-// Kea is told to listen on ethX interface only.
+// Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// Control socket is required for communication between the Control
}
],
- "interface": "ethX"
+ "interface": "eth0"
}
],
{"Dhcp6":
{
-// Kea is told to listen on the ethX interface only.
+// Kea is told to listen on the eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// Set up the storage for leases.
"user-context": { "charging": true }
} ],
"subnet": "2001:db8:1::/64",
- "interface": "ethX"
+ "interface": "eth0"
}
],
// Mandatory part of the config that list interfaces on which
// Kea will listen for incoming traffic.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// Two classes are migrated form ISC-DHCP example:
{ "Dhcp6":
{
-// Kea is told to listen on ethX interface only.
+// Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// We need to specify the database used to store leases. As of
{
"pools": [ { "pool": "2001:db8:1::/80" } ],
"subnet": "2001:db8:1::/64",
- "interface": "ethX"
+ "interface": "eth0"
}
],
{ "Dhcp6":
{
-// Kea is told to listen on ethX interface only.
+// Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// We need to specify the database used to store leases. As of
}
],
"subnet": "2001:db8:1::/64",
- "interface": "ethX"
+ "interface": "eth0"
}
],
{ "Dhcp6":
{
-// Kea is told to listen on ethX interface only.
+// Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// We need to specify the database used to store leases. As of
"type": "mysql",
"reconnect-wait-time": 3000, // expressed in ms
"max-reconnect-tries": 3,
- "name": "kea",
- "user": "kea",
- "password": "kea",
+ "name": "keatest",
+ "user": "keatest",
+ "password": "keatest",
"host": "localhost",
"port": 3306,
"readonly": true,
"delegated-len": 64
}
],
- "interface": "ethX",
+ "interface": "eth0",
"id": 1
}
],
{ "Dhcp6":
{
-// Kea is told to listen on ethX interface only.
+// Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// We need to specify the database used to store leases. As of
"type": "postgresql",
"reconnect-wait-time": 3000, // expressed in ms
"max-reconnect-tries": 3,
- "name": "kea",
- "user": "kea",
- "password": "kea",
+ "name": "keatest",
+ "user": "keatest",
+ "password": "keatest",
"host": "localhost"
}
],
"delegated-len": 64
}
],
- "interface": "ethX",
+ "interface": "eth0",
"id": 1
}
],
// 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
+// over eth0 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.
+// Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// We need to specify the database used to store leases. As of
"delegated-len": 64
}
],
- "interface": "ethX",
+ "interface": "eth0",
// Host reservations. Define several reservations, note that
// they are all within the range of the pool of the dynamically
{ "Dhcp6":
{
-// Kea is told to listen on ethX interface only.
+// Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// We need to specify the database used to store leases. As of
// initial proposal was not best and way to migrate to something else.
{
"Dhcp6": {
- // Kea is told to listen on ethX interface only.
+ // Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// You also need to tell where to store lease information.
{
"pools": [ { "pool": "2001:db8:2::/80" } ],
"subnet": "2001:db8:2::/64",
- "interface": "ethX"
+ "interface": "eth0"
}
],
// Ignored when reservations-in-subnet is false.
"reservations-out-of-pool": false,
"subnet": "2001:db8:1::/64",
- "pools": [ { "pool": "2001:db8:1:abcd::/64" } ],
+ "pools": [ { "pool": "2001:db8:1:0:abcd::/80" } ],
"valid-lifetime": 40
},
// This is an example configuration file for DHCPv6 server in Kea.
// It's a basic scenario with one IPv6 subnet configured. It is
// assumed that one subnet (2001:db8:1::/64 is available directly
-// over ethX interface.
+// over eth0 interface.
{ "Dhcp6":
{
-// Kea is told to listen on ethX interface only.
+// Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// We need to specify the database used to store leases. As of
{
"pools": [ { "pool": "2001:db8:1::/80" } ],
"subnet": "2001:db8:1::/64",
- "interface": "ethX"
+ "interface": "eth0"
}
],
{ "Dhcp6":
{
-// Kea is told to listen on ethX interface only.
+// Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// Let's use a Memfile backend to store leases.
{
"pools": [ { "pool": "2001:db8:1::/80" } ],
"subnet": "2001:db8:1::/64",
- "interface": "ethX",
+ "interface": "eth0",
// Include MAP-E Container option for hosts connected to this subnet.
"option-data": [
{
{
"Dhcp6": {
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// This is the list of options that will be granted to all clients that ask.
{ "Dhcp6":
{
-// Kea is told to listen on ethX interface only.
+// Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// We need to specify the database used to store leases. As of
// This is an example configuration file for DHCPv6 server in Kea.
// It's a basic scenario with one IPv6 subnet configured. It is
// assumed that one subnet (2001:db8:1::/64 is available directly
-// over ethX interface.
+// over eth0 interface.
{ "Dhcp6":
{
-// Kea is told to listen on ethX interface only.
+// Kea is told to listen on eth0 interface only.
"interfaces-config": {
- "interfaces": [ "ethX" ]
+ "interfaces": [ "eth0" ]
},
// We need to specify the database used to store leases. As of
{
"pools": [ { "pool": "2001:db8:1::/80" } ],
"subnet": "2001:db8:1::/64",
- "interface": "ethX"
+ "interface": "eth0"
}
],
ControlledDhcpv4Srv::commandShutdownHandler(const string&, ConstElementPtr args) {
if (!ControlledDhcpv4Srv::getInstance()) {
LOG_WARN(dhcp4_logger, DHCP4_NOT_RUNNING);
- return(createAnswer(CONTROL_RESULT_ERROR, "Shutdown failure."));
+ return (createAnswer(CONTROL_RESULT_ERROR, "Shutdown failure."));
}
int exit_value = 0;
case isc::dhcp::Parser4Context::LEASE_DATABASE:
return isc::dhcp::Dhcp4Parser::make_MAX_ROW_ERRORS(driver.loc_);
default:
- return isc::dhcp::Dhcp4Parser::make_STRING("max_row_errors", driver.loc_);
+ return isc::dhcp::Dhcp4Parser::make_STRING("max-row-errors", driver.loc_);
}
}
if (hosts_databases) {
parameter_name = "hosts-databases";
CfgDbAccessPtr cfg_db_access = srv_config->getCfgDbAccess();
- db::DbAccessParser parser;
for (auto it : hosts_databases->listValue()) {
+ db::DbAccessParser parser;
std::string access_string;
parser.parse(access_string, it);
cfg_db_access->setHostDbAccessString(access_string);
#include <asiolink/io_address.h>
#include <cc/command_interpreter.h>
#include <config/command_mgr.h>
+#include <config_backend/base_config_backend.h>
#include <dhcp4/tests/dhcp4_test_utils.h>
#include <dhcp4/tests/dhcp4_client.h>
#include <dhcp/tests/pkt_captures.h>
#include <iostream>
#include <cstdlib>
+#include <dirent.h>
#include <arpa/inet.h>
using namespace isc::dhcp;
using namespace isc::data;
using namespace isc::asiolink;
+using namespace isc::cb;
using namespace isc::config;
using namespace isc::dhcp::test;
using namespace isc::util;
EXPECT_EQ(exp_string, std::string(buffer_string.c_str()));
}
-
// This test verifies that the destination address of the response
// message is set to giaddr, when giaddr is set to non-zero address
// in the received message.
// The local port is always DHCPv4 server port 67.
EXPECT_EQ(DHCP4_SERVER_PORT, resp->getLocalPort());
-
// No specific interface is selected as outbound interface and no specific
// local address is provided. The IfaceMgr will figure out which interface to use.
EXPECT_TRUE(resp->getLocalAddr().isV4Zero());
// query has been received.
EXPECT_EQ("eth1", resp->getIface());
EXPECT_EQ(ETH1_INDEX, resp->getIndex());
-
}
// This test verifies that the destination address of the response message
"Mandatory 'Requested IP address' option missing in DHCPDECLINE"
" sent from [hwtype=1 00:fe:fe:fe:fe:fe], cid=[no info], tid=0x4d2");
-
// Now let's add a requested address. This should not throw.
OptionDefinitionPtr req_addr_def = LibDHCP::getOptionDef(DHCP4_OPTION_SPACE,
DHO_DHCP_REQUESTED_ADDRESS);
(*test).exp_t1_, (*test).exp_t2_);
}
}
-
}
// Check that option 58 and 59 are included when calculate-tee-times
}
}
-
// This test verifies that incoming DISCOVER can be handled properly, that an
// OFFER is generated, that the response has an address and that address
// really belongs to the configured pool.
checkClientId(ack, clientid);
}
-
// This test verifies that incoming (positive) REQUEST/Renewing can be handled properly, that a
// REPLY is generated, that the response has an address and that address
// really belongs to the configured pool and that lease is actually renewed.
EXPECT_EQ(srv.server_port_, offer->getLocalPort());
}
+void
+Dhcpv4SrvTest::loadConfigFile(const string& path) {
+ CfgMgr::instance().clear();
+
+ LibDHCP::clearRuntimeOptionDefs();
+
+ IfaceMgrTestConfig test_config(true);
+
+ // Do not use DHCP4_SERVER_PORT here as 0 means don't open sockets.
+ NakedDhcpv4Srv srv(0);
+ EXPECT_EQ(0, srv.server_port_);
+
+ ConfigBackendDHCPv4Mgr::instance().registerBackendFactory("mysql",
+ [](const db::DatabaseConnection::ParameterMap&) -> ConfigBackendDHCPv4Ptr {
+ return (ConfigBackendDHCPv4Ptr());
+ });
+
+ ConfigBackendDHCPv4Mgr::instance().registerBackendFactory("postgresql",
+ [](const db::DatabaseConnection::ParameterMap&) -> ConfigBackendDHCPv4Ptr {
+ return (ConfigBackendDHCPv4Ptr());
+ });
+
+ // TimerMgr uses IO service to run asynchronous timers.
+ TimerMgr::instance()->setIOService(srv.getIOService());
+
+ // CommandMgr uses IO service to run asynchronous socket operations.
+ CommandMgr::instance().setIOService(srv.getIOService());
+
+ // LeaseMgr uses IO service to run asynchronous timers.
+ LeaseMgr::setIOService(srv.getIOService());
+
+ // HostMgr uses IO service to run asynchronous timers.
+ HostMgr::setIOService(srv.getIOService());
+
+ Parser4Context parser;
+ ConstElementPtr json;
+ ASSERT_NO_THROW(json = parser.parseFile(path, Parser4Context::PARSER_DHCP4));
+ ASSERT_TRUE(json);
+
+ // Check the logic next.
+ ConstElementPtr dhcp4 = json->get("Dhcp4");
+ ASSERT_TRUE(dhcp4);
+ ElementPtr mutable_config = boost::const_pointer_cast<Element>(dhcp4);
+ mutable_config->set(string("hooks-libraries"), Element::createList());
+ ASSERT_NO_THROW(Dhcpv4SrvTest::configure(dhcp4->str(), true, true, true, true));
+
+ LeaseMgrFactory::destroy();
+ HostMgr::create();
+
+ TimerMgr::instance()->unregisterTimers();
+
+ // Close the command socket (if it exists).
+ CommandMgr::instance().closeCommandSocket();
+
+ // CommandMgr uses IO service to run asynchronous socket operations.
+ CommandMgr::instance().setIOService(IOServicePtr());
+
+ // LeaseMgr uses IO service to run asynchronous timers.
+ LeaseMgr::setIOService(IOServicePtr());
+
+ // HostMgr uses IO service to run asynchronous timers.
+ HostMgr::setIOService(IOServicePtr());
+}
+
+void
+Dhcpv4SrvTest::checkConfigFiles() {
+ IfaceMgrTestConfig test_config(true);
+ string path = CFG_EXAMPLES;
+
+ DIR* dir = opendir(path.c_str());
+ if (!dir) {
+ return;
+ }
+
+ // Set of sorted files by name.
+ std::set<std::string> files;
+
+ for (struct dirent* dent = readdir(dir); dent; dent = readdir(dir)) {
+ std::string name(dent->d_name);
+ // Skip current and parent directory and files with no extension.
+ if (name.size() < (sizeof(".json") - 1)) {
+ continue;
+ }
+
+ // Skip non .json files.
+ if (name.substr(name.size() - (sizeof(".json") - 1)) != ".json") {
+ continue;
+ }
+ name = path + "/" + name;
+ files.emplace(name);
+ }
+
+ for (const auto& file: files) {
+ string label("Checking configuration from file: ");
+ label += file;
+ SCOPED_TRACE(label);
+ loadConfigFile(file);
+ }
+}
+
} // end of isc::dhcp::test namespace
} // end of isc::dhcp namespace
} // end of isc namespace
portsServerPort();
}
+TEST_F(Dhcpv4SrvTest, checkConfigFiles) {
+ checkConfigFiles();
+}
+
/// @todo Implement tests for subnetSelect See tests in dhcp6_srv_unittest.cc:
/// selectSubnetAddr, selectSubnetIface, selectSubnetRelayLinkaddr,
/// selectSubnetRelayInterfaceId. Note that the concept of interface-id is not
/// present in the DHCPv4, so not everything is applicable directly.
/// See ticket #3057
-
// Checks whether the server uses default (0.0.0.0) siaddr value, unless
// explicitly specified
TEST_F(Dhcpv4SrvTest, siaddrDefault) {
query->addOption(opt2);
query->getDeferredOptions().push_back(245);
-
// Create and add a PRL option to the query
OptionUint8ArrayPtr prl(new OptionUint8Array(Option::V4,
DHO_DHCP_PARAMETER_REQUEST_LIST));
EXPECT_EQ(12345678, opt32->getValue());
}
-
// Checks effect of persistency (aka always-true) flag on the PRL
TEST_F(Dhcpv4SrvTest, prlPersistency) {
IfaceMgrTestConfig test_config(true);
}
Dhcpv4SrvTest::~Dhcpv4SrvTest() {
-
// Make sure that we revert to default value
CfgMgr::instance().clear();
"dhcp-lease-time " << errmsg.str()));
}
- return (::testing::AssertionSuccess());
+ return (::testing::AssertionSuccess());
}
::testing::AssertionResult
void
Dhcpv4SrvTest::configure(const std::string& config,
const bool commit,
- const bool open_sockets) {
- configure(config, srv_, commit, open_sockets);
+ const bool open_sockets,
+ const bool create_managers,
+ const bool test) {
+ configure(config, srv_, commit, open_sockets, create_managers, test);
}
void
Dhcpv4SrvTest::configure(const std::string& config,
NakedDhcpv4Srv& srv,
const bool commit,
- const bool open_sockets) {
+ const bool open_sockets,
+ const bool create_managers,
+ const bool test) {
setenv("KEA_LFC_EXECUTABLE", KEA_LFC_EXECUTABLE, 1);
MultiThreadingCriticalSection cs;
ConstElementPtr json;
} catch (const std::exception& ex){
// Fatal failure on parsing error
FAIL() << "parsing failure:"
- << "config:" << config << std::endl
- << "error: " << ex.what();
+ << "config:" << config << std::endl
+ << "error: " << ex.what();
}
ConstElementPtr status;
configureMultiThreading(multi_threading_, json);
// Configure the server and make sure the config is accepted
- EXPECT_NO_THROW(status = configureDhcp4Server(srv, json));
+ EXPECT_NO_THROW(status = configureDhcp4Server(srv, json, test));
ASSERT_TRUE(status);
int rcode;
ConstElementPtr comment = config::parseAnswer(rcode, status);
- ASSERT_EQ(0, rcode) << comment->stringValue();
+ ASSERT_EQ(0, rcode) << "configuration failed, test is broken: "
+ << comment->str();
// Use specified lease database backend.
- ASSERT_NO_THROW( {
- CfgDbAccessPtr cfg_db = CfgMgr::instance().getStagingCfg()->getCfgDbAccess();
- cfg_db->setAppendedParameters("universe=4");
- cfg_db->createManagers();
- } );
+ if (create_managers) {
+ ASSERT_NO_THROW( {
+ CfgDbAccessPtr cfg_db = CfgMgr::instance().getStagingCfg()->getCfgDbAccess();
+ cfg_db->setAppendedParameters("universe=4");
+ cfg_db->createManagers();
+ } );
+ }
try {
CfgMultiThreading::apply(CfgMgr::instance().getStagingCfg()->getDHCPMultiThreading());
/// @file dhcp4_test_utils.h
///
-/// @brief This file contains utility classes used for DHCPv4 server testing
+/// @brief This file contains utility classes used for DHCPv4 server testing
#ifndef DHCP4_TEST_UTILS_H
#define DHCP4_TEST_UTILS_H
/// @param config String holding server configuration in JSON format.
/// @param commit A boolean flag indicating if the new configuration
/// should be committed (if true), or not (if false).
- /// @param open_sockets A boolean flag indicating if sockets should
+ /// @param open_sockets A boolean flag indicating if sockets should
/// be opened (if true), or not (if false).
+ /// @param create_managers A boolean flag indicating if managers should be
+ /// recreated.
+ /// @param test A boolean flag which indicates if only testing config.
void configure(const std::string& config,
const bool commit = true,
- const bool open_sockets = true);
+ const bool open_sockets = true,
+ const bool create_managers = true,
+ const bool test = false);
/// @brief Configure specified DHCP server using JSON string.
///
/// @param srv Instance of the server to be configured.
/// @param commit A boolean flag indicating if the new configuration
/// should be committed (if true), or not (if false).
- /// @param open_sockets A boolean flag indicating if sockets should
+ /// @param open_sockets A boolean flag indicating if sockets should
/// be opened (if true), or not (if false).
+ /// @param create_managers A boolean flag indicating if managers should be
+ /// recreated.
+ /// @param test A boolean flag which indicates if only testing config.
void configure(const std::string& config,
NakedDhcpv4Srv& srv,
const bool commit = true,
- const bool open_sockets = true);
+ const bool open_sockets = true,
+ const bool create_managers = true,
+ const bool test = false);
/// @brief Configure specified DHCP server using JSON string.
///
/// @brief Checks if client port can be overridden in packets being sent.
void portsClientPort();
- /// @brief Checks if server port can be overridden in packets being sent.
+ /// @brief Checks if server port can be overridden in packets being sent.
void portsServerPort();
+ /// @breif Check if example files contain valid configuration.
+ void checkConfigFiles();
+
+ /// @brief Check if the server configuration stored in file is valid.
+ ///
+ /// @param path The path to the configuration file.
+ void loadConfigFile(const std::string& path);
+
/// @brief This function cleans up after the test.
virtual void TearDown();
ControlledDhcpv6Srv::commandShutdownHandler(const string&, ConstElementPtr args) {
if (!ControlledDhcpv6Srv::getInstance()) {
LOG_WARN(dhcp6_logger, DHCP6_NOT_RUNNING);
- return(createAnswer(CONTROL_RESULT_ERROR, "Shutdown failure."));
+ return (createAnswer(CONTROL_RESULT_ERROR, "Shutdown failure."));
}
int exit_value = 0;
case isc::dhcp::Parser6Context::LEASE_DATABASE:
return isc::dhcp::Dhcp6Parser::make_MAX_ROW_ERRORS(driver.loc_);
default:
- return isc::dhcp::Dhcp6Parser::make_STRING("max_row_errors", driver.loc_);
+ return isc::dhcp::Dhcp6Parser::make_STRING("max-row-errors", driver.loc_);
}
}
if (hosts_databases) {
parameter_name = "hosts-databases";
CfgDbAccessPtr cfg_db_access = srv_config->getCfgDbAccess();
- db::DbAccessParser parser;
for (auto it : hosts_databases->listValue()) {
+ db::DbAccessParser parser;
std::string access_string;
parser.parse(access_string, it);
cfg_db_access->setHostDbAccessString(access_string);
#include <config.h>
#include <asiolink/io_address.h>
+#include <cc/command_interpreter.h>
+#include <config/command_mgr.h>
+#include <config_backend/base_config_backend.h>
#include <dhcp/dhcp6.h>
#include <dhcp/duid.h>
#include <dhcp/option.h>
#include <dhcp/option_int_array.h>
#include <dhcp/option_string.h>
#include <dhcp/iface_mgr.h>
-#include <dhcp6/json_config_parser.h>
#include <dhcp/docsis3_option_defs.h>
#include <dhcp/tests/iface_mgr_test_config.h>
#include <dhcpsrv/cfgmgr.h>
#include <dhcpsrv/lease_mgr_factory.h>
#include <dhcpsrv/host_mgr.h>
#include <dhcpsrv/utils.h>
+#include <dhcp6/json_config_parser.h>
#include <util/buffer.h>
#include <util/range_utilities.h>
#include <util/encode/hex.h>
#include <dhcp6/tests/dhcp6_test_utils.h>
#include <dhcp6/tests/dhcp6_client.h>
#include <dhcp/tests/pkt_captures.h>
-#include <cc/command_interpreter.h>
#include <boost/pointer_cast.hpp>
#include <boost/scoped_ptr.hpp>
#include <fstream>
#include <iostream>
#include <sstream>
+#include <dirent.h>
using namespace isc;
-using namespace isc::data;
using namespace isc::asiolink;
+using namespace isc::cb;
+using namespace isc::config;
+using namespace isc::data;
using namespace isc::dhcp;
using namespace isc::dhcp::test;
using namespace isc::util;
"}"
};
+} // namespace
+
+namespace isc {
+namespace dhcp {
+namespace test {
+
+void
+Dhcpv6SrvTest::loadConfigFile(const string& path) {
+ CfgMgr::instance().clear();
+
+ LibDHCP::clearRuntimeOptionDefs();
+
+ IfaceMgrTestConfig test_config(true);
+
+ // Do not use DHCP6_SERVER_PORT here as 0 means don't open sockets.
+ NakedDhcpv6Srv srv(0);
+ EXPECT_EQ(0, srv.server_port_);
+
+ ConfigBackendDHCPv6Mgr::instance().registerBackendFactory("mysql",
+ [](const db::DatabaseConnection::ParameterMap&) -> ConfigBackendDHCPv6Ptr {
+ return (ConfigBackendDHCPv6Ptr());
+ });
+
+ ConfigBackendDHCPv6Mgr::instance().registerBackendFactory("postgresql",
+ [](const db::DatabaseConnection::ParameterMap&) -> ConfigBackendDHCPv6Ptr {
+ return (ConfigBackendDHCPv6Ptr());
+ });
+
+ // TimerMgr uses IO service to run asynchronous timers.
+ TimerMgr::instance()->setIOService(srv.getIOService());
+
+ // CommandMgr uses IO service to run asynchronous socket operations.
+ CommandMgr::instance().setIOService(srv.getIOService());
+
+ // LeaseMgr uses IO service to run asynchronous timers.
+ LeaseMgr::setIOService(srv.getIOService());
+
+ // HostMgr uses IO service to run asynchronous timers.
+ HostMgr::setIOService(srv.getIOService());
+
+ Parser6Context parser;
+ ConstElementPtr json;
+ ASSERT_NO_THROW(json = parser.parseFile(path, Parser6Context::PARSER_DHCP6));
+ ASSERT_TRUE(json);
+
+ // Check the logic next.
+ ConstElementPtr dhcp6 = json->get("Dhcp6");
+ ASSERT_TRUE(dhcp6);
+ ElementPtr mutable_config = boost::const_pointer_cast<Element>(dhcp6);
+ mutable_config->set(string("hooks-libraries"), Element::createList());
+ ASSERT_NO_THROW(Dhcpv6SrvTest::configure(dhcp6->str(), true, true, true, true));
+
+ LeaseMgrFactory::destroy();
+ HostMgr::create();
+
+ TimerMgr::instance()->unregisterTimers();
+
+ // Close the command socket (if it exists).
+ CommandMgr::instance().closeCommandSocket();
+
+ // CommandMgr uses IO service to run asynchronous socket operations.
+ CommandMgr::instance().setIOService(IOServicePtr());
+
+ // LeaseMgr uses IO service to run asynchronous timers.
+ LeaseMgr::setIOService(IOServicePtr());
+
+ // HostMgr uses IO service to run asynchronous timers.
+ HostMgr::setIOService(IOServicePtr());
+}
+
+void
+Dhcpv6SrvTest::checkConfigFiles() {
+ IfaceMgrTestConfig test_config(true);
+ string path = CFG_EXAMPLES;
+
+ DIR* dir = opendir(path.c_str());
+ if (!dir) {
+ return;
+ }
+
+ // Set of sorted files by name.
+ std::set<std::string> files;
+
+ for (struct dirent* dent = readdir(dir); dent; dent = readdir(dir)) {
+ std::string name(dent->d_name);
+ // Skip current and parent directory and files with no extension.
+ if (name.size() < (sizeof(".json") - 1)) {
+ continue;
+ }
+
+ // Skip non .json files.
+ if (name.substr(name.size() - (sizeof(".json") - 1)) != ".json") {
+ continue;
+ }
+ name = path + "/" + name;
+ files.emplace(name);
+ }
+
+ for (const auto& file: files) {
+ string label("Checking configuration from file: ");
+ label += file;
+ SCOPED_TRACE(label);
+ loadConfigFile(file);
+ }
+}
+
+} // end of isc::dhcp::test namespace
+} // end of isc::dhcp namespace
+} // end of isc namespace
+
+namespace {
+
// This test verifies that incoming SOLICIT can be handled properly when
// there are no subnets configured.
//
// more checks to be implemented
}
-
// There are no dedicated tests for Dhcpv6Srv::handleIA_NA and Dhcpv6Srv::assignLeases
// as they are indirectly tested in Solicit and Request tests.
// - server-id
// - IA that includes IAPREFIX
TEST_F(Dhcpv6SrvTest, pdSolicitBasic) {
-
NakedDhcpv6Srv srv(0);
Pkt6Ptr sol = Pkt6Ptr(new Pkt6(DHCPV6_SOLICIT, 1234));
// - server-id
// - IA that includes IAPREFIX
TEST_F(Dhcpv6SrvTest, pdRequestBasic) {
-
NakedDhcpv6Srv srv(0);
// Let's create a REQUEST
// Check that the server is testing if server identifier received in the
// query, matches server identifier used by the server.
TEST_F(Dhcpv6SrvTest, testServerID) {
- NakedDhcpv6Srv srv(0);
+ NakedDhcpv6Srv srv(0);
- Pkt6Ptr req = Pkt6Ptr(new Pkt6(DHCPV6_REQUEST, 1234));
+ Pkt6Ptr req = Pkt6Ptr(new Pkt6(DHCPV6_REQUEST, 1234));
std::vector<uint8_t> bin;
// duid_llt constructed with: time = 0, macaddress = 00:00:00:00:00:00
<< static_cast<int>(allowed_unicast[i])
<< "being sent to unicast address";
}
-
-
}
// This test verifies if selectSubnet() selects proper subnet for a given
// Checks if server responses are sent to the proper port.
TEST_F(Dhcpv6SrvTest, portsClientPort) {
-
NakedDhcpv6Srv srv(0);
// Enforce a specific client port value.
// Checks if server responses are sent to the proper port.
TEST_F(Dhcpv6SrvTest, portsServerPort) {
-
// Create the test server in test mode.
NakedDhcpv6Srv srv(0);
// Checks if server responses are sent to the proper port.
TEST_F(Dhcpv6SrvTest, portsDirectTraffic) {
-
NakedDhcpv6Srv srv(0);
// Let's create a simple SOLICIT
// Checks if server responses are sent to the proper port.
TEST_F(Dhcpv6SrvTest, portsRelayedTraffic) {
-
NakedDhcpv6Srv srv(0);
// Let's create a simple SOLICIT
// Test that the server processes relay-source-port option correctly.
TEST_F(Dhcpv6SrvTest, relaySourcePort) {
-
NakedDhcpv6Srv srv(0);
string config =
// @todo Uncomment this test as part of #3180 work.
// Kea code currently fails to handle docsis traffic.
TEST_F(Dhcpv6SrvTest, docsisTraffic) {
-
NakedDhcpv6Srv srv(0);
// Let's get a traffic capture from DOCSIS3.0 modem
ASSERT_TRUE(adv);
}
-
// Checks if relay IP address specified in the relay-info structure in
// subnet6 is being used properly.
TEST_F(Dhcpv6SrvTest, relayOverride) {
// Checks if user-contexts are parsed properly.
TEST_F(Dhcpv6SrvTest, userContext) {
-
IfaceMgrTestConfig test_config(true);
NakedDhcpv6Srv srv(0);
}
}
+TEST_F(Dhcpv6SrvTest, checkConfigFiles) {
+ checkConfigFiles();
+}
+
/// @todo: Add more negative tests for processX(), e.g. extend sanityCheck() test
/// to call processX() methods.
#include <gtest/gtest.h>
#include <cc/command_interpreter.h>
#include <dhcp/option6_status_code.h>
+#include <dhcp/tests/pkt_captures.h>
+#include <dhcpsrv/cfg_multi_threading.h>
#include <dhcp6/tests/dhcp6_test_utils.h>
#include <dhcp6/json_config_parser.h>
-#include <dhcp/tests/pkt_captures.h>
#include <log/logger_support.h>
-#include <dhcpsrv/cfg_multi_threading.h>
-#include <util/pointer_util.h>
#include <stats/stats_mgr.h>
+#include <util/pointer_util.h>
#include <cstdio>
#include <sstream>
#include <string.h>
return (lease);
}
-
Pkt6Ptr
Dhcpv6SrvTest::createMessage(uint8_t message_type, Lease::Type lease_type,
const IOAddress& addr, const uint8_t prefix_len,
}
void
-Dhcpv6SrvTest::configure(const std::string& config) {
- configure(config, srv_);
+Dhcpv6SrvTest::configure(const std::string& config,
+ const bool commit,
+ const bool open_sockets,
+ const bool create_managers,
+ const bool test) {
+ configure(config, srv_, commit, open_sockets, create_managers, test);
}
void
-Dhcpv6SrvTest::configure(const std::string& config, NakedDhcpv6Srv& srv) {
+Dhcpv6SrvTest::configure(const std::string& config,
+ NakedDhcpv6Srv& srv,
+ const bool commit,
+ const bool open_sockets,
+ const bool create_managers,
+ const bool test) {
setenv("KEA_LFC_EXECUTABLE", KEA_LFC_EXECUTABLE, 1);
MultiThreadingCriticalSection cs;
ConstElementPtr json;
json = parseJSON(config);
} catch (const std::exception& ex) {
// Fatal failure on parsing error
- FAIL() << "config parsing failed, test is broken: " << ex.what();
+ FAIL() << "parsing failure:"
+ << "config:" << config << std::endl
+ << "error: " << ex.what();
}
ConstElementPtr status;
configureMultiThreading(multi_threading_, json);
// Configure the server and make sure the config is accepted
- EXPECT_NO_THROW(status = configureDhcp6Server(srv, json));
+ EXPECT_NO_THROW(status = configureDhcp6Server(srv, json, test));
ASSERT_TRUE(status);
int rcode;
ConstElementPtr comment = isc::config::parseAnswer(rcode, status);
ASSERT_EQ(0, rcode) << "configuration failed, test is broken: "
<< comment->str();
+ // Use specified lease database backend.
+ if (create_managers) {
+ ASSERT_NO_THROW( {
+ CfgDbAccessPtr cfg_db = CfgMgr::instance().getStagingCfg()->getCfgDbAccess();
+ cfg_db->setAppendedParameters("universe=6");
+ cfg_db->createManagers();
+ } );
+ }
+
try {
CfgMultiThreading::apply(CfgMgr::instance().getStagingCfg()->getDHCPMultiThreading());
} catch (const std::exception& ex) {
<< ex.what();
}
- CfgMgr::instance().commit();
+ if (commit) {
+ CfgMgr::instance().commit();
+ }
+
+ // Opening sockets.
+ if (open_sockets) {
+ IfaceMgr::instance().openSockets6();
+ }
}
NakedDhcpv6SrvTest::NakedDhcpv6SrvTest()
/// @file dhcp6_test_utils.h
///
-/// @brief This file contains utility classes used for DHCPv6 server testing
+/// @brief This file contains utility classes used for DHCPv6 server testing
#ifndef DHCP6_TEST_UTILS_H
#define DHCP6_TEST_UTILS_H
#include <gtest/gtest.h>
+#include <dhcp6/dhcp6_srv.h>
+#include <dhcp6/parser_context.h>
#include <dhcp/pkt6.h>
#include <dhcp/option6_ia.h>
#include <dhcp/option6_iaaddr.h>
#include <dhcpsrv/cfgmgr.h>
#include <dhcpsrv/lease_mgr.h>
#include <dhcpsrv/lease_mgr_factory.h>
-#include <dhcp6/dhcp6_srv.h>
-#include <dhcp6/parser_context.h>
#include <hooks/hooks_manager.h>
#include <util/multi_threading_mgr.h>
ValueType value_;
};
-
/// @brief Class representing strongly typed IAID.
struct IAID : public SpecializedTypeWrapper<uint32_t> {
/// @brief Constructor
/// @brief Class representing strongly typed value for strict IAID checks.
///
-/// Strict IAID checks are used to verify that the particular address has been
+/// Strict IAID checks are used to verify that the particular address has been
/// assign to a specific IA. In many cases we don't check that because it may
/// not be possible to predict to which IA the specific lease will be assigned.
struct StrictIAIDChecking : public SpecializedTypeWrapper<bool> {
}
};
-
/// @brief Base class for DHCPv6 server testing.
///
/// Currently it configures the test data path directory in
/// @brief Holds the original data directory.
std::string original_datadir_;
-
};
/// @brief "naked" Dhcpv6Srv class that exposes internal members
/// @brief Generate binary data option
///
/// Creates an Option in the V6 space with the given type and binary data
- /// of the given number of bytes. The data is initialized to the values
+ /// of the given number of bytes. The data is initialized to the values
/// 100 to 100 + n, where n is the desired number of bytes.
///
/// @param type option type for the new option
/// @brief Runs DHCPv6 configuration from the JSON string.
///
/// @param config String holding server configuration in JSON format.
- void configure(const std::string& config);
+ /// @param commit A boolean flag indicating if the new configuration
+ /// should be committed (if true), or not (if false).
+ /// @param open_sockets A boolean flag indicating if sockets should
+ /// be opened (if true), or not (if false).
+ /// @param create_managers A boolean flag indicating if managers should be
+ /// recreated.
+ /// @param test A boolean flag which indicates if only testing config.
+ void configure(const std::string& config,
+ const bool commit = true,
+ const bool open_sockets = false,
+ const bool create_managers = true,
+ const bool test = false);
/// @brief Configure the DHCPv6 server using the JSON string.
///
/// @param config String holding server configuration in JSON format.
/// @param srv Server to be configured.
- void configure(const std::string& config, NakedDhcpv6Srv& srv);
+ /// @param commit A boolean flag indicating if the new configuration
+ /// should be committed (if true), or not (if false).
+ /// @param open_sockets A boolean flag indicating if sockets should
+ /// be opened (if true), or not (if false).
+ /// @param create_managers A boolean flag indicating if managers should be
+ /// recreated.
+ /// @param test A boolean flag which indicates if only testing config.
+ void configure(const std::string& config,
+ NakedDhcpv6Srv& srv,
+ const bool commit = true,
+ const bool open_sockets = false,
+ const bool create_managers = true,
+ const bool test = false);
/// @brief Checks that server response (ADVERTISE or REPLY) contains proper
/// IA_NA option
checkIA_PD(const isc::dhcp::Pkt6Ptr& rsp, uint32_t expected_iaid,
uint32_t expected_t1, uint32_t expected_t2);
-
// Check that generated IAADDR option contains expected address
// and lifetime values match the configured subnet
/// @param expected_pref check that lease preferedlifetime has the not-zero
uint32_t expected_pref = 0,
uint32_t expected_valid = 0) {
-
// Check that the assigned address is indeed from the configured pool.
// Note that when comparing addresses, we compare the textual
// representation. IOAddress does not support being streamed to
/// @brief Performs negative RELEASE test
///
/// See releaseReject and pdReleaseReject tests for detailed
- /// explanation. In essence the test attempts to perform couple
+ /// explanation. In essence the test attempts to perform couple
/// failed RELEASE scenarios.
///
/// This method does not throw, but uses gtest macros to signify failures.
multi_threading_ = enabled;
}
+ /// @breif Check if example files contain valid configuration.
+ void checkConfigFiles();
+
+ /// @brief Check if the server configuration stored in file is valid.
+ ///
+ /// @param path The path to the configuration file.
+ void loadConfigFile(const std::string& path);
+
/// A subnet used in most tests.
isc::dhcp::Subnet6Ptr subnet_;
// Reconfigure the server. Now, the first client get's second client's
// reservation and vice versa.
- ASSERT_NO_FATAL_FAILURE(configure(NETWORKS_CONFIG[5], *client1.getServer()));
+ ASSERT_NO_FATAL_FAILURE(configure(NETWORKS_CONFIG[5], *client1.getServer(), true, true, false));
// The first client is trying to renew the lease but should get a different lease
// because its lease is now reserved for some other client. The client won't be
"{",
" \"command\": \"lease6-del\",",
" \"arguments\": {",
- " \"ip-address\": \"192.0.2.202\"",
+ " \"ip-address\": \"2001:db8::3\"",
" }",
"}"
],
projects / thirdparty / kea.git / commitdiff
