--- doc/build/fedora_install.frag 2004/03/17 18:49:45 1.3 +++ doc/build/fedora_install.frag 2004/07/15 14:34:56 1.10 @@ -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.
@@ -27,6 +27,7 @@ The installation process takes the follo
Installing Fedora is quite easy if you've installed any of the Red Hat products @@ -101,9 +98,10 @@ There are a few sections that require co
+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 mod_perl` +rpm -e `rpm -q -a | grep httpd` ++
+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. +
+This section walks you through installing the packages which LON-CAPA requires. 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 quick instructions are: +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. +
+ ++To install the many LON-CAPA dependencies, execute the following commands:
cd installation @@ -154,9 +176,7 @@ 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 +rpm -Uvh *rpm cd ../misc rpm -Uvh *rpm cd .. @@ -168,10 +188,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
@@ -250,6 +274,10 @@ appropriate user name and your domain. cd /root/loncapa-N.N/loncom/build perl make_domain_coordinator.pl USERNAME DOMAIN (WILL PROMPT FOR PASSWORD HERE) +mkdir ~USERNAME/public_html +chown USERNAME:www ~USERNAME/public_html +chmod 0775 ~USERNAME/public_html +chmod a+x ~USERNAME
+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. +