version 1.1, 2003/12/12 21:31:05
|
version 1.7, 2004/06/11 14:50:58
|
Line 1
|
Line 1
|
<h1>Installing LON-CAPA on a Fedora Linux System</h1> |
<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 27 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> Install LON-CAPA Dependencies </li> |
<li> Install LON-CAPA Dependencies </li> |
<li> Determine your LON-CAPA Settings </li> |
<li> Determine your LON-CAPA Settings </li> |
<li> Install LON-CAPA </li> |
<li> Install 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 78 There are a few sections that require co
|
Line 75 There are a few sections that require co
|
however you should review the results and be prepared to modify them. |
however you should review the results and be prepared to modify them. |
LON-CAPA resource files are stored in the /home directory, so the |
LON-CAPA resource files are stored in the /home directory, so the |
lion's share of the drive should be allocated here. If you have 20 GB |
lion's share of the drive should be allocated here. If you have 20 GB |
of space for Fedora, /home should receive 16 gigs. Be sure to |
of space for Red Hat, /home should receive at least 10 to 12 gigs. |
|
Since MySQL uses the /var filesystem to store its databases you should |
|
have at least 4 gigs of space available on /var. Be sure to |
include adequate swap space. A minimum is 512 Megs, but you should |
include adequate swap space. A minimum is 512 Megs, but you should |
typically have 1 or 2x as much swap space as you do physical RAM.</dd> |
typically have 1 or 2x as much swap space as you do physical RAM.</dd> |
<dt>Network Configuration</dt> |
<dt>Network Configuration</dt> |
Line 99 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 130 tar xf fedora_install.tar
|
Line 130 tar xf fedora_install.tar
|
This creates a directory named <tt>installation</tt>. |
This creates a directory named <tt>installation</tt>. |
</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> |
|
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> |
|
|
<h2>Installing LON-CAPA Dependencies</h2> |
<h2>Installing LON-CAPA Dependencies</h2> |
<p> |
<p> |
This section walks you through installing the packages which LON-CAPA requires. |
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 |
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 |
</p><p> |
already should not be considered a problem, although you will have to ensure |
The quick instructions are: |
the other rpms in the directory get installed. |
|
</p> |
|
|
|
<p> |
|
To install the many LON-CAPA dependencies, execute the following commands: |
</p> |
</p> |
<pre> |
<pre> |
cd installation |
cd installation |
Line 166 cd ..
|
Line 190 cd ..
|
Administering LON-CAPA machines does not yet mean becoming a |
Administering LON-CAPA machines does not yet mean becoming a |
database administrator.</li> |
database administrator.</li> |
<li>Apache 1.3 and mod_perl 1.x are required by LON-CAPA. These are |
<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 |
<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 |
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> |
</ul> |
</p> |
</p> |
|
|
Line 226 for it to function at all. Below is a l
|
Line 254 for it to function at all. Below is a l
|
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 259 will be appearant at this step.
|
Line 287 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> |