--- doc/build/fedora_install.frag 2003/12/12 21:31:05 1.1 +++ doc/build/fedora_install.frag 2004/06/01 21:23:02 1.5 @@ -1,7 +1,7 @@ -
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.
@@ -57,10 +57,6 @@ DHCP is not supported.
Installing Fedora is quite easy if you've installed any of the Red Hat products @@ -78,7 +74,9 @@ There are a few sections that require co however you should review the results and be prepared to modify them. 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 - 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 typically have 1 or 2x as much swap space as you do physical RAM.
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. +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. +
+First, we need to make sure the web server and mod_perl have not been +installed. Use the following commands to remove them if they exist: +
+
+rpm -e `rpm -q -a | grep httpd` +rpm -e `rpm -q -a | grep mod_perl` +
-The quick instructions are: +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. +
+To install the many LON-CAPA dependencies, execute the following commands:
cd installation @@ -166,10 +179,14 @@ cd .. Administering LON-CAPA machines does not yet mean becoming a database administrator.
-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
@@ -259,9 +276,23 @@ will be appearant at this step. /etc/init.d/loncontrol start /etc/init.d/httpd start - +
+If you receive warnings when starting the httpd about missing perl modules, +please make sure you followed the instructions in +Installing LON-CAPA Dependencies. If you still have errors, please +contact the LON-CAPA development team. +
Point a web browser at your new machine and log in as the domain coordinator. Congratulations!
+ ++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. +