supplementary hints + external links added

Doc/Sdi/samba.xml

@@ -8,22 +8,6 @@
          xmlns:db="http://docbook.org/ns/docbook">
   <title>Network file systems served by Samba</title>
 
-  <programlisting language="none">TODO:
-Kraus:
-
-cifstools Installationshinweis
-Rolle der SID?
-ldap über SSL!!
-Option zum synchronen Anlegen von Samba und Unix Account.
-Reiner LDAP / nicht-System user/groups
-maxshadow ablauf parameter!!
-Loglevel auf 3 setzen, mit smbcontrol änderbar
-
-
-Account mit Ldap lam?
-
-</programlisting>
-
   <section xml:id="sdiSectSambaPrerequisites">
     <title>Prerequisites</title>
 
@@ -55,7 +39,8 @@ Account mit Ldap lam?
       <listitem>
         <para>After creating a local <code>tdbsam</code> user entry
         <code>smbtester</code> (or similar) test your share definitions using
-        <command>smbclient</command>:</para>
+        <command
+        xlink:href="http://linux.die.net/man/1/smbclient">smbclient</command>:</para>
 
         <programlisting language="none">root@sdi4a:~# smbclient  -L localhost --user smbtester
 Enter smbtester's password: 
@@ -92,15 +77,33 @@ root@mi-ESPRIMO-P910:~# cat /mnt/test/q.txt
 Mal sehen ...
 root@mi-ESPRIMO-P910:~# df /mnt/test/
 Filesystem                            1K-blocks   Used Available Use% Mounted on
-//sdi4a.mi.hdm-stuttgart.de/smbtester   4048548 783608   3264940  20% /mnt/test
-</programlisting>
+//sdi4a.mi.hdm-stuttgart.de/smbtester   4048548 783608   3264940  20% /mnt/test</programlisting>
+
+        <tip>
+          <itemizedlist>
+            <listitem>
+              <para>Mounting from a Linux client machine may require
+              installation of the <code
+              xlink:href="https://packages.debian.org/stable/otherosfs/cifs-utils">cifs-utils</code>
+              package.</para>
+            </listitem>
+
+            <listitem>
+              <para>You may want to alter the samba server's debug level using
+              the <command
+              xlink:href="http://linux.die.net/man/1/smbcontrol">smbcontrol</command>
+              command.</para>
+            </listitem>
+          </itemizedlist>
+        </tip>
       </listitem>
 
       <listitem>
         <para>Follow the <link
         xlink:href="https://help.ubuntu.com/lts/serverguide/samba-ldap.html">Samba
         and LDAP</link> documentation to enable <xref linkend="glo_LDAP"/>
-        support in favour of your local tdbsam database.</para>
+        support in favour of your local <productname>tdbsam</productname>
+        database.</para>
 
         <tip>
           <itemizedlist>
@@ -112,9 +115,17 @@ Filesystem                            1K-blocks   Used Available Use% Mounted on
             <listitem>
               <para>As with local Samba users each <xref linkend="glo_LDAP"/>
               user must be visible by the OS. As being mentioned in the
-              documentation configuring nsswitch to resolve i.e.
-              <command>id</command> <parameter>(samba_ldapu_sername) is an
-              essential</parameter> precondition.</para>
+              documentation configuring <filename
+              xlink:href="http://linux.die.net/man/5/nsswitch.conf">/etc/nsswitch.conf</filename>
+              to resolve i.e. <command
+              xlink:href="http://linux.die.net/man/1/id">id</command>
+              <parameter>hans</parameter> is an essential precondition.</para>
+            </listitem>
+
+            <listitem>
+              <para>For security reasons you may want to use
+              <acronym>LDAPS</acronym> in favour of unencrypted <xref
+              linkend="glo_LDAP"/>.</para>
             </listitem>
           </itemizedlist>
         </tip>
@@ -122,23 +133,17 @@ Filesystem                            1K-blocks   Used Available Use% Mounted on
 
       <listitem>
         <para>Test your Samba/LDAP installation by mounting a user's share via
-        ldap.</para>
+        <xref linkend="glo_LDAP"/>.</para>
 
         <tip>
           <para>Debugging may require setting the <xref linkend="glo_LDAP"/>
-          server's <parameter>loglevel</parameter> accordingly. Consider
-          creating a file <filename>loglevel.ldif</filename>:</para>
-
-          <programlisting language="none">dn: cn=config
-changetype: modify
-replace: olcLogLevel
-olcLogLevel: stats</programlisting>
-
-          <para>Activation may be effected by executing
-          <command>ldapmodify</command> <option>-Q -Y EXTERNAL -H ldapi:/// -f
-          loglevel.ldif</option>.</para>
+          server's <parameter
+          xlink:href="http://www.zytrax.com/books/ldap/ch6/#loglevel">olcLogLevel</parameter>
+          accordingly. </para>
 
-          <para>If you want to see all log messages you may issue:</para>
+          <para>If you want to see all log messages you may issue (prior
+          removal of <code>*.gz</code> <code>*.1</code> and other archive
+          files is recommended):</para>
 
           <programlisting language="none">root@sdi4a:/var/log# cd /var/log/
 root@sdi4a:/var/log# tail -n0 -f `find . -type f`

Doc/Sdi/surveillance.xml

@@ -9,18 +9,6 @@
          xmlns:db="http://docbook.org/ns/docbook">
   <title>Systems surveillance</title>
 
-  <programlisting language="none">TODO:
-Hettler:
-
-Präzisierung Vererbung
-
-first_notification-delay 1 i generic-service-nagios2.conf
-Nrpe --&gt; ssh Überwachung
-
-LDAP Überwachung mit Bint und ldapsearch
-
-</programlisting>
-
   <section xml:id="sdiSectNagios">
     <title>Working with <productname>Nagios</productname></title>