[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.1 and 1.6

version 1.1, 2003/12/12 21:31:05 version 1.6, 2004/06/10 12:37:29
Line 1 Line 1
 <h1>Installing LON-CAPA on a Fedora 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
 server running Fedora Linux.  The computer will be configured solely as  server running Fedora Core 2 (FC2).  The computer will be configured solely as
 a LON-CAPA server and will be expected to have no other services running  a LON-CAPA server and will be expected to have no other services running
 on it.  on it.
 </p><p>  </p><p>
Line 57  DHCP is <em>not</em> supported. Line 57  DHCP is <em>not</em> supported.
   <li>domain name server(s) </li>    <li>domain name server(s) </li>
 </ul>  </ul>
   
 <h2>Gather needed information</h2>  
   
   
   
 <h2>Install Fedora</h2>  <h2>Install Fedora</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
Line 78  There are a few sections that require co Line 74  There are a few sections that require co
        however you should review the results and be prepared to modify them.         however you should review the results and be prepared to modify them.
        LON-CAPA resource files are stored in the /home directory, so the         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          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         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.</dd>         typically have 1 or 2x as much swap space as you do physical RAM.</dd>
    <dt>Network Configuration</dt>     <dt>Network Configuration</dt>
Line 99  There are a few sections that require co Line 97  There are a few sections that require co
          <li>Editors</li>           <li>Editors</li>
          <li>Text Based Internet</li>           <li>Text Based Internet</li>
          <li>Authoring and Publishing</li>           <li>Authoring and Publishing</li>
          <li>Development Tools           <li>Server Configuration Tools</li>
          <li>Administration Tools           <li>Development Tools</li>
          <li>Printing Support           <li>Administration Tools</li>
            <li>Printing Support</li>
       </ul>        </ul>
    </dd>     </dd>
 </dl>  </dl>
Line 133  This creates a directory named <tt>insta Line 132  This creates a directory named <tt>insta
 <h2>Installing LON-CAPA Dependencies</h2>  <h2>Installing LON-CAPA Dependencies</h2>
 <p>  <p>
 This section walks you through installing the packages which LON-CAPA requires.  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  There are a lot of dependencies.  They have been grouped in a
 somewhat logical fashion to make them easier to deal with.  When installing  somewhat logical fashion to make them easier to deal with.  When installing
 the rpms you should watch for errors.  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.
   </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>
   rpm -e `rpm -q -a | grep httpd`
   rpm -e `rpm -q -a | grep mod_perl`
   </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><p>  </p><p>
 The quick instructions are:  To install the many LON-CAPA dependencies, execute the following commands:
 </p>  </p>
 <pre>  <pre>
 cd installation  cd installation
Line 166  cd .. Line 187  cd ..
         Administering LON-CAPA machines does not yet mean becoming a           Administering LON-CAPA machines does not yet mean becoming a 
         database administrator.</li>          database administrator.</li>
     <li>Apache 1.3 and mod_perl 1.x are required by LON-CAPA.  These are      <li>Apache 1.3 and mod_perl 1.x are required by LON-CAPA.  These are
         provided in the installation package.          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      <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          install a version different from the one included in the LON-CAPA
         installation package.</li>          installation package.  We're still working on using gnuplot 4.0 which
           recently came out.</li>
 </ul>  </ul>
 </p>  </p>
   
Line 226  for it to function at all.  Below is a l Line 251  for it to function at all.  Below is a l
 To configure and install LON-CAPA, execute the following commands:  To configure and install LON-CAPA, execute the following commands:
 </p>  </p>
 <pre>  <pre>
 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  ./UPDATE
 </pre>  </pre>
 <p>  <p>
Line 259  will be appearant at this step. Line 284  will be appearant at this step.
 /etc/init.d/loncontrol start  /etc/init.d/loncontrol start
 /etc/init.d/httpd start  /etc/init.d/httpd start
 </pre>  </pre>
   <p>
   If you receive warnings when starting the httpd about missing perl modules,
   please make sure you followed the instructions in 
   <b>Installing LON-CAPA Dependencies</b>.  If you still have errors, please
   contact the LON-CAPA development team.
   </p>
 <h2>Log in to your LON-CAPA Machine</h2>  <h2>Log in to your LON-CAPA Machine</h2>
 <p>  <p>
 Point a web browser at your new machine and log in as the domain  Point a web browser at your new machine and log in as the domain
 coordinator.  Congratulations!  coordinator.  Congratulations!
 </p>  </p>
   
   <h2>If Things aren't working right</h2>
   <p>
   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.
   </p>
Removed from v.1.1  
changed lines
  Added in v.1.6

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