--- doc/build/fedora_install.frag 2004/06/10 12:37:29 1.6 +++ doc/build/fedora_install.frag 2004/09/09 18:41:11 1.12 @@ -1,3 +1,7 @@ + +
This document guides you through the process of setting up a new LON-CAPA @@ -27,11 +31,8 @@ The installation process takes the follo
-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. -
--Extract the archive with the following command: +Update your system to the latest versions of the system software:
-tar xf fedora_install.tar +yum -c ./loncapa_yum.conf update
-This creates a directory named installation. +You will probably need to reboot your system, specifically when a new kernel is +installed. 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. 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. 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. -
- -+rpm -e httpd system-config-httpd +
-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.: +Installating the LON-CAPA prerequisites is pretty straightforward. Execute: +
+yum -c ./loncapa_yum.conf install LONCAPA-prerequisites +
+This may take a moment due to LON-CAPA's large number of dependencies. +
+If yum complains of conflicting packages you will need to uninstall them
+using 'rpm -e
-
-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. -
-To install the many LON-CAPA dependencies, execute the following commands: +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. @@ -246,7 +201,7 @@ for it to function at all. Below is a l -
To configure and install LON-CAPA, execute the following commands:
@@ -273,6 +228,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