From: Marcin Siodelski Date: Wed, 22 May 2019 11:06:56 +0000 (+0200) Subject: [#71,!314] Added CB section for the DHCPv6 server. X-Git-Tag: Kea-1.6.0-beta~56 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=1c008c4abaf1520485f33a687efee6d356b7174e;p=thirdparty%2Fkea.git [#71,!314] Added CB section for the DHCPv6 server. --- diff --git a/doc/guide/dhcp4-srv.xml b/doc/guide/dhcp4-srv.xml index 887d300e6f..066336c0de 100644 --- a/doc/guide/dhcp4-srv.xml +++ b/doc/guide/dhcp4-srv.xml @@ -5589,7 +5589,7 @@ autogenerated IDs are not stable across configuration changes. section focuses on the usage of the CB with the DHCPv4 server. It lists the supported parameters, describes limitations and gives examples of the DHCPv4 server configuration to take advantage of the CB. Please also refer - to the sibling section for the + to the sibling section for the DHCPv6 specific usage of the CB. @@ -5630,7 +5630,7 @@ autogenerated IDs are not stable across configuration changes. - List of DHCPv4 Options Supported by the Configuration Backend + List of DHCPv4 Parameters Supported by the Configuration Backend diff --git a/doc/guide/dhcp6-srv.xml b/doc/guide/dhcp6-srv.xml index ec0610dabf..a383bd3e32 100644 --- a/doc/guide/dhcp6-srv.xml +++ b/doc/guide/dhcp6-srv.xml @@ -5643,4 +5643,144 @@ autogenerated IDs are not stable across configuration changes. +
+ Configuration Backend in DHCPv6 + + In the section we have introduced the + Configuration Backend feature, its applicability and limitations. This + section focuses on the usage of the CB with the DHCPv6 server. It lists + the supported parameters, describes limitations and gives examples of the + DHCPv6 server configuration to take advantage of the CB. Please also refer + to the sibling section for the + DHCPv4 specific usage of the CB. + + +
+ Supported Parameters + The ultimate goal for the CB is to serve as a central configuration + repository for one or multiple Kea servers connected to the database. + In the future it will be possible to store the most of the server configuration + in the database and it will be possible to reduce the configuration file + to a minimum, i.e. the only mandatory part of the configuration file will be + the config-control parameter which specifies the + neccessary information to connect to the database. In the Kea 1.6.0 release, + however, only the subset of the DHCPv6 server parameters can be stored + in the database. All other parameters must be specified in the JSON + configuration file, if required. + + The following table lists DHCPv6 specific parameters supported by + the Configuration Backend with an indication on which level of the + hierarchy it is currently supported. The "n/a" tag is used in cases + when the particular parameter is not applicable on the particular + level of the hierarchy on in cases when the parameter is not supported + by the server on this level of hierarchy. The "no" tag is used when + the parameter is supported by the server on the particular level of + hierarchy but is not configurable via the Configuration Backend. + + + All supported parameters can be configured via cb_cmds + hooks library described in the . The + general rule is that the scalar global parameters are set using the + remote-global-parameter6-set. The shared network + specific parameters are set using the remote-network6-set. + Finally, the subnet and pool level parameters are set using the + remote-subnet6-set. Whenever there is an exception from + this general rule, it is highlighted in the table. The non-scalar global + parameters have dedicated commands, e.g. modifying the global DHCPv6 options + (option-data) is performed using the + remote-option6-global-set. + + + +
+ List of DHCPv6 Parameters Supported by the Configuration Backend + + + + + + + + + + Parameter + Global + Shared Network + Subnet + Pool + Prefix Delegation Pool + + + calculate-tee-timesyesyesyesn/an/a + client-classn/ayesyesnono + decline-probation-periodyesn/an/an/an/a + dhcp4o6-portyesn/an/an/an/a + interfacen/ayesyesn/an/a + interface-idn/ayesyesn/an/a + option-datayes (via remote-option6-global-set)yesyesyesyes + option-defyes (via remote-option-def6-set)n/an/an/an/a + preferred-lifetimeyesyesyesn/an/a + rapid-commityesyesyesn/an/a + rebind-timeryesyesyesn/an/a + relayn/ayesyesn/an/a + renew-timeryesyesyesn/an/a + require-client-classesn/ayesyesnono + reservation-modeyesyesyesn/an/a + t1-percentyesyesyesn/an/a + t2-percentyesyesyesn/an/a + valid-lifetimeyesyesyesn/an/a + + + + +
+ + + +
+ Enabling Configuration Backend + + The following configuration snippet demonstrates how to enable the MySQL + Configuration Backend for the DHCPv6 server: + + +{ + "Dhcp6": { + "config-control": { + "config-databases": [ + { + "type": "mysql", + "name": "kea", + "user": "kea", + "password": "kea", + "host": "2001:db8:1::1", + "port": 3302 + } + ], + "config-fetch-wait-time": 30 + }, + "hooks-libraries": [ + { + "library": "/usr/local/lib/kea/hooks/libdhcp_mysql_cb.so" + }, + { + "library": "/usr/local/lib/kea/hooks/libdhcp_cb_cmds.so" + } + ], + ... + } +} + + + + + The configuration structure is almost identical as for the DHCPv4 + server (see for the detailed description). + + +
+ + +