[LON-CAPA-cvs] cvs: doc /build fedora_install.frag
matthew
lon-capa-cvs@mail.lon-capa.org
Thu, 09 Sep 2004 18:41:11 -0000
matthew Thu Sep 9 14:41:11 2004 EDT
Modified files:
/doc/build fedora_install.frag
Log:
New instructions to use with the LON-CAPA rpm.
Index: doc/build/fedora_install.frag
diff -u doc/build/fedora_install.frag:1.11 doc/build/fedora_install.frag:1.12
--- doc/build/fedora_install.frag:1.11 Thu Jul 15 10:35:38 2004
+++ doc/build/fedora_install.frag Thu Sep 9 14:41:11 2004
@@ -1,3 +1,7 @@
+<html>
+<head><title>New installation instructions</title></head>
+<body>
+
<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
@@ -27,12 +31,8 @@
<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>
- <li> Configure LON-CAPA </li>
- <li> Pick a hosts.tab file </li>
+ <li> Updating your system </li>
+ <li> Installing LON-CAPA </li>
<li> Create a Domain Coordinator </li>
<li> Start/Restart services </li>
<li> Log in to LON-CAPA </li>
@@ -109,110 +109,68 @@
Finish installing your server, reboot it, and log in as root.
</p>
-<h2>Retrieving the LON-CAPA Installation Archive</h2>
+<h2>Updating your system</h2>
<p>
-Execute the following command:
+Retrieve the loncapa_yum.conf file from the LON-CAPA install site:
</p>
<pre>
-wget http://install.loncapa.org/versions/fedora/fedora_install.tar
+wget http://install.loncapa.org/versions/fedora/loncapa_yum.conf
</pre>
<p>
-This will retrieve from the LON-CAPA website all the packages needed to get
-LON-CAPA running on your system, except for the LON-CAPA source itself.
-</p>
-<p>
-Extract the archive with the following command:
+Update your system to the latest versions of the system software:
</p>
<pre>
-tar xf fedora_install.tar
+yum -c ./loncapa_yum.conf update
</pre>
<p>
-This creates a directory named <tt>installation</tt>.
+You will probably need to reboot your system, specifically when a new kernel is
+installed. Reboot your system before proceeding with the LON-CAPA install.
</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>
+<h2>Installing LON-CAPA</h2>
+<h3>Install prerequisites</h3>
<p>
-<pre>
-rpm -e `rpm -q -a | grep mod_perl`
-rpm -e `rpm -q -a | grep httpd`
+On our test install we needed to remove the httpd and system-config-httpd
+packages using the command:
+</p><pre>
+rpm -e httpd system-config-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. 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. 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.
+Installating the LON-CAPA prerequisites is pretty straightforward. Execute:
+</p><pre>
+yum -c ./loncapa_yum.conf install LONCAPA-prerequisites
+</pre><p>
+This may take a moment due to LON-CAPA's large number of dependencies.
+</p><p>
+If yum complains of conflicting packages you will need to uninstall them
+using 'rpm -e <packagename>'.
</p>
-
+<h3>Retrieve and execute LON-CAPA setup program</h3>
<p>
-To install the many LON-CAPA dependencies, execute the following commands:
+Retrieve the LON-CAPA setup with the following command:
</p>
<pre>
-cd installation
-cd mysql
-rpm -Uvh *rpm
-cd ../apache
-rpm -Uvh *rpm
-cd ../mod_perl
-rpm -Uvh *rpm
-cd ../perl_dependencies
-rpm -Uvh *rpm
-cd ../GD
-rpm -Uvh *rpm
-cd ../gnuplot
-rpm -Uvh *rpm
-cd ../misc
-rpm -Uvh *rpm
-cd ..
+wget http://install.loncapa.org/versions/fedora/fedora_install.tar
</pre>
<p>
-<b>Notes:</b>
-<ul>
- <li>MySQL is used to store caches of data, not original copies.
- 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. 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>
+Extract the archive with the following command:
</p>
-
-<h2>Configuring LON-CAPA Dependencies</h2>
+<pre>
+tar xf fedora_install.tar
+</pre>
<p>
-We have prepared a script which takes care of most of the configuration that
-must be done to get the newly installed packages working with LON-CAPA.
-This script will retrieve the latest LON-CAPA release from
-<a href="http://install.loncapa.org">http://install.loncapa.org</a>.
-You will be prompted for a root password for your MySQL server. You
-will need to remember this password in case you should ever need to make
-changes the the server.
-</p><p>
-Execute the script as follows:
+This creates a directory named <tt>installation</tt>. Change to it and
+execute the setup script with the following commands:
</p>
<pre>
-cd setup;
+cd installation
./install.pl
</pre>
+<p>
+This script will prompt you for the MySQL root password and will download the latest LON-CAPA release.
+</p>
-<h2>Determine LON-CAPA Settings</h2>
+<h3>Determine LON-CAPA Settings</h3>
<p>
LON-CAPA requires a number of identifying parameters be set in order
for it to function at all. Below is a list with descriptions.
@@ -243,7 +201,7 @@
</dd>
</dl>
-<h2>Configuring LON-CAPA</h2>
+<h3>Configuring LON-CAPA</h3>
<p>
To configure and install LON-CAPA, execute the following commands:
</p>
@@ -305,3 +263,5 @@
automatic setup, please send us as much information as possible.
If some part of this document is unclear please let us know.
</p>
+
+</body>