[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.10 and 1.13

version 1.10, 2004/07/15 14:34:56 version 1.13, 2004/11/19 21:08:47
Line 1 Line 1
 <h1>Installing LON-CAPA on a Fedora Core 2 Linux System</h1>  <html>
   <head><title>New installation instructions</title></head>
   <body>
   
   <h1>Installing LON-CAPA on a minimal 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
 server running Fedora Core 2 (FC2).  The computer will be configured solely as  server running Fedora Core 2 (FC2) with a minimum of packages installed.  
 a LON-CAPA server and will be expected to have no other services running  The computer will be configured solely as a LON-CAPA server and will be 
 on it.  expected to have no other services running.  Your server is expected to have
   a reasonably fast connection to the internet.
 </p><p>  </p><p>
 More information is available at <a href="http://install.lon-capa.org/">  More information is available at <a href="http://install.lon-capa.org/">
 http://install.lon-capa.org/</a>.  http://install.lon-capa.org/</a>.
Line 27  The installation process takes the follo Line 32  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 40  The installation process takes the follo Line 41  The installation process takes the follo
   
 <h2>Obtain Fedora Linux</h2>  <h2>Obtain Fedora Linux</h2>
 <p>  <p>
 Fedora linux ISO files can be obtained from the projects main site,  FC2 ISO files can be obtained from the projects main site,
 <a href="http://fedora.redhat.com/">http://fedora.redhat.com/</a>.  <a href="http://fedora.redhat.com/">http://fedora.redhat.com/</a>.
 </p>  You will need only the first ISO image for the minimal install.
   </p> 
   
 <h2>Determine Network Settings</h2>  <h2>Determine Network Settings</h2>
 <p>  <p>
Line 58  DHCP is <em>not</em> supported. Line 60  DHCP is <em>not</em> supported.
   <li>domain name server(s) </li>    <li>domain name server(s) </li>
 </ul>  </ul>
   
 <h2>Install Fedora</h2>  <h2>Minimal FC2 Install</h2>
 <p>  <p>
 Installing Fedora is quite easy if you've installed any of the Red Hat products  Installing Fedora is quite easy if you've installed any of the Red Hat products
 before.  Some documentation is available from   before.  Some documentation is available from 
Line 89  There are a few sections that require co Line 91  There are a few sections that require co
        Additional ports used by LON-CAPA are 5663 and 8080.           Additional ports used by LON-CAPA are 5663 and 8080.  
        Enter these in the entry box as <nobr>"5663:tcp, 8080:tcp"</nobr>.</dd>         Enter these in the entry box as <nobr>"5663:tcp, 8080:tcp"</nobr>.</dd>
    <dt>Package Group Selection</dt>     <dt>Package Group Selection</dt>
    <dd>     <dd>Choose 'minimal install'</dd>
        <b>Do not</b> install a web server.  It is intentially omitted from  
        this list.  Installing packages not listed below is not recommended.  
        If you install packages not listed below you should expect difficulties  
        when installing the LON-CAPA dependencies.  
       <ul>  
          <li>Editors</li>  
          <li>Text Based Internet</li>  
          <li>Authoring and Publishing</li>  
          <li>Server Configuration Tools</li>  
          <li>Development Tools</li>  
          <li>Administration Tools</li>  
          <li>Printing Support</li>  
       </ul>  
    </dd>  
 </dl>  </dl>
 <p>  <p>
 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  Copy the loncapa_yum.conf file to /etc/yum.conf:
 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  mv /etc/yum.conf /etc/yum.conf.backup
   cp loncapa_yum.conf /etc/yum.conf
 </pre>  </pre>
 <p>  <p>
 This creates a directory named <tt>installation</tt>.  Update your system to the latest versions of the system software:
 </p>  </p>
   
 <h2>Uninstall the http server</h2>  
 <p>  
 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>  
 <pre>  <pre>
 rpm -e `rpm -q -a | grep mod_perl`  yum update
 rpm -e `rpm -q -a | grep httpd`  
 </pre>  </pre>
 </p><p>  <p>
 If the above commands returns no output (the usual indicator of success), or an  You will need to reboot your system after yum finishes.  Reboot your system before proceeding with the LON-CAPA install.
 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>  </p>
   
 <h2>Installing LON-CAPA Dependencies</h2>  <h2>Installing LON-CAPA</h2>
   <h3>Install prerequisites</h3>
   <p>
 <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 install LONCAPA-prerequisites ntp
 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>
   <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>  
     <li>A specific version of Gnuplot is required by LON-CAPA.  Do not  
         install a version different from the one included in the LON-CAPA  
         installation package.  We're still working on using gnuplot 4.0 which  
         recently came out.</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 247  for it to function at all.  Below is a l Line 187  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 309  If there were errors in installation of Line 249  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.10  
changed lines
  Added in v.1.13

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