diff --git a/Doc/Sdi/dns.xml b/Doc/Sdi/dns.xml
index 670dfae877188b2fd0ee8b0c1bd65a9eb4f130d4..ac3832e85faf0892d78a7e14338ac139ae088b86 100644
--- a/Doc/Sdi/dns.xml
+++ b/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>