File:  [LON-CAPA] / doc / build / Attic / upgrade.html
Revision 1.6: download - view: text, annotated - select for diffs
Wed Apr 18 15:55:19 2001 UTC (23 years, 2 months ago) by harris41
Branches: MAIN
CVS tags: stable_2002_spring, stable_2001_fall, HEAD
xml-ifying this a little -Scott

    1: <html>
    2: <head>
    3: <title>LON-CAPA Upgrade</title>
    4: </head>
    5: <body>
    6: <h1>LON-CAPA Upgrade</h1>
    7: <h3>Current Upgrade Procedure</h3>
    8: <p>
    9: Scott Harrison
   10: </p>
   11: <p>
   12: Last updated: 4/18/2001
   13: </p>
   14: <p>
   15: LON-CAPA system releases currently are not released under version
   16: numbers given the fast pace of system development.  To upgrade your
   17: system, you need to 
   18: <ol>
   19: <li>Make sure your software packages are up-to-date
   20: (based on install.lon-capa.org).</li>
   21: <ul>
   22: <li>As root, run the script <tt>/usr/sbin/loncapaverifypackages</tt>.  
   23: If packages are out-of-date, this script will output
   24: the out-of-date packages.  Packages that this script identifies as
   25: "should not be here", are packages that you may wish to remove to
   26: improve system security.  (These packages may represent important
   27: modifications of your institution, so do with care.  Removing
   28: packages is done with the command: <tt>rpm -e --nodeps PACKAGE_NAME</tt>.</li>
   29: </ul>
   30: <li>Upgrade old software packages.</li>
   31: <ul>
   32: <li>Upgrade software packages by either</li>
   33: <ul>
   34: <li>Running <tt>/usr/sbin/loncapaupgradepackages</tt>.</li>
   35: <li>Or, going to <a href="http://install.lon-capa.org/3.1/SupplementalRPMS/">http://install.lon-capa.org/3.1/SupplementalRPMS/</a>,
   36: you can individually download each package from the world-wide web.  You 
   37: then need to enter the command:
   38: <tt>rpm -Uvh --force PACKAGE_RPM_FILE_NAME</tt> to upgrade your system
   39: for each package.</li>
   40: </ul>
   41: </ul>
   42: <li>Make the LON-CAPA base files up to date (based on
   43: install.lon-capa.org).</li>
   44: <ul>
   45: <li><B>[optional]</B> Run the script
   46: <tt>/usr/sbin/loncapaverifybasepackage</tt>.  Then view
   47: /home/httpd/html/dev/index.html for the verification report.
   48: If there are no real changes, then you do not need to make your files
   49: up-to-date.</li>
   50: <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">
   51: 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>
   52: </ul>
   53: <li>Restore configuration files.</li>
   54: <ul>
   55: <li>As you run /usr/sbin/loncapaupgradepackages or enter in
   56: <tt>rpm -Uvh --force</tt> commands, you may
   57: see messages appear on your screen such as:
   58: <br /><tt>warning: /etc/httpd/conf/access.conf saved as
   59: /etc/httpd/conf/access.conf.rpmsave</tt>
   60: <br />You can probably just type in commands like:
   61: <br /><tt>cp /etc/httpd/conf/access.conf.rpmsave
   62: /etc/httpd/conf/access.conf</tt>
   63: <br />to restore your configurations.  However, it is worthwhile to use the
   64: 'diff' command to make sure that you are not accidentally losing important
   65: updates to the configuration files.  
   66: <li>Alternatively, you can run <tt>/usr/sbin/loncaparestoreconfigurations</tt>
   67: to "smartly" run through the system and restore LON-CAPA configuration
   68: values.</li>
   69: </ul>
   70: <li>Restart the LON-CAPA networking processes
   71: <ul>
   72: <li><tt>/etc/rc.d/init.d/loncontrol restart</tt></li>
   73: </ul>
   74: <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
   75: do all of this automatically.  You can run this script by entering the command:
   76: <TT>/usr/sbin/loncapaautoupgrade</TT></li>
   77: </ol>
   78: </p>
   79: <h3>Future Upgrade Procedure (not yet implemented)</h3>
   80: <p>
   81: In the future, LON-CAPA will be a versioned system that is released via CD.
   82: The upgrade procedure will be to insert the CD and follow instructions.  The CD
   83: upgrade procedure is already defined and somewhat implemented, but awaits
   84: completion.
   85: </p>
   86: </body>
   87: </html>

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