DNS config update

Doc/Sdi/dns.xml

@@ -8,13 +8,6 @@
          xmlns:db="http://docbook.org/ns/docbook">
   <title><xref linkend="glo_DNS"/></title>
 
-  <programlisting language="none">TODO:
-Zeller:
-
-
-
-</programlisting>
-
   <section xml:id="sdiDnsPrelim">
     <title>Preliminaries</title>
 
@@ -46,15 +39,45 @@ Zeller:
       </listitem>
     </itemizedlist>
 
-    <programlisting language="none">apt-get install bind9 bind9utils
+    <glosslist>
+      <glossentry>
+        <glossterm>Install server and utilities</glossterm>
+
+        <glossdef>
+          <programlisting language="none">apt-get install bind9 bind9utils</programlisting>
+        </glossdef>
+      </glossentry>
+
+      <glossentry>
+        <glossterm>Configure server startup</glossterm>
+
+        <glossdef>
+          <para>Turn off IPv6. Hint from
+          <filename>/etc/init.d/bind9</filename>:</para>
+
+          <programlisting language="none"># Don't modify this line, change or create /etc/default/bind9.
+OPTIONS=""</programlisting>
+
+          <para>Thus modify <filename>/etc/default/bind9</filename>:</para>
+
+          <programlisting language="none">OPTIONS="<emphasis role="bold">-4</emphasis> -u bind"</programlisting>
+
+          <tip>
+            <para>Most (if not all) server configuration changes require a
+            daemon restart or at least a configuration file reloading to
+            become effective:</para>
+
+            <programlisting language="none">service bind9 reload</programlisting>
+          </tip>
+        </glossdef>
+      </glossentry>
 
--------------------------------------------------------------------------
-vi /etc/default/bind9
-# startup options for the server
-OPTIONS="-4 -u bind"
--------------------------------------------------------------------------
-vim /etc/bind/named.conf.options
-options {
+      <glossentry>
+        <glossterm>Global options in
+        <filename>/etc/bind/named.conf.options</filename></glossterm>
+
+        <glossdef>
+          <programlisting language="none">options {
         directory "/var/cache/bind";
 
         recursion yes;                 # enables resursive queries
@@ -86,10 +109,21 @@ options {
 
         auth-nxdomain no;    # conform to RFC1035
         listen-on-v6 { any; };
-};
--------------------------------------------------------------------------
-vim /etc/bind/named.conf.local
-zone "mi.hdm-stuttgart.de" {
+};</programlisting>
+        </glossdef>
+      </glossentry>
+
+      <glossentry>
+        <glossterm>Configuring zones</glossterm>
+
+        <glossdef>
+          <glosslist>
+            <glossentry>
+              <glossterm><filename>/etc/bind/named.conf.local
+              </filename></glossterm>
+
+              <glossdef>
+                <programlisting language="none">zone "mi.hdm-stuttgart.de" {
     type master;
     file "/etc/bind/zones/db.mi.hdm-stuttgart.de"; # zone file path
 };
@@ -97,10 +131,16 @@ zone "mi.hdm-stuttgart.de" {
 zone "75.62.141.in-addr.arpa" {
     type master;
     file "/etc/bind/zones/db.141.62.75";  # 141.62.75.0/16 class-C subnet
-};
--------------------------------------------------------------------------
-vim /etc/bind/zones/db.mi.hdm-stuttgart.de
-;
+};</programlisting>
+              </glossdef>
+            </glossentry>
+
+            <glossentry>
+              <glossterm><filename>/etc/bind/zones/db.mi.hdm-stuttgart.de
+              </filename></glossterm>
+
+              <glossdef>
+                <programlisting language="none">;
 ; BIND data file 
 ;
 $TTL    604800
@@ -118,12 +158,20 @@ $TTL    604800
 
 ; name servers - A records
 ns4.mi.hdm-stuttgart.de.          IN      A       141.62.75.104
-www4.mi.hdm-stuttgart.de.         IN      A       141.62.75.104
--------------------------------------------------------------------------
-vim /etc/bind/zones/db.141.62.75
+www4.mi.hdm-stuttgart.de.         IN      A       141.62.75.104</programlisting>
 
-;
-; BIND reverse data file 
+                <tip>
+                  <para>Read about the <parameter>Serial</parameter>
+                  parameter.</para>
+                </tip>
+              </glossdef>
+            </glossentry>
+
+            <glossentry>
+              <glossterm><filename>/etc/bind/zones/db.141.62.75</filename></glossterm>
+
+              <glossdef>
+                <programlisting language="none">; BIND reverse data file 
 ;
 $TTL    604800
 @       IN      SOA     ns4.mi.hdm-stuttgart.de. root.mi.hdm-stuttgart.de. (
@@ -138,8 +186,13 @@ $TTL    604800
       IN      NS      ns4.mi.hdm-stuttgart.de.
 
 ; PTR Records
-104   IN      PTR     sdi4a.mi.hdm-stuttgart.de.    ; 141.62.75.104:w
-</programlisting>
+104   IN      PTR     sdi4a.mi.hdm-stuttgart.de.    ; 141.62.75.104</programlisting>
+              </glossdef>
+            </glossentry>
+          </glosslist>
+        </glossdef>
+      </glossentry>
+    </glosslist>
   </section>
 
   <section xml:id="sdiDnsExercises">
@@ -269,8 +322,9 @@ $TTL    604800
       sending a mail to <code>xy123@mi.hdm-stuttgart.de</code> won't work
       since the HdM's mail filters will deliver these mails to the MI mail
       server <code>mail.mi.hdm-stuttgart.de</code> rather than to
-      <code>mail.hdm-stuttgart.de</code> . In addition both servers will
-      reject mails having destination addresses differing from
+      <code>mail.hdm-stuttgart.de</code> (and you probably have no account on
+      this particular machine). In addition both servers will reject mails
+      having destination addresses differing from
       <code>...@hdm-stuttgart.de</code> or
       <code>...@mi.hdm-stuttgart.de</code> respectively.</para>
     </section>