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

[matthew]

matthew		Tue Jun  1 17:23:03 2004 EDT

  Modified files:              
    /doc/build	fedora_install.frag 
  Log:
  Reworked for FC2 installation instructions.
  
  
Index: doc/build/fedora_install.frag
diff -u doc/build/fedora_install.frag:1.4 doc/build/fedora_install.frag:1.5
--- doc/build/fedora_install.frag:1.4	Fri May 21 09:04:43 2004
+++ doc/build/fedora_install.frag	Tue Jun  1 17:23:02 2004
@@ -1,7 +1,7 @@
-<h1>Installing LON-CAPA on a Fedora Linux System</h1>
+<h1>Installing LON-CAPA on a Fedora Core 2 Linux System</h1>
 <p>
 This document guides you through the process of setting up a new LON-CAPA
-server running Fedora Linux.  The computer will be configured solely as
+server running Fedora Core 2 (FC2).  The computer will be configured solely as
 a LON-CAPA server and will be expected to have no other services running
 on it.
 </p><p>
@@ -97,10 +97,10 @@
          <li>Editors</li>
          <li>Text Based Internet</li>
          <li>Authoring and Publishing</li>
+         <li>Server Configuration Tools</li>
          <li>Development Tools</li>
          <li>Administration Tools</li>
          <li>Printing Support</li>
-         <li>Server Configuration Tools</li>
       </ul>
    </dd>
 </dl>
@@ -134,9 +134,23 @@
 This section walks you through installing the packages which LON-CAPA requires.
 There are a lot of dependencies.  They have been grouped in a
 somewhat logical fashion to make them easier to deal with.  When installing
-the rpms you should watch for errors.
+the rpms you should watch for errors.  Errors generated by RPMs which are 
+already should not be considered a problem, although you will have to ensure 
+the other rpms in the directory get installed.
+</p><p>
+First, we need to make sure the web server and mod_perl have not been 
+installed.  Use the following commands to remove them if they exist:
+</p><p>
+<pre>
+rpm -e `rpm -q -a | grep httpd`
+rpm -e `rpm -q -a | grep mod_perl`
+</pre>
+</p><p>
+If the above commands returns no output (the usual indicator of success), or an
+error message 'rpm: no packages given for erase' (meaning there were no
+packages that contain httpd or mod_perl), you are good to go.  
 </p><p>
-The quick instructions are:
+To install the many LON-CAPA dependencies, execute the following commands:
 </p>
 <pre>
 cd installation
@@ -165,10 +179,14 @@
         Administering LON-CAPA machines does not yet mean becoming a 
         database administrator.</li>
     <li>Apache 1.3 and mod_perl 1.x are required by LON-CAPA.  These are
-        provided in the installation package.
+        provided in the installation package.  The mod_perl package has been
+        repackaged from the Redhat sources with the name 'mod_perl_1' in
+        order to prevent version 1.99 of mod_perl from being installed by 
+        yum or other package managers.</li>
     <li>A specific version of Gnuplot is required by LON-CAPA.  Do not
         install a version different from the one included in the LON-CAPA
-        installation package.</li>
+        installation package.  We're still working on using gnuplot 4.0 which
+        recently came out.</li>
 </ul>
 </p>
 
@@ -225,7 +243,7 @@
 To configure and install LON-CAPA, execute the following commands:
 </p>
 <pre>
-cd /root/loncapa-N.N     (N.N should correspond to a version number like '1.1')
+cd /root/loncapa-N.N     (N.N should correspond to a version number like '1.2')
 ./UPDATE
 </pre>
 <p>
@@ -258,7 +276,12 @@
 /etc/init.d/loncontrol start
 /etc/init.d/httpd start
 </pre>
-
+<p>
+If you receive warnings when starting the httpd about missing perl modules,
+please make sure you followed the instructions in 
+<b>Installing LON-CAPA Dependencies</b>.  If you still have errors, please
+contact the LON-CAPA development team.
+</p>
 <h2>Log in to your LON-CAPA Machine</h2>
 <p>
 Point a web browser at your new machine and log in as the domain