--- doc/build/centos5_install.frag	2008/12/10 19:13:41	1.1
+++ doc/build/centos5_install.frag	2011/09/23 20:48:35	1.7
@@ -23,27 +23,28 @@ perl, and MySQL are not required to inst
 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 />
+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 @@ DHCP is <em>not</em> supported.
   <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">
@@ -87,28 +88,33 @@ There are a few steps that require comme
    <dt>Software</dt>
    <dd>Click the "Customize Now" radio button and for a minimal install uncheck all packages except "Base" in the Base System category.  If you leave other packages checked in any of the other categories, you'll need additional ISO CDs.</dd>
 </dl>
-<p>
 
-Finish installing your server, reboot it, and log in as root. The
-first time you log-in, the Setup Agent will be displayed. (If you exit it early you can enter it again buy running the command
-<pre>
-setup
-</pre>
- This should tool be used to configure the Firewall and SELinux.
+<p>
+Finish installing your server, reboot it, and log in as root.
+</p>
 
-  <dt>Firewall Configuration</dt>
+<h3>Firewall and SELinux Configuration</h3>
+<p>
+The first time you log-in, the Setup Agent will be displayed.
+If you exit it early you can enter it again buy running the command
+</p>
+<pre>setup</pre>
+<p>
+This tool should be used to configure the Firewall and SELinux.
+</p>
 
-   <dd>Select Security Level: Enabled, and Customize, to allow
+<ol>
+   <li>Select Security Level: Enabled, and Customize, to allow
        incoming: SSH (remote login), WWW (HTTP) and secure WWW
-       (HTTPS). (LON-CAPA also will use ports 5663 and 8080, but the
-       loncontrol startup script should open and close thos ports
-       itself.)
-   </dd>
-   <dd> Set SELinux to Disabled.</dd>   
-   <dd> Select OK, and then Quit</dd>
-</p>
+       (HTTPS).
+   </li>
+   <li> Set SELinux to Disabled.</li>
+   <li> Select OK, and then Quit</li>
+</ol>
+
+<pre>reboot</pre>
 
-<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>
@@ -119,7 +125,7 @@ yum update
 Reboot your system before continuing with the installation.
 </p>
 <p>
-Retrieve the rhel5_loncapa_yum file from the LON-CAPA install site:
+Retrieve the centos5_loncapa_yum file from the LON-CAPA install site:
 </p>
 <pre>
 wget http://install.loncapa.org/versions/centos/5/centos5_loncapa_yum.conf
@@ -127,14 +133,16 @@ wget http://install.loncapa.org/versions
 <p>
 Install the centos5_loncapa_yum.conf
 </p>
-<p>
 <pre>
 mv /etc/yum.conf /etc/yum.conf.backup
 cp centos5_loncapa_yum.conf /etc/yum.conf
 yum update
 </pre>
-</p>
-<h2>Installing LON-CAPA</h2>
+
+
+<h2>5. <a name="ilc">Installing LON-CAPA</a></h2>
+<h3>Import the LON-CAPA encryption key</h3>
+<pre>rpm --import http://install.loncapa.org/versions/centos/RPM-GPG-KEY-loncapa</pre>
 <h3>Install prerequisites</h3>
 <p> Execute: </p>
 <pre>
@@ -164,9 +172,10 @@ cd installation
 ./install.pl
 </pre>
 <p>
-This script will prompt you for the MySQL root password and will download the latest LON-CAPA release.<br />
-You can safely ignore the following warnings from gcc 4 when compiling pwauth:<br />
-<tt>
+This script will prompt you for the MySQL root password and will download the latest LON-CAPA release.<br>
+You can safely ignore the following warnings from gcc 4 when compiling pwauth:<br>
+</p>
+<div style="font-family:monospace;">
 pwauth.c: In function ‘lastlog’:
 <ul>
 <li>pwauth.c:541: warning: incompatible implicit declaration of built-in function ‘strncpy’</li>
@@ -176,9 +185,8 @@ pwauth.c: In function ‘main’:
 <ul>
 <li>pwauth.c:692: warning: incompatible implicit declaration of built-in function ‘strlen’</li>
 </ul>
-</tt>
+</div>
 
-</p>
 
 <h3>Determine LON-CAPA Settings</h3>
 <p>
@@ -197,7 +205,7 @@ for it to function at all.  Below is a l
   <dd>Each site or school which installs LON-CAPA needs its own domain.
       Here at MSU we use 'msu'.  You should choose something short but
       meaningful.  <i>Restriction: One word, no hyphens, underscores, or 
-      special characters.</i><br />Domain names which include a departmental 
+      special characters.</i><br>Domain names which include a departmental 
       abbreviation are not recommended as although LON-CAPA may start in
       a single department, other departments frequently join subsequently.
       For a domain name: 'msu' is a superior choice to 'msuphys' for example.
@@ -233,10 +241,10 @@ cd /root/loncapa-N.N     (N.N should cor
 </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 +260,7 @@ perl make_domain_coordinator.pl USERNAME
 (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 +275,14 @@ please make sure you followed the instru
 <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