--- doc/build/fedora_install.frag 2004/07/15 14:35:38 1.11 +++ doc/build/fedora_install.frag 2004/09/09 18:41:11 1.12 @@ -1,3 +1,7 @@ + +New installation instructions + +

Installing LON-CAPA on a Fedora Core 2 Linux System

This document guides you through the process of setting up a new LON-CAPA @@ -27,12 +31,8 @@ The installation process takes the follo

  • Obtain Fedora Linux
  • Determine Network Settings
  • Install Fedora
  • -
  • Uninstall the http server
  • -
  • Install LON-CAPA Dependencies
  • -
  • Determine your LON-CAPA Settings
  • -
  • Install LON-CAPA
  • -
  • Configure LON-CAPA
  • -
  • Pick a hosts.tab file
  • +
  • Updating your system
  • +
  • Installing LON-CAPA
  • Create a Domain Coordinator
  • Start/Restart services
  • Log in to LON-CAPA
  • @@ -109,110 +109,68 @@ There are a few sections that require co Finish installing your server, reboot it, and log in as root.

    -

    Retrieving the LON-CAPA Installation Archive

    +

    Updating your system

    -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.

    -

    Uninstall the http server

    -

    -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.: -

    +

    Installing LON-CAPA

    +

    Install prerequisites

    -

    -rpm -e `rpm -q -a | grep mod_perl`
    -rpm -e `rpm -q -a | grep httpd`
    +On our test install we needed to remove the httpd and system-config-httpd 
    +packages using the command: 
    +

    +rpm -e httpd system-config-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. -

    - -

    Installing LON-CAPA Dependencies

    -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. +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 '.

    - +

    Retrieve and execute LON-CAPA setup program

    -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 -Uvh *rpm
    -cd ../misc
    -rpm -Uvh *rpm
    -cd ..
    +wget http://install.loncapa.org/versions/fedora/fedora_install.tar
     

    -Notes: -

    +Extract the archive with the following command:

    - -

    Configuring LON-CAPA Dependencies

    +
    +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. +

    -

    Determine LON-CAPA Settings

    +

    Determine LON-CAPA Settings

    LON-CAPA requires a number of identifying parameters be set in order for it to function at all. Below is a list with descriptions. @@ -243,7 +201,7 @@ for it to function at all. Below is a l -

    Configuring LON-CAPA

    +

    Configuring LON-CAPA

    To configure and install LON-CAPA, execute the following commands:

    @@ -305,3 +263,5 @@ If there were errors in installation of automatic setup, please send us as much information as possible. If some part of this document is unclear please let us know.

    + +