version 1.10, 2004/07/15 14:34:56
|
version 1.13, 2004/11/19 21:08:47
|
Line 1
|
Line 1
|
<h1>Installing LON-CAPA on a Fedora Core 2 Linux System</h1> |
<html> |
|
<head><title>New installation instructions</title></head> |
|
<body> |
|
|
|
<h1>Installing LON-CAPA on a minimal Fedora Core 2 Linux System</h1> |
<p> |
<p> |
This document guides you through the process of setting up a new LON-CAPA |
This document guides you through the process of setting up a new LON-CAPA |
server running Fedora Core 2 (FC2). The computer will be configured solely as |
server running Fedora Core 2 (FC2) with a minimum of packages installed. |
a LON-CAPA server and will be expected to have no other services running |
The computer will be configured solely as a LON-CAPA server and will be |
on it. |
expected to have no other services running. Your server is expected to have |
|
a reasonably fast connection to the internet. |
</p><p> |
</p><p> |
More information is available at <a href="http://install.lon-capa.org/"> |
More information is available at <a href="http://install.lon-capa.org/"> |
http://install.lon-capa.org/</a>. |
http://install.lon-capa.org/</a>. |
Line 27 The installation process takes the follo
|
Line 32 The installation process takes the follo
|
<li> Obtain Fedora Linux </li> |
<li> Obtain Fedora Linux </li> |
<li> Determine Network Settings</li> |
<li> Determine Network Settings</li> |
<li> Install Fedora </li> |
<li> Install Fedora </li> |
<li> Uninstall the http server </li> |
<li> Updating your system </li> |
<li> Install LON-CAPA Dependencies </li> |
<li> Installing LON-CAPA </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> Create a Domain Coordinator </li> |
<li> Create a Domain Coordinator </li> |
<li> Start/Restart services </li> |
<li> Start/Restart services </li> |
<li> Log in to LON-CAPA </li> |
<li> Log in to LON-CAPA </li> |
Line 40 The installation process takes the follo
|
Line 41 The installation process takes the follo
|
|
|
<h2>Obtain Fedora Linux</h2> |
<h2>Obtain Fedora Linux</h2> |
<p> |
<p> |
Fedora linux ISO files can be obtained from the projects main site, |
FC2 ISO files can be obtained from the projects main site, |
<a href="http://fedora.redhat.com/">http://fedora.redhat.com/</a>. |
<a href="http://fedora.redhat.com/">http://fedora.redhat.com/</a>. |
</p> |
You will need only the first ISO image for the minimal install. |
|
</p> |
|
|
<h2>Determine Network Settings</h2> |
<h2>Determine Network Settings</h2> |
<p> |
<p> |
Line 58 DHCP is <em>not</em> supported.
|
Line 60 DHCP is <em>not</em> supported.
|
<li>domain name server(s) </li> |
<li>domain name server(s) </li> |
</ul> |
</ul> |
|
|
<h2>Install Fedora</h2> |
<h2>Minimal FC2 Install</h2> |
<p> |
<p> |
Installing Fedora is quite easy if you've installed any of the Red Hat products |
Installing Fedora is quite easy if you've installed any of the Red Hat products |
before. Some documentation is available from |
before. Some documentation is available from |
Line 89 There are a few sections that require co
|
Line 91 There are a few sections that require co
|
Additional ports used by LON-CAPA are 5663 and 8080. |
Additional ports used by LON-CAPA are 5663 and 8080. |
Enter these in the entry box as <nobr>"5663:tcp, 8080:tcp"</nobr>.</dd> |
Enter these in the entry box as <nobr>"5663:tcp, 8080:tcp"</nobr>.</dd> |
<dt>Package Group Selection</dt> |
<dt>Package Group Selection</dt> |
<dd> |
<dd>Choose 'minimal install'</dd> |
<b>Do not</b> install a web server. It is intentially omitted from |
|
this list. Installing packages not listed below is not recommended. |
|
If you install packages not listed below you should expect difficulties |
|
when installing the LON-CAPA dependencies. |
|
<ul> |
|
<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> |
|
</ul> |
|
</dd> |
|
</dl> |
</dl> |
<p> |
<p> |
Finish installing your server, reboot it, and log in as root. |
Finish installing your server, reboot it, and log in as root. |
</p> |
</p> |
|
|
<h2>Retrieving the LON-CAPA Installation Archive</h2> |
<h2>Updating your system</h2> |
<p> |
<p> |
Execute the following command: |
Retrieve the loncapa_yum.conf file from the LON-CAPA install site: |
</p> |
</p> |
<pre> |
<pre> |
wget http://install.loncapa.org/versions/fedora/fedora_install.tar |
wget http://install.loncapa.org/versions/fedora/loncapa_yum.conf |
</pre> |
</pre> |
<p> |
<p> |
This will retrieve from the LON-CAPA website all the packages needed to get |
Copy the loncapa_yum.conf file to /etc/yum.conf: |
LON-CAPA running on your system, except for the LON-CAPA source itself. |
|
</p> |
|
<p> |
|
Extract the archive with the following command: |
|
</p> |
</p> |
<pre> |
<pre> |
tar xf fedora_install.tar |
mv /etc/yum.conf /etc/yum.conf.backup |
|
cp loncapa_yum.conf /etc/yum.conf |
</pre> |
</pre> |
<p> |
<p> |
This creates a directory named <tt>installation</tt>. |
Update your system to the latest versions of the system software: |
</p> |
</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> |
<pre> |
rpm -e `rpm -q -a | grep mod_perl` |
yum update |
rpm -e `rpm -q -a | grep httpd` |
|
</pre> |
</pre> |
</p><p> |
<p> |
If the above commands returns no output (the usual indicator of success), or an |
You will need to reboot your system after yum finishes. Reboot your system before proceeding with the LON-CAPA install. |
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> |
|
|
<h2>Installing LON-CAPA Dependencies</h2> |
<h2>Installing LON-CAPA</h2> |
|
<h3>Install prerequisites</h3> |
|
<p> |
<p> |
<p> |
This section walks you through installing the packages which LON-CAPA requires. |
Installating the LON-CAPA prerequisites is pretty straightforward. Execute: |
There are a lot of dependencies. They have been grouped in a |
</p><pre> |
somewhat logical fashion to make them easier to deal with. When installing |
yum install LONCAPA-prerequisites ntp |
the rpms you should watch for errors. Errors generated by RPMs which are |
</pre><p> |
already should not be considered a problem, although you will have to ensure |
This may take a moment due to LON-CAPA's large number of dependencies. |
the other rpms in the directory get installed. |
|
</p> |
</p> |
|
<h3>Retrieve and execute LON-CAPA setup program</h3> |
<p> |
<p> |
To install the many LON-CAPA dependencies, execute the following commands: |
Retrieve the LON-CAPA setup with the following command: |
</p> |
</p> |
<pre> |
<pre> |
cd installation |
wget http://install.loncapa.org/versions/fedora/fedora_install.tar |
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 .. |
|
</pre> |
</pre> |
<p> |
<p> |
<b>Notes:</b> |
Extract the archive with the following command: |
<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> |
|
<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. We're still working on using gnuplot 4.0 which |
|
recently came out.</li> |
|
</ul> |
|
</p> |
</p> |
|
<pre> |
<h2>Configuring LON-CAPA Dependencies</h2> |
tar xf fedora_install.tar |
|
</pre> |
<p> |
<p> |
We have prepared a script which takes care of most of the configuration that |
This creates a directory named <tt>installation</tt>. Change to it and |
must be done to get the newly installed packages working with LON-CAPA. |
execute the setup script with the following commands: |
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: |
|
</p> |
</p> |
<pre> |
<pre> |
cd setup; |
cd installation |
./install.pl |
./install.pl |
</pre> |
</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> |
<p> |
LON-CAPA requires a number of identifying parameters be set in order |
LON-CAPA requires a number of identifying parameters be set in order |
for it to function at all. Below is a list with descriptions. |
for it to function at all. Below is a list with descriptions. |
Line 247 for it to function at all. Below is a l
|
Line 187 for it to function at all. Below is a l
|
</dd> |
</dd> |
</dl> |
</dl> |
|
|
<h2>Configuring LON-CAPA</h2> |
<h3>Configuring LON-CAPA</h3> |
<p> |
<p> |
To configure and install LON-CAPA, execute the following commands: |
To configure and install LON-CAPA, execute the following commands: |
</p> |
</p> |
Line 309 If there were errors in installation of
|
Line 249 If there were errors in installation of
|
automatic setup, please send us as much information as possible. |
automatic setup, please send us as much information as possible. |
If some part of this document is unclear please let us know. |
If some part of this document is unclear please let us know. |
</p> |
</p> |
|
|
|
</body> |