[LON-CAPA-cvs] cvs: doc /build centos5_install.frag

bisitz bisitz@source.lon-capa.org
Mon, 11 May 2009 10:03:24 -0000


bisitz		Mon May 11 10:03:24 2009 EDT

  Modified files:              
    /doc/build	centos5_install.frag 
  Log:
  Optimized overview and navigation in installation guide:
  - Added links in overview which point to the main steps
  - Added numbering to main step headlines (corresponding to numbering in overview)
  - Added two <hr> to separate main steps from header and footer
  - Removed some trailing blanks
  
  
Index: doc/build/centos5_install.frag
diff -u doc/build/centos5_install.frag:1.1 doc/build/centos5_install.frag:1.2
--- doc/build/centos5_install.frag:1.1	Wed Dec 10 19:13:41 2008
+++ doc/build/centos5_install.frag	Mon May 11 10:03:24 2009
@@ -23,27 +23,28 @@
 The installation process takes the following steps:
 </p>
 <ol>
-  <li> Obtain CentOS Linux 5 installation CDs</li>
-  <li> Determine Network Settings</li>
-  <li> Install CentOS Linux 5 </li>
-  <li> Update your system </li>
-  <li> Install LON-CAPA </li>
-  <li> Create a Domain Coordinator </li>
-  <li> Start/Restart services </li>
-  <li> Log in to LON-CAPA </li>
+  <li><a href="#obt">Obtain CentOS Linux 5 installation CDs</a></li>
+  <li><a href="#net">Determine Network Settings</a></li>
+  <li><a href="#lin">Install CentOS Linux 5</a></li>
+  <li><a href="#upd">Update your system</a></li>
+  <li><a href="#ilc">Install LON-CAPA</a></li>
+  <li><a href="#cdc">Create a Domain Coordinator</a></li>
+  <li><a href="#sts">Start/Restart services</a></li>
+  <li><a href="#log">Log in to LON-CAPA</a></li>
 </ol>
 
-<h2>Obtain CentOS Linux 5 CDs</h2>
+<hr />
+<h2>1. <a name="obt">Obtain CentOS Linux 5 CDs</a></h2>
 <p>
 CentOS isos can be obtained from links included on the <a href="http://mirror.centos.org/centos/5/isos/">CentOS download page</a><br />
 For the minimal install on 32-bit architecture you will need only the first CD.
 For the minimal install on 64-bit architecture you will need CDs 1, 2, and 4.
 
-</p> 
+</p>
 
-<h2>Determine Network Settings</h2>
+<h2>2. <a name="net">Determine Network Settings</a></h2>
 <p>
-You will need to know the following network settings for your installation.  
+You will need to know the following network settings for your installation.
 <b>Note:</b>You must have a static IP address to use LON-CAPA.
 DHCP is <em>not</em> supported.
 
@@ -55,12 +56,12 @@
   <li>domain name server(s) </li>
 </ul>
 
-<h2>Minimal CentOS Linux 5 Install</h2>
+<h2>3. <a name="lin">Minimal CentOS Linux 5 Install</a></h2>
 <p>
 Installing CentOS Linux is quite easy, particularly if you've installed any of the Red Hat, Fedora or CentOS Linux distributions before.
 Documentation is available from
 <a href="http://wiki.centos.org/">http://wiki.centos.org/</a>
-Most of the installation screens are self explanatory.  
+Most of the installation screens are self explanatory.
 There are a few steps that require comment and are dealt with below.
 </p>
 <dl style="list-style:square outside none">
@@ -104,11 +105,11 @@
        loncontrol startup script should open and close thos ports
        itself.)
    </dd>
-   <dd> Set SELinux to Disabled.</dd>   
+   <dd> Set SELinux to Disabled.</dd>
    <dd> Select OK, and then Quit</dd>
 </p>
 
-<h2>Update your system</h2>
+<h2>4. <a name="upd">Update your system</a></h2>
 <p>
 Update your system to the latest versions of the system software using yum.
 </p>
@@ -134,7 +135,7 @@
 yum update
 </pre>
 </p>
-<h2>Installing LON-CAPA</h2>
+<h2>5. <a name="ilc">Installing LON-CAPA</a></h2>
 <h3>Install prerequisites</h3>
 <p> Execute: </p>
 <pre>
@@ -233,10 +234,10 @@
 </pre>
 <p>
 You will need to enter the LON-CAPA configuration information you determined 
-in the previous section.  
+in the previous section.
 </p>
 
-<h2>Creating a Domain Coordinator</h2>
+<h2>6. <a name="cdc">Creating a Domain Coordinator</a></h2>
 <p>
 You will need at least one user at your site who has the role of
 'domain coordinator'.  This user creates accounts for other users and
@@ -252,7 +253,7 @@
 (WILL PROMPT FOR PASSWORD HERE)
 </pre>
 
-<h2>Start/Restart Services</h2>
+<h2>7. <a name="sts">Start/Restart Services</a></h2>
 <p>
 The LON-CAPA network services take a moment to start.  Most misconfigurations
 will be apparent at this step.
@@ -267,12 +268,14 @@
 <b>Installing LON-CAPA Dependencies</b>.  If you still have errors, please
 contact the MSU LON-CAPA group.
 </p>
-<h2>Log in to your LON-CAPA Machine</h2>
+
+<h2>8. <a name="log">Log in to your LON-CAPA Machine</a></h2>
 <p>
 Point a web browser at your new machine and log in as the domain
 coordinator.  Congratulations!
 </p>
 
+<hr />
 <h2>If things aren't working right</h2>
 <p>
 If you've followed the steps above and the server doesn't start or you think