[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