VirtualBox Desciption

Doc/Sd1/preliminaries.xml

@@ -223,16 +223,22 @@
         </glossdef>
       </glossentry>
 
-      <glossentry xml:id="glossSda1LubuntuVm">
-        <glossterm><productname>Virtualbox</productname>
-        <productname>Lubuntu</productname> VM</glossterm>
+      <glossentry xml:id="virtualboxCsmImage">
+        <glossterm><trademark>Virtualbox</trademark> image / native (dual
+        boot) installation</glossterm>
 
         <glossdef>
-          <para><link
-          xlink:href="ftp://mirror.mi.hdm-stuttgart.de/ubuntu/VirtualBox">ftp://mirror.mi.hdm-stuttgart.de/ubuntu/VirtualBox</link>.</para>
+          <para>A <productname
+          xlink:href="https://www.virtualbox.org">Virtualbox</productname>
+          image is available at <uri
+          xlink:href="ftp://mirror.mi.hdm-stuttgart.de/ubuntu/VirtualBox/lubuntu.rar">ftp://mirror.mi.hdm-stuttgart.de/ubuntu/VirtualBox/lubuntu.rar</uri>.</para>
 
           <caution>
-            <para>External access requires <acronym>VPN</acronym></para>
+            <para><xref linkend="glo_Ftp"/> access from HdM external networks
+            require <acronym>VPN</acronym> access. You may want to consider
+            <link
+            xlink:href="https://mirror.mi.hdm-stuttgart.de/ubuntu/VirtualBox/lubuntu.rar">authenticated
+            access</link> instead.</para>
           </caution>
 
           <para>If you experience bad <productname>Virtualbox</productname>
@@ -247,6 +253,58 @@
           xlink:href="http://www.ubuntu.com">Ubuntu</orgname> <quote
           xlink:href="http://www.ubuntu.com/download/desktop">Desktop</quote>
           installation.</para>
+
+          <para>The image contains (hopefully) all related tools from the
+          <link xlink:href="http://www.mi.hdm-stuttgart.de">CSM</link>
+          department's lecture room Linux installation with respect to the
+          current and upcoming lectures:</para>
+
+          <itemizedlist>
+            <listitem>
+              <para>Eclipse J2EE version with <productname
+              xlink:href="http://www.eclipse.org/datatools">Database developer
+              tools</productname>, and <productname
+              xlink:href="http://git-scm.com">git</productname> plugins
+              installed.</para>
+            </listitem>
+
+            <listitem>
+              <para>A running <productname
+              xlink:href="http://www.mysql.com/">Mysql</productname> server
+              preconfigured with user <quote><code>hdmuser</code></quote>,
+              password <quote><code>XYZ</code></quote> (<emphasis
+              role="bold">capital letters!</emphasis>) and database
+              <quote><code>hdm</code></quote>.</para>
+            </listitem>
+
+            <listitem>
+              <para><productname
+              xlink:href="http://www.xmlmind.com/xmleditor">Xmlmind XML
+              editor</productname> for visually editing technical documents
+              based on <productname
+              xlink:href="http://docbook.org/tdg5/index.html">docbook</productname>
+              or <productname
+              xlink:href="http://en.wikipedia.org/wiki/Darwin_Information_Typing_Architecture">DITA</productname>.</para>
+            </listitem>
+          </itemizedlist>
+
+          <caution>
+            <para>This VM is only accessible from within the <orgname
+            xlink:href="http://www.hdm-stuttgart.de">HdM</orgname> network.
+            External downloads require <productname
+            xlink:href="https://wiki.mi.hdm-stuttgart.de/wiki/VPN">OpenVPN</productname>.</para>
+          </caution>
+
+          <para>The virtual machine is based on the <productname
+          xlink:href="http://lubuntu.net">Lubuntu</productname> fork of the
+          <productname xlink:href="http://www.ubuntu.com">Ubuntu</productname>
+          Linux distribution for resource saving reasons.</para>
+
+          <para>If the VirtualBox solution does not work for you we highly
+          recommend a native (possibly dual boot) <orgname
+          xlink:href="http://www.ubuntu.com">Ubuntu</orgname> 14.04.2 <quote
+          xlink:href="http://www.ubuntu.com/download/desktop">Desktop</quote>
+          installation.</para>
         </glossdef>
       </glossentry>
     </glosslist>

Doc/Sda1/prerequisites.xml

@@ -10,7 +10,7 @@
   <title>Prerequisites</title>
 
   <section xml:id="resources">
-    <title>Lecture resources</title>
+    <title>Lecture related resources</title>
 
     <glosslist>
       <glossentry>
@@ -104,69 +104,7 @@
         boot) installation</glossterm>
 
         <glossdef>
-          <para>A <productname
-          xlink:href="https://www.virtualbox.org">Virtualbox</productname>
-          image is available at <uri
-          xlink:href="ftp://mirror.mi.hdm-stuttgart.de/ubuntu/VirtualBox/lubuntu.rar">ftp://mirror.mi.hdm-stuttgart.de/ubuntu/VirtualBox/lubuntu.rar</uri>
-          <link
-          xlink:href="ftp://mirror.mi.hdm-stuttgart.de/ubuntu/VirtualBox/lubuntu.vdi">ftp://mirror.mi.hdm-stuttgart.de/ubuntu/VirtualBox/lubuntu.vdi</link>.</para>
-
-          <caution>
-            <para>Access from networks being external to
-            <uri>hdm-stuttgart.de</uri> requires <acronym>VPN</acronym>
-            access.</para>
-          </caution>
-
-          <para>It contains (hopefully) all related tools from the <link
-          xlink:href="http://www.mi.hdm-stuttgart.de">CSM</link> department's
-          lecture room Linux installation:</para>
-
-          <itemizedlist>
-            <listitem>
-              <para>Eclipse J2EE version with <productname
-              xlink:href="http://www.eclipse.org/datatools">Database developer
-              tools</productname>, and <productname
-              xlink:href="http://git-scm.com">git</productname> plugins
-              installed.</para>
-            </listitem>
-
-            <listitem>
-              <para>A running <productname
-              xlink:href="http://www.mysql.com/">Mysql</productname> server
-              preconfigured with user <quote><code>hdmuser</code></quote>,
-              password <quote><code>XYZ</code></quote> (<emphasis
-              role="bold">capital letters!</emphasis>) and database
-              <quote><code>hdm</code></quote>.</para>
-            </listitem>
-
-            <listitem>
-              <para><productname
-              xlink:href="http://www.xmlmind.com/xmleditor">Xmlmind XML
-              editor</productname> for visually editing technical documents
-              based on <productname
-              xlink:href="http://docbook.org/tdg5/index.html">docbook</productname>
-              or <productname
-              xlink:href="http://en.wikipedia.org/wiki/Darwin_Information_Typing_Architecture">DITA</productname>.</para>
-            </listitem>
-          </itemizedlist>
-
-          <caution>
-            <para>This VM is only accessible from within the <orgname
-            xlink:href="http://www.hdm-stuttgart.de">HdM</orgname> network.
-            External downloads require <productname
-            xlink:href="https://wiki.mi.hdm-stuttgart.de/wiki/VPN">OpenVPN</productname>.</para>
-          </caution>
-
-          <para>The virtual machine is based on the <productname
-          xlink:href="http://lubuntu.net">Lubuntu</productname> fork of the
-          <productname xlink:href="http://www.ubuntu.com">Ubuntu</productname>
-          Linux distribution for resource saving reasons.</para>
-
-          <para>If the VirtualBox solution does not work for you we highly
-          recommend a native (possibly dual boot) <orgname
-          xlink:href="http://www.ubuntu.com">Ubuntu</orgname> 14.04.2 <quote
-          xlink:href="http://www.ubuntu.com/download/desktop">Desktop</quote>
-          installation.</para>
+          <para>See <xref linkend="virtualboxCsmImage"/>.</para>
         </glossdef>
       </glossentry>