version 1.7, 2002/04/23 11:55:11
|
version 1.13, 2002/05/01 22:16:30
|
Line 1
|
Line 1
|
|
<!-- $Id$ --> |
<html> |
<html> |
<head> |
<head> |
<title>LON-CAPA Upgrade</title> |
<title>LON-CAPA Upgrade</title> |
Line 6
|
Line 7
|
</head> |
</head> |
<body> |
<body> |
<!-- preamble start --> |
<!-- preamble start --> |
<h1>LON-CAPA Upgrade</h1> |
<br /> |
<h3>Current Upgrade Procedure</h3> |
<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 /> <br /> |
<!-- preamble end --> |
<!-- preamble end --> |
<!-- maintext start --> |
<!-- maintext start --> |
|
<a name="upgrade" /> |
|
<h3>Upgrading LON-CAPA files</h3> |
<p> |
<p> |
Scott Harrison |
Download the most current |
|
<a href="http://install.lon-capa.org/versions/current/loncapa.tar.gz"> |
|
loncapa.tar.gz</a>. |
</p> |
</p> |
<p> |
<p> |
Last updated: 4/18/2001 |
The <strong>UPDATE</strong> command will refresh your filesystem with all |
|
the latest LON-CAPA software. |
</p> |
</p> |
|
<table bgcolor="#aaaaaa" border="1"> |
|
<tr><td><tt>./UPDATE</tt></td></tr> |
|
</table> |
|
<a name="checkrpms" /> |
|
<h3>Checking your Linux RPMs</h3> |
<p> |
<p> |
LON-CAPA system releases currently are not released under version |
The <strong>CHECKRPMS</strong> command will check the RPMs on your machine |
numbers given the fast pace of system development. To upgrade your |
against an FTP repository. |
system, you need to |
</p> |
<ol> |
<table bgcolor="#aaaaaa" border="1"> |
<li>Make sure your software packages are up-to-date |
<tr><td><tt>./CHECKRPMS</tt></td></tr> |
(based on install.lon-capa.org).</li> |
</table> |
<ul> |
<a name="testing" /> |
<li>As root, run the script <tt>/usr/sbin/loncapaverifypackages</tt>. |
<h3>Testing to see if the LON-CAPA server is operational</h3> |
If packages are out-of-date, this script will output |
<p> |
the out-of-date packages. Packages that this script identifies as |
The <strong>TEST</strong> command will check the installation software, |
"should not be here", are packages that you may wish to remove to |
the perl libraries on your system, the MySQL database, and |
improve system security. (These packages may represent important |
will also automatically test the real-time operation of the |
modifications of your institution, so do with care. Removing |
LON-CAPA Apache web server. |
packages is done with the command: <tt>rpm -e --nodeps PACKAGE_NAME</tt>.</li> |
</p> |
</ul> |
<table bgcolor="#aaaaaa" border="1"> |
<li>Upgrade old software packages.</li> |
<tr><td><tt>./TEST</tt></td></tr> |
<ul> |
</table> |
<li>Upgrade software packages by either</li> |
<p> |
<ul> |
Using the <strong>TEST</strong> command will likely |
<li>Running <tt>/usr/sbin/loncapaupgradepackages</tt>.</li> |
be an iterative process. |
<li>Or, going to <a href="http://install.lon-capa.org/3.1/SupplementalRPMS/">http://install.lon-capa.org/3.1/SupplementalRPMS/</a>, |
It is normal to expect that the <strong>TEST</strong> command |
you can individually download each package from the world-wide web. You |
will recommend you perform various steps to ensure optimal |
then need to enter the command: |
performance of your LON-CAPA server. |
<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 <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> |
</p> |
<!-- maintext end --> |
<!-- maintext end --> |
</body> |
</body> |