--- doc/build/fedora_install.frag	2004/01/30 17:29:43	1.2
+++ doc/build/fedora_install.frag	2004/07/15 14:35:38	1.11
@@ -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>
@@ -27,6 +27,7 @@ The installation process takes the follo
   <li> Obtain Fedora Linux </li>
   <li> Determine Network Settings</li>
   <li> Install Fedora </li>
+  <li> Uninstall the http server </li>
   <li> Install LON-CAPA Dependencies </li>
   <li> Determine your LON-CAPA Settings </li>
   <li> Install LON-CAPA </li>
@@ -57,10 +58,6 @@ DHCP is <em>not</em> supported.
   <li>domain name server(s) </li>
 </ul>
 
-<h2>Gather needed information</h2>
-
-
-
 <h2>Install Fedora</h2>
 <p>
 Installing Fedora is quite easy if you've installed any of the Red Hat products
@@ -101,9 +98,10 @@ There are a few sections that require co
          <li>Editors</li>
          <li>Text Based Internet</li>
          <li>Authoring and Publishing</li>
-         <li>Development Tools
-         <li>Administration Tools
-         <li>Printing Support
+         <li>Server Configuration Tools</li>
+         <li>Development Tools</li>
+         <li>Administration Tools</li>
+         <li>Printing Support</li>
       </ul>
    </dd>
 </dl>
@@ -132,14 +130,38 @@ tar xf fedora_install.tar
 This creates a directory named <tt>installation</tt>.
 </p>
 
+<h2>Uninstall the http server</h2>
+<p>
+Fedora Core 2 installs the http server even if you have not chosen it in
+the package selection part of the install.  LON-CAPA will not work with this
+web server installed.  It must be removed.
+Use the following commands to remove the http and mod_perl packages if they 
+exist:  (<b>Note:</b>
+<i>The commands below use backticks, not single quotes.</i>:
+</p>
+<p>
+<pre>
+rpm -e `rpm -q -a | grep mod_perl`
+rpm -e `rpm -q -a | grep httpd`
+</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>
+
 <h2>Installing LON-CAPA Dependencies</h2>
 <p>
 This section walks you through installing the packages which LON-CAPA requires.
-There are a lot of dependencies to deal with.  They have been grouped in a
+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.
-</p><p>
-The quick instructions are:
+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>
+To install the many LON-CAPA dependencies, execute the following commands:
 </p>
 <pre>
 cd installation
@@ -154,9 +176,7 @@ rpm -Uvh *rpm
 cd ../GD
 rpm -Uvh *rpm
 cd ../gnuplot
-rpm --install --oldpackage readline-2.2.1-6.i386.rpm
-rpm --install --oldpackage --excludedocs libpng-1.0.12-2.i386.rpm
-rpm -Uvh gnuplot-3.7.1-5.i386.rpm libgd-1.3-4.i386.rpm ncurses4-5.0-5.i386.rpm
+rpm -Uvh *rpm
 cd ../misc
 rpm -Uvh *rpm
 cd ..
@@ -168,10 +188,10 @@ cd ..
         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.
-    <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>
+        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>
 </ul>
 </p>
 
@@ -228,7 +248,7 @@ for it to function at all.  Below is a l
 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>
@@ -250,6 +270,10 @@ appropriate user name and your domain.
 cd /root/loncapa-N.N/loncom/build
 perl make_domain_coordinator.pl USERNAME DOMAIN
 (WILL PROMPT FOR PASSWORD HERE)
+mkdir ~USERNAME/public_html
+chown USERNAME:www ~USERNAME/public_html
+chmod 0775 ~USERNAME/public_html
+chmod a+x ~USERNAME
 </pre>
 
 <h2>Start/Restart Services</h2>
@@ -261,9 +285,23 @@ will be appearant at this step.
 /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
 coordinator.  Congratulations!
 </p>
+
+<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 
+there's something wrong, please get in touch with the LON-CAPA developers.
+If there were errors in installation of the dependency RPMs or during the
+automatic setup, please send us as much information as possible.
+If some part of this document is unclear please let us know.
+</p>