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 -a LON-CAPA server and will be expected to have no other services running -on it. +server running Fedora Core 2 (FC2) with a minimum of packages installed. +The computer will be configured solely as a LON-CAPA server and will be +expected to have no other services running. Your server is expected to have +a reasonably fast connection to the internet.
More information is available at http://install.lon-capa.org/. @@ -27,11 +32,8 @@ The installation process takes the follo
-Fedora linux ISO files can be obtained from the projects main site, +FC2 ISO files can be obtained from the projects main site, http://fedora.redhat.com/. -
+You will need only the first ISO image for the minimal install. +@@ -57,11 +60,7 @@ DHCP is not supported.
Installing Fedora is quite easy if you've installed any of the Red Hat products before. Some documentation is available from @@ -78,7 +77,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.
Finish installing your server, reboot it, and log in as root.
--Execute the following command: +Retrieve the loncapa_yum.conf file from the LON-CAPA install site:
-wget http://install.loncapa.org/versions/fedora/fedora_install.tar +wget http://install.loncapa.org/versions/fedora/loncapa_yum.conf
-This will retrieve from the LON-CAPA website all the packages needed to get -LON-CAPA running on your system, except for the LON-CAPA source itself. +Copy the loncapa_yum.conf file to /etc/yum.conf:
++mv /etc/yum.conf /etc/yum.conf.backup +cp loncapa_yum.conf /etc/yum.conf +
-Extract the archive with the following command: +Update your system to the latest versions of the system software:
-tar xf fedora_install.tar +yum update
-This creates a directory named installation. +You will need to reboot your system after yum finishes. Reboot your system before proceeding with the LON-CAPA install.
--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 -somewhat logical fashion to make them easier to deal with. When installing -the rpms you should watch for errors. -
-The quick instructions are: +
+Installating the LON-CAPA prerequisites is pretty straightforward. Execute: +
+yum install LONCAPA-prerequisites ntp +
+This may take a moment due to LON-CAPA's large number of dependencies. +
++Retrieve the LON-CAPA setup with the following command:
-cd installation -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 .. +wget http://install.loncapa.org/versions/fedora/fedora_install.tar
-Notes: -
+tar xf fedora_install.tar +
-We have prepared a script which takes care of most of the configuration that -must be done to get the newly installed packages working with LON-CAPA. -This script will retrieve the latest LON-CAPA release from -http://install.loncapa.org. -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. -
-Execute the script as follows: +This creates a directory named installation. Change to it and +execute the setup script with the following commands:
-cd setup; +cd installation ./install.pl+
+This script will prompt you for the MySQL root password and will download the latest LON-CAPA release. +
-LON-CAPA requires a number of identifying parameters be set in order for it to function at all. Below is a list with descriptions. @@ -221,12 +187,12 @@ for it to function at all. Below is a l -
To configure and install LON-CAPA, execute the following commands:
-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
@@ -248,6 +214,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. +
+ +