[BACK]Return to fedora_install.frag CVS log [TXT] [DIR] Up to [LON-CAPA] / doc / build

Diff for /doc/build/fedora_install.frag between versions 1.11 and 1.12

version 1.11, 2004/07/15 14:35:38 version 1.12, 2004/09/09 18:41:11
Line 1 Line 1
   <html>
   <head><title>New installation instructions</title></head>
   <body>
   
 <h1>Installing LON-CAPA on a Fedora Core 2 Linux System</h1>  <h1>Installing LON-CAPA on a Fedora Core 2 Linux System</h1>
 <p>  <p>
 This document guides you through the process of setting up a new LON-CAPA  This document guides you through the process of setting up a new LON-CAPA
Line 27  The installation process takes the follo Line 31  The installation process takes the follo
   <li> Obtain Fedora Linux </li>    <li> Obtain Fedora Linux </li>
   <li> Determine Network Settings</li>    <li> Determine Network Settings</li>
   <li> Install Fedora </li>    <li> Install Fedora </li>
   <li> Uninstall the http server </li>    <li> Updating your system </li>
   <li> Install LON-CAPA Dependencies </li>    <li> Installing LON-CAPA </li>
   <li> Determine your LON-CAPA Settings </li>  
   <li> Install LON-CAPA </li>  
   <li> Configure LON-CAPA </li>  
   <li> Pick a hosts.tab file </li>  
   <li> Create a Domain Coordinator </li>    <li> Create a Domain Coordinator </li>
   <li> Start/Restart services </li>    <li> Start/Restart services </li>
   <li> Log in to LON-CAPA </li>    <li> Log in to LON-CAPA </li>
Line 109  There are a few sections that require co Line 109  There are a few sections that require co
 Finish installing your server, reboot it, and log in as root.  Finish installing your server, reboot it, and log in as root.
 </p>  </p>
   
 <h2>Retrieving the LON-CAPA Installation Archive</h2>  <h2>Updating your system</h2>
 <p>  <p>
 Execute the following command:  Retrieve the loncapa_yum.conf file from the LON-CAPA install site:
 </p>  </p>
 <pre>  <pre>
 wget http://install.loncapa.org/versions/fedora/fedora_install.tar  wget http://install.loncapa.org/versions/fedora/loncapa_yum.conf 
 </pre>  </pre>
 <p>  <p>
 This will retrieve from the LON-CAPA website all the packages needed to get  Update your system to the latest versions of the system software:
 LON-CAPA running on your system, except for the LON-CAPA source itself.  
 </p>  
 <p>  
 Extract the archive with the following command:  
 </p>  </p>
 <pre>  <pre>
 tar xf fedora_install.tar  yum -c ./loncapa_yum.conf update
 </pre>  </pre>
 <p>  <p>
 This creates a directory named <tt>installation</tt>.  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.
 </p>  </p>
   
 <h2>Uninstall the http server</h2>  <h2>Installing LON-CAPA</h2>
 <p>  <h3>Install prerequisites</h3>
 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:  (<b>Note:</b>  
 <i>The commands below use backticks, not single quotes.</i>:  
 </p>  
 <p>  <p>
 <pre>  On our test install we needed to remove the httpd and system-config-httpd 
 rpm -e `rpm -q -a | grep mod_perl`  packages using the command: 
 rpm -e `rpm -q -a | grep httpd`  </p><pre>
   rpm -e httpd system-config-httpd
 </pre>  </pre>
 </p><p>  
 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.    
 </p>  
   
 <h2>Installing LON-CAPA Dependencies</h2>  
 <p>  <p>
 This section walks you through installing the packages which LON-CAPA requires.  Installating the LON-CAPA prerequisites is pretty straightforward.  Execute:
 There are a lot of dependencies.  They have been grouped in a  </p><pre>
 somewhat logical fashion to make them easier to deal with.  When installing  yum -c ./loncapa_yum.conf install LONCAPA-prerequisites
 the rpms you should watch for errors.  Errors generated by RPMs which are   </pre><p>
 already should not be considered a problem, although you will have to ensure   This may take a moment due to LON-CAPA's large number of dependencies.
 the other rpms in the directory get installed.  </p><p>
   If yum complains of conflicting packages you will need to uninstall them 
   using 'rpm -e <packagename>'.
 </p>  </p>
   <h3>Retrieve and execute LON-CAPA setup program</h3>
 <p>  <p>
 To install the many LON-CAPA dependencies, execute the following commands:  Retrieve the LON-CAPA setup with the following command:
 </p>  </p>
 <pre>  <pre>
 cd installation  wget http://install.loncapa.org/versions/fedora/fedora_install.tar
 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 ..  
 </pre>  </pre>
 <p>  <p>
 <b>Notes:</b>  Extract the archive with the following command:
 <ul>  
     <li>MySQL is used to store caches of data, not original copies.    
         Administering LON-CAPA machines does not yet mean becoming a   
         database administrator.</li>  
     <li>Apache 1.3 and mod_perl 1.x are required by LON-CAPA.  These are  
         provided in the installation package.  The mod_perl package has been  
         repackaged from the Redhat sources with the name 'mod_perl_1' in  
         order to prevent version 1.99 of mod_perl from being installed by   
         yum or other package managers.</li>  
 </ul>  
 </p>  </p>
   <pre>
 <h2>Configuring LON-CAPA Dependencies</h2>  tar xf fedora_install.tar
   </pre>
 <p>  <p>
 We have prepared a script which takes care of most of the configuration that  This creates a directory named <tt>installation</tt>.  Change to it and
 must be done to get the newly installed packages working with LON-CAPA.    execute the setup script with the following commands:
 This script will retrieve the latest LON-CAPA release from  
 <a href="http://install.loncapa.org">http://install.loncapa.org</a>.  
 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.  
 </p><p>  
 Execute the script as follows:  
 </p>  </p>
 <pre>  <pre>
 cd setup;  cd installation
 ./install.pl  ./install.pl
 </pre>  </pre>
   <p>
   This script will prompt you for the MySQL root password and will download the latest LON-CAPA release.
   </p>
   
 <h2>Determine LON-CAPA Settings</h2>  <h3>Determine LON-CAPA Settings</h3>
 <p>  <p>
 LON-CAPA requires a number of identifying parameters be set in order  LON-CAPA requires a number of identifying parameters be set in order
 for it to function at all.  Below is a list with descriptions.  for it to function at all.  Below is a list with descriptions.
Line 243  for it to function at all.  Below is a l Line 201  for it to function at all.  Below is a l
   </dd>    </dd>
 </dl>  </dl>
   
 <h2>Configuring LON-CAPA</h2>  <h3>Configuring LON-CAPA</h3>
 <p>  <p>
 To configure and install LON-CAPA, execute the following commands:  To configure and install LON-CAPA, execute the following commands:
 </p>  </p>
Line 305  If there were errors in installation of Line 263  If there were errors in installation of
 automatic setup, please send us as much information as possible.  automatic setup, please send us as much information as possible.
 If some part of this document is unclear please let us know.  If some part of this document is unclear please let us know.
 </p>  </p>
   
   </body>
Removed from v.1.11  
changed lines
  Added in v.1.12

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>