BIND 10 trac3360, updated. 762f3c3996fa80214ea0f3650b00350800bf6c5b [3360] Updated bind10 guide with the instructions to configure Memfile.

[BIND 10 source code commits]

The branch, trac3360 has been updated
       via  762f3c3996fa80214ea0f3650b00350800bf6c5b (commit)
      from  8b5ded2f871bd67584c67a380c9736baeb9c246d (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit 762f3c3996fa80214ea0f3650b00350800bf6c5b
Author: Marcin Siodelski <marcin at isc.org>
Date:   Tue Mar 25 17:17:31 2014 +0100

    [3360] Updated bind10 guide with the instructions to configure Memfile.

-----------------------------------------------------------------------

Summary of changes:
 doc/guide/bind10-guide.xml |   72 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 72 insertions(+)

-----------------------------------------------------------------------
diff --git a/doc/guide/bind10-guide.xml b/doc/guide/bind10-guide.xml
index 89fc6fa..c9b3f98 100644
--- a/doc/guide/bind10-guide.xml
+++ b/doc/guide/bind10-guide.xml
@@ -3711,6 +3711,42 @@ Dhcp4/subnet4	[]	list	(default)
       </para>
 
       <section>
+      <title>Default storage for leases</title>
+      <para>
+        Server is designed to support multiple lease database storages. In larger deployments
+        it is often desired to store leases in the database. The
+        <xref linkend="database-configuration4"/> describes one of the possible ways to do it.
+        By default, the server will use a flat CSV file, rather than the database to store
+        lease information. One of the advantages of using a file is that it eliminates
+        dependency on third party software, such as MySQL deamon and developer package.
+      </para>
+      <para>
+        The configuration of the backend (Memfile) performing writes and reads from the
+        file is controlled through the Dhcp4/lease-database parameters. When default
+        parameters are left, the Memfile backend will write leases to a disk in the
+        [bind10-install-dir]/var/bind10/kea-leases4.csv.
+      </para>
+      <para>
+        It is possible to alter the default location of the lease file. The following
+        configuration:
+<screen>
+> <userinput>config set Dhcp4/lease-database/type "memfile"</userinput>
+> <userinput>config set Dhcp4/lease-database/persist true</userinput>
+> <userinput>config set Dhcp4/lease-database/leasefile "/tmp/kea-leases4.csv"</userinput>
+> <userinput>config commit</userinput>
+</screen>
+        will change the default location of the lease file to /tmp/kea-leases4.csv.
+      </para>
+      <para>
+        The "persist" parameter controls whether the leases are written to disk or not.
+        It is strongly recommended that this parameter is set to "true" at all times
+        during the normal operation of the server. The typical case when lease writes
+        can be disabled is testing: unit testing, performance testing when it is
+        desired that server is not disk-bound.
+      </para>
+      </section>
+
+      <section id="database-configuration4">
       <title>Database Configuration</title>
       <para>
       All leases issued by the server are stored in the lease database.  Currently,
@@ -4868,6 +4904,42 @@ Dhcp6/subnet6/	list
       </note>
 
       <section>
+      <title>Default storage for leases</title>
+      <para>
+        Server is designed to support multiple lease database storages. In larger deployments
+        it is often desired to store leases in the database. The
+        <xref linkend="database-configuration6"/> describes one of the possible ways to do it.
+        By default, the server will use a flat CSV file, rather than the database to store
+        lease information. One of the advantages of using a file is that it eliminates
+        dependency on third party software, such as MySQL deamon and developer package.
+      </para>
+      <para>
+        The configuration of the backend (Memfile) performing writes and reads from the
+        file is controlled through the Dhcp4/lease-database parameters. When default
+        parameters are left, the Memfile backend will write leases to a disk in the
+        [bind10-install-dir]/var/bind10/kea-leases6.csv.
+      </para>
+      <para>
+        It is possible to alter the default location of the lease file. The following
+        configuration:
+<screen>
+> <userinput>config set Dhcp4/lease-database/type "memfile"</userinput>
+> <userinput>config set Dhcp4/lease-database/persist true</userinput>
+> <userinput>config set Dhcp4/lease-database/leasefile "/tmp/kea-leases6.csv"</userinput>
+> <userinput>config commit</userinput>
+</screen>
+        will change the default location of the lease file to /tmp/kea-leases6.csv.
+      </para>
+      <para>
+        The "persist" parameter controls whether the leases are written to disk or not.
+        It is strongly recommended that this parameter is set to "true" at all times
+        during the normal operation of the server. The typical case when lease writes
+        can be disabled is testing: unit testing, performance testing when it is
+        desired that server is not disk-bound.
+      </para>
+      </section>
+
+      <section id="database-configuration6">
       <title>Database Configuration</title>
       <para>
       All leases issued by the server are stored in the lease database.  Currently,