--- doc/build/fedora_install.frag 2003/12/12 21:31:05 1.1 +++ doc/build/fedora_install.frag 2004/06/10 12:37:29 1.6 @@ -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. +
+ ++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: (Note: +The commands below use backticks, not single quotes.: +
++
+rpm -e `rpm -q -a | grep httpd` +rpm -e `rpm -q -a | grep mod_perl` ++
+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.
-The quick instructions are: +To install the many LON-CAPA dependencies, execute the following commands:
cd installation @@ -166,10 +187,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 +284,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. +