version 1.5, 2000/10/27 02:25:43
|
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> |
|
Scott Harrison |
|
</P> |
|
<P> |
|
Last updated: 10/26/2000 |
|
</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 <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>Restart the LON-CAPA networking processes |
|
<UL> |
|
<LI><TT>/etc/rc.d/init.d/loncontrol restart</TT> |
|
</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 /> |
|
<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 --> |
|
<!-- 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> |