Diff for /doc/build/Attic/upgrade.html between versions 1.3 and 1.16

version 1.3, 2000/10/26 07:48:33 version 1.16, 2002/06/02 04:02:09
Line 1 Line 1
 <HTML>  
 <HEAD>  
 <TITLE>LON-CAPA Upgrade</TITLE>  
 </HEAD>  
 <BODY>  
 <H1>LON-CAPA Upgrade</H1>  
 <H3>Current Upgrade Procedure</H3>  
 <P>  
 LON-CAPA system releases currently are not released under version  
 numbers given the fast pace of system development.  To upgrade your  
 system, you need to   
 <OL>  
 <LI>Make sure your software packages are up-to-date (based on install.lon-capa.org).  
 <UL>  
 <LI>As root, run the script <TT>/usr/sbin/loncapaverifypackages</TT>.    
 If packages are out-of-date, this script will output  
 the out-of-date packages.  Packages that this script identifies as "should not be here",  
 are packages that you may wish to remove to improve system security.  (These packages  
 may represent important modifications of your institution, so do with care.  Removing  
 packages is done with the command: <TT>rpm -e --nodeps PACKAGE_NAME</TT>.  
 </UL>  
 <LI>Upgrade old software packages.  
 <UL>  
 <LI>Upgrade software packages by either  
 <UL>  
 <LI>Running <TT>/usr/sbin/loncapaupgradepackages</TT>.  
 <LI>Or, going to <A HREF="http://install.lon-capa.org/3.1/SupplementalRPMS/">http://install.lon-capa.org/3.1/SupplementalRPMS/</A>,  
 you can individually download each package from the world-wide web.  You then need to enter the command:  
 <TT>rpm -Uvh --force PACKAGE_RPM_FILE_NAME</TT> to upgrade your system for each package.  
 </UL>  
 </UL>  
 <LI>Make the LON-CAPA base files up to date (based on install.lon-capa.org).  
 <UL>  
 <LI><B>[optional]</B> Run the script <TT>/usr/sbin/loncapaverifybasepackage</TT>.  Then view /home/httpd/html/dev/index.html for the verification report.  
 If there are no real changes, then you do not need to make your files up-to-date.  
 <LI>Download the most recent LON-CAPA rpm (<A HREF="http://install.lon-capa.org/3.1/loncapafiles/LON-CAPA-base-3.1-1.i386.rpm">  
 LON-CAPA-base-3.1-1.i386.rpm</A>).  <TT>rpm -Uvh --force LON-CAPA-base-3.1-1.i386.rpm</TT> will upgrade your software package files.  
 </UL>  
 <LI>Restore configuration files.  
 <UL>  
 <LI>As you run /usr/sbin/loncapaupgradepackages or enter in <TT>rpm -Uvh --force</TT> commands, you may  
 see messages appear on your screen such as:  
 <BR><TT>warning: /etc/httpd/conf/access.conf saved as /etc/httpd/conf/access.conf.rpmsave</TT>  
 <BR>You can probably just type in commands like:  
 <BR><TT>cp /etc/httpd/conf/access.conf.rpmsave /etc/httpd/conf/access.conf</TT>  
 <BR>to restore your configurations.  However, it is worthwhile to use the 'diff' command  
 to make sure that you are not accidentally losing important updates to the configuration  
 files.    
 <LI>Alternatively, you can run <TT>/usr/sbin/loncaparestoreconfigurations</TT> to "smartly" run through the system and restore LON-CAPA configuration values.  
 </UL>  
 <LI>Should you wish to automate the updating of your LON-CAPA base files, you can (at your own risk) run a script which will  
 do all of this automatically.  You can run this script by entering the command:  
 <TT>/usr/sbin/loncapaautoupgrade</TT>  
 </OL>  
 </P>  
 <H3>Future Upgrade Procedure (not yet implemented)</H3>  
 <P>  
 In the future, LON-CAPA will be a versioned system that is released via CD.  
 The upgrade procedure will be to insert the CD and follow instructions.  The CD  
 upgrade procedure is already defined and somewhat implemented, but awaits  
 completion.  
 </P>  
 </BODY>  
 </HTML>  
   
   <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
   <!-- $Id$ -->
   <html>
   <head>
   <meta http-equiv="Content-Type" content="text/html; charset=utf-8"></meta>
   <title>LON-CAPA Upgrade</title>
   <!-- pdfahref upgrade.pdf -->
   <!-- button UPGRADE -->
   </head>
   <body>
   <!-- preamble start -->
   <br />&nbsp;
   <p>
   There are three steps for upgrading the software on your LON-CAPA server.
   </p>
   <ul>
   <li><a href="#upgrade">
   Upgrading LON-CAPA files</a></li>
   <li><a href="#checkrpms">
   Checking your Linux RPMs</a></li>
   <li><a href="#testing">
   Testing to see if the LON-CAPA server is operational</a></li>
   </ul>
   <br />&nbsp;<br />
   <!-- preamble end -->
   <!-- maintext start -->
   <a name="upgrade" />
   <h3>Upgrading LON-CAPA files</h3>
   <p>
   Download the most current
   <a href="http://install.lon-capa.org/versions/current/loncapa.tar.gz">
   loncapa.tar.gz</a>.
   </p>
   <table bgcolor="#aaaaaa" border="1">
   <tr><td><tt>wget http://install.lon-capa.org/versions/current/loncapa.tar.gz
   </tt>
   <br />
   <tt>tar xzvf loncapa.tar.gz</tt>
   <br />
   <tt>cd loncapa</tt></td></tr>
   </table>
   <p>
   The <strong>UPDATE</strong> command will refresh your filesystem with all
   the latest LON-CAPA software.
   </p>
   <table bgcolor="#aaaaaa" border="1">
   <tr><td><tt>./UPDATE</tt></td></tr>
   </table>
   <a name="checkrpms" />
   <h3>Checking your Linux RPMs</h3>
   <p>
   The <strong>CHECKRPMS</strong> command will check the RPMs on your machine
   against an FTP repository.
   </p>
   <table bgcolor="#aaaaaa" border="1">
   <tr><td><tt>./CHECKRPMS</tt></td></tr>
   </table>
   <a name="testing" />
   <h3>Testing to see if the LON-CAPA server is operational</h3>
   <p>
   The <strong>TEST</strong> command will check the installation software,
   the perl libraries on your system, the MySQL database, and
   will also automatically test the real-time operation of the 
   LON-CAPA Apache web server.
   </p>
   <table bgcolor="#aaaaaa" border="1">
   <tr><td><tt>./TEST</tt></td></tr>
   </table>
   <p>
   Using the <strong>TEST</strong> command will likely
   be an iterative process.
   It is normal to expect that the <strong>TEST</strong> command
   will recommend you perform various steps to ensure optimal
   performance of your LON-CAPA server.
   </p>
   <!-- maintext end -->
   <!-- validated -->
   </body>
   </html>

Removed from v.1.3  
changed lines
  Added in v.1.16


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