--- doc/build/Attic/upgrade.html	2000/10/26 07:31:16	1.2
+++ doc/build/Attic/upgrade.html	2002/04/23 11:55:11	1.7
@@ -1,59 +1,93 @@
-<HTML>
-<HEAD>
-<TITLE>LON-CAPA Upgrade</TITLE>
-</HEAD>
-<BODY>
-<H1>LON-CAPA Upgrade</H1>
-<H3>Current Upgrade Procedure (Almost)</H3>
-<P>
+<html>
+<head>
+<title>LON-CAPA Upgrade</title>
+<!-- pdfahref upgrade.pdf -->
+<!-- button UPGRADE -->
+</head>
+<body>
+<!-- preamble start -->
+<h1>LON-CAPA Upgrade</h1>
+<h3>Current Upgrade Procedure</h3>
+<!-- preamble end -->
+<!-- maintext start -->
+<p>
+Scott Harrison
+</p>
+<p>
+Last updated: 4/18/2001
+</p>
+<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 <A HREF="http://install.lon-capa.org/verify/scripts/loncapaverifypackages">
-loncapaverifypackages</A>.  This script should be present on your system in the file
-/usr/sbin/loncapaverifypackages.  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 /usr/sbin/<A HREF="http://www.lon-capa.org/install/verify/scripts/loncapaupgradepackages">loncapaupgradepackages</A>.
-<LI>Or, going to <A HREF="http://www.lon-capa.org/install/RPMS/">http://www.lon-capa.org/install/RPMS/</A>,
-you can individual 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.
-</UL>
-</UL>
-<LI>Restore configuration files.
-<UL>
-<LI>As you run /usr/sbin/loncapaupgradepackages or enter in <TT>rpm -Uvh --force</TT> commands, you may
+<ol>
+<li>Make sure your software packages are up-to-date
+(based on install.lon-capa.org).</li>
+<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>.</li>
+</ul>
+<li>Upgrade old software packages.</li>
+<ul>
+<li>Upgrade software packages by either</li>
+<ul>
+<li>Running <tt>/usr/sbin/loncapaupgradepackages</tt>.</li>
+<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.</li>
+</ul>
+</ul>
+<li>Make the LON-CAPA base files up to date (based on
+install.lon-capa.org).</li>
+<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>
+<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.</li>
+</ul>
+<li>Restore configuration files.</li>
+<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 /usr/sbin/<A HREF="http://www.lon-capa.org/install/verify/scripts/loncaparestoreconfigurations">loncaparestoreconfigurations</A> to "smartly" run through the system and restore LON-CAPA configuration values.
-</UL>
-<LI>Should you wish to automate all of this, you can (at your own risk) enable a script which will
-do all of this automatically.  <B>This definitely should NOT be implemented on a system that students
-are using)</B>.  You can enable this script by entering the command:
-<TT>cp /usr/sbin/<A HREF="http://www.lon-capa.org/install/verify/scripts/loncapaautoupgrade">loncapaautoupgrade</A> /etc/cron.daily/loncapaautoupgrade</TT>
-</OL>
-</P>
-<H3>Future Upgrade Procedure (not yet implemented)</H3>
-<P>
+<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.</li>
+</ul>
+<li>Restart the LON-CAPA networking processes
+<ul>
+<li><tt>/etc/rc.d/init.d/loncontrol restart</tt></li>
+</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></li>
+</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>
\ No newline at end of file
+</p>
+<!-- maintext end -->
+</body>
+</html>
