3.6. Configuring loggers in Kea

Procedure

1. If you are configuring an IPv4 network:

   1. Edit the /etc/kea/kea-dhcp4.conf file, and add the loggers configuration to the Dhcp4 parameter. For example:

      {
        "Dhcp4": {
          ...,
          "loggers":[
            {
              "name":"kea-dhcp4",
              "output-options":[
                 {
                  "output":"kea-dhcp4.log",
                  "maxsize":104857600,
                  "maxver":5
                 }
              ],
              "severity":"INFO",
            }
          ],
          ...

      The settings specified in the example are:

      name

      Defines the name of the binary the logger settings apply to.

      output

      Sets the log file name in the /var/lib/kea/ directory.

      maxsize

      Sets the maximum size of the log file before Kea rotates it. The default value is 10240000 bytes.

      maxver

      Sets the maximum number of rotated versions Kea will keep. Note that a maxsize value less than 204800 bytes disables rotation.

      severity

      Specifies the category of messages logged. You can set one of the following values: NONE, FATAL, ERROR, WARN, INFO, and DEBUG. Kea logs only messages of the configured severity and above.

   2. Verify the syntax of the configuration file:

      # kea-dhcp4 -t /etc/kea/kea-dhcp4.conf

      If the command returns Syntax check failed, fix the errors shown in the report.

   3. Restart the kea-dhcp4 service:

      # systemctl restart kea-dhcp4

2. If you are configuring an IPv6 network:

   1. Edit the /etc/kea/kea-dhcp6.conf file, and add the loggers configuration to the Dhcp6 parameter, for example:

      {
        "Dhcp6": {
          ...,
          "loggers":[
            {
              "name":"kea-dhcp6",
              "output-options":[
                 {
                  "output":"kea-dhcp6.log",
                  "maxsize":104857600,
                  "maxver":5
                 }
              ],
              "severity":"INFO",
            }
          ],
          ...

   2. Verify the syntax of the configuration file:

      # kea-dhcp6 -t /etc/kea/kea-dhcp6.conf

      If the command returns Syntax check failed, fix the errors shown in the report.

   3. Restart the kea-dhcp6 service:

      # systemctl restart kea-dhcp6