version 1.3, 2004/03/17 18:49:45
|
version 1.12, 2004/09/09 18:41:11
|
Line 1
|
Line 1
|
<h1>Installing LON-CAPA on a Fedora Linux System</h1> |
<html> |
|
<head><title>New installation instructions</title></head> |
|
<body> |
|
|
|
<h1>Installing LON-CAPA on a 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 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 |
a LON-CAPA server and will be expected to have no other services running |
on it. |
on it. |
</p><p> |
</p><p> |
Line 27 The installation process takes the follo
|
Line 31 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> Install LON-CAPA Dependencies </li> |
<li> Updating your system </li> |
<li> Determine your LON-CAPA Settings </li> |
<li> Installing LON-CAPA </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 57 DHCP is <em>not</em> supported.
|
Line 58 DHCP is <em>not</em> supported.
|
<li>domain name server(s) </li> |
<li>domain name server(s) </li> |
</ul> |
</ul> |
|
|
<h2>Gather needed information</h2> |
|
|
|
|
|
|
|
<h2>Install Fedora</h2> |
<h2>Install Fedora</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 |
Line 101 There are a few sections that require co
|
Line 98 There are a few sections that require co
|
<li>Editors</li> |
<li>Editors</li> |
<li>Text Based Internet</li> |
<li>Text Based Internet</li> |
<li>Authoring and Publishing</li> |
<li>Authoring and Publishing</li> |
<li>Development Tools |
<li>Server Configuration Tools</li> |
<li>Administration Tools |
<li>Development Tools</li> |
<li>Printing Support |
<li>Administration Tools</li> |
|
<li>Printing Support</li> |
</ul> |
</ul> |
</dd> |
</dd> |
</dl> |
</dl> |
Line 111 There are a few sections that require co
|
Line 109 There are a few sections that require co
|
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 |
Update your system to the latest versions of the system software: |
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 |
yum -c ./loncapa_yum.conf update |
</pre> |
</pre> |
<p> |
<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> |
</p> |
|
|
<h2>Installing LON-CAPA Dependencies</h2> |
<h2>Installing LON-CAPA</h2> |
|
<h3>Install prerequisites</h3> |
<p> |
<p> |
This section walks you through installing the packages which LON-CAPA requires. |
On our test install we needed to remove the httpd and system-config-httpd |
There are a lot of dependencies. They have been grouped in a |
packages using the command: |
somewhat logical fashion to make them easier to deal with. When installing |
</p><pre> |
the rpms you should watch for errors. |
rpm -e httpd system-config-httpd |
|
</pre> |
|
<p> |
|
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> |
</p><p> |
The quick instructions are: |
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> |
|
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 --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 |
|
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. |
|
<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> |
|
</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 223 for it to function at all. Below is a l
|
Line 201 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> |
<pre> |
<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 |
./UPDATE |
</pre> |
</pre> |
<p> |
<p> |
Line 250 appropriate user name and your domain.
|
Line 228 appropriate user name and your domain.
|
cd /root/loncapa-N.N/loncom/build |
cd /root/loncapa-N.N/loncom/build |
perl make_domain_coordinator.pl USERNAME DOMAIN |
perl make_domain_coordinator.pl USERNAME DOMAIN |
(WILL PROMPT FOR PASSWORD HERE) |
(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> |
</pre> |
|
|
<h2>Start/Restart Services</h2> |
<h2>Start/Restart Services</h2> |
Line 261 will be appearant at this step.
|
Line 243 will be appearant at this step.
|
/etc/init.d/loncontrol start |
/etc/init.d/loncontrol start |
/etc/init.d/httpd start |
/etc/init.d/httpd start |
</pre> |
</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> |
<h2>Log in to your LON-CAPA Machine</h2> |
<p> |
<p> |
Point a web browser at your new machine and log in as the domain |
Point a web browser at your new machine and log in as the domain |
coordinator. Congratulations! |
coordinator. Congratulations! |
</p> |
</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> |
|
|
|
</body> |