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

bisitz bisitz@source.lon-capa.org
Thu, 09 Dec 2010 14:11:31 -0000


bisitz		Thu Dec  9 14:11:31 2010 EDT

  Modified files:              
    /doc/build	centos5_install.frag 
  Log:
  - Better highlight SELinux settings (found to be overseen repeatedly)
  - Valid HTML code/nested tags
  
  
Index: doc/build/centos5_install.frag
diff -u doc/build/centos5_install.frag:1.4 doc/build/centos5_install.frag:1.5
--- doc/build/centos5_install.frag:1.4	Wed May 26 23:42:50 2010
+++ doc/build/centos5_install.frag	Thu Dec  9 14:11:31 2010
@@ -33,10 +33,10 @@
   <li><a href="#log">Log in to LON-CAPA</a></li>
 </ol>
 
-<hr />
+<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.
 
@@ -88,24 +88,30 @@
    <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).
-   </dd>
-   <dd> Set SELinux to Disabled.</dd>
-   <dd> Select OK, and then Quit</dd>
-</p>
+   </li>
+   <li> Set SELinux to Disabled.</li>
+   <li> Select OK, and then Quit</li>
+</ol>
+
 
 <h2>4. <a name="upd">Update your system</a></h2>
 <p>
@@ -126,13 +132,13 @@
 <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>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>
@@ -165,9 +171,10 @@
 ./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>
@@ -177,9 +184,8 @@
 <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>
@@ -198,7 +204,7 @@
   <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.
@@ -275,7 +281,7 @@
 coordinator.  Congratulations!
 </p>
 
-<hr />
+<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