[3427] Examples updated.

doc/Makefile.am

@@ -4,6 +4,7 @@ EXTRA_DIST = version.ent.in differences.txt Doxyfile Doxyfile-xml
 
 nobase_dist_doc_DATA  = examples/kea4/single-subnet.json
 nobase_dist_doc_DATA += examples/kea4/several-subnets.json
+nobase_dist_doc_DATA += examples/kea6/simple.json
 nobase_dist_doc_DATA += examples/kea6/several-subnets.json
 
 devel:

doc/examples/kea4/several-subnets.json

@@ -4,7 +4,7 @@
 
 { "Dhcp4":
 
-{ 
+{
 # Kea is told to listen on eth0 interface only.
   "interfaces": [ "eth0" ],
 
@@ -26,13 +26,30 @@
 
 # The following list defines subnets. Each subnet consists of at
 # least subnet and pool entries.
-  "subnet4": [ 
+  "subnet4": [
   {    "pool": [ "192.0.2.1 - 192.0.2.200" ],
        "subnet": "192.0.2.0/24"  },
   {    "pool": [ "192.0.3.100 - 192.0.3.200" ],
        "subnet": "192.0.3.0/24"  },
   {    "pool": [ "192.0.4.1 - 192.0.4.254" ],
        "subnet": "192.0.4.0/24"  } ]
+},
+
+# The following configures logging. Kea will log all debug messages
+# to /var/log/kea-debug.log file.
+"Logging": {
+    "loggers": [
+        {
+            "name": "kea",
+            "output_options": [
+                {
+                    "output": "/var/log/kea-debug.log"
+                }
+            ],
+            "debuglevel": 99,
+            "severity": "DEBUG"
+        }
+    ]
 }
 
 }

doc/examples/kea4/single-subnet.json

@@ -4,7 +4,7 @@
 
 { "Dhcp4":
 
-{ 
+{
 # Kea is told to listen on eth0 interface only.
   "interfaces": [ "eth0" ],
 
@@ -30,10 +30,27 @@
 #  "rebind-timer": 2000,
 
 # The following list defines subnets. We have only one subnet
-# here.
+# here. We tell Kea that it is directly available over local interface.
-  "subnet4": [ 
+  "subnet4": [
   {    "pool": [ "192.0.2.1 - 192.0.2.200" ],
-       "subnet": "192.0.2.0/24"  } ]
+       "subnet": "192.0.2.0/24",
+       "interface": "eth0"  } ]
+},
+
+# The following configures logging. It assumes that messages with at least
+# informational level (info, warn, error) will will be logged to stdout.
+"Logging": {
+    "loggers": [
+        {
+            "name": "kea",
+            "output_options": [
+                {
+                    "output": "stdout"
+                }
+            ],
+            "severity": "INFO"
+        }
+    ]
 }
 
 }

doc/examples/kea6/several-subnets.json

@@ -4,7 +4,7 @@
 
 { "Dhcp6":
 
-{ 
+{
 # Kea is told to listen on eth0 interface only.
   "interfaces": [ "eth0" ],
 
@@ -28,16 +28,31 @@
 
 # The following list defines subnets. Each subnet consists of at
 # least subnet and pool entries.
-  "subnet6": [ 
+  "subnet6": [
   {    "pool": [ "2001:db8:1::/80" ],
        "subnet": "2001:db8:1::/64"  },
   {    "pool": [ "2001:db8:2::/80" ],
-       "subnet": "2001:db8:2::/64"  }, 
+       "subnet": "2001:db8:2::/64"  },
   {    "pool": [ "2001:db8:3::/80" ],
        "subnet": "2001:db8:3::/64"  },
   {    "pool": [ "2001:db8:4::/80" ],
        "subnet": "2001:db8:4::/64"  } ]
-}
+},
 
+# The following configures logging. It assumes that warning messages
+# will be logged to stdout.
+"Logging": {
+    "loggers": [
+        {
+            "name": "kea",
+            "output_options": [
+                {
+                    "output": "stdout"
+                }
+            ],
+            "severity": "WARN"
+        }
+    ]
 }
 
+}

doc/examples/kea6/simple.json

@@ -0,0 +1,59 @@
+# This is an example configuration file for DHCPv6 server in Kea.
+# It's a basic scenario with four IPv6 subnets configured. It is
+# assumed that one subnet (2001:db8:1::/64 is available directly
+# over eth0 interface.
+
+{ "Dhcp6":
+
+{ 
+# Kea is told to listen on eth0 interface only.
+  "interfaces": [ "eth0" ],
+
+# 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"
+  },
+
+# Addresses will be assigned with preferred and valid lifetimes
+# being 3000 and 4000, respectively. Client is told to start
+# renewing after 1000 seconds. If the server does not repond
+# after 2000 seconds since the lease was granted, client is supposed
+# to start REBIND procedure (emergency renewal that allows switching
+# to a different server).
+  "preferred-lifetime": 3000,
+  "valid-lifetime": 4000,
+  "renew-timer": 1000,
+  "rebind-timer": 2000,
+
+# The following list defines subnets. Each subnet consists of at
+# least subnet and pool entries.
+  "subnet6": [ 
+    {
+      "pool": [ "2001:db8:1::/80" ],
+      "subnet": "2001:db8:1::/64",
+      "interface": "eth0"
+    }
+  ]
+},
+
+# The following configures logging. Kea will log all debug messages
+# to /var/log/kea-debug.log file.
+"Logging": {
+    "loggers": [
+        {
+            "name": "kea",
+            "output_options": [
+                {
+                    "output": "/var/log/kea-debug.log"
+                }
+            ], 
+            "debuglevel": 99,
+            "severity": "DEBUG"
+        }
+    ]
+}
+
+}
+

doc/guide/logging.xml

@@ -387,7 +387,7 @@ TODO; there's a ticket to determine these levels, see #1074
 "Logging": {
     "loggers": [
         {
-            "name": "*",
+            "name": "kea",
             "output_options": [
                 {
                     "output": "stdout"