Annotation of doc/build/upgrade.html, revision 1.1

1.1     ! harris41    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 (Almost)</H3>
        !             8: <P>
        !             9: LON-CAPA system releases currently are not released under version
        !            10: numbers given the fast pace of system development.  To upgrade your
        !            11: system, you need to 
        !            12: <OL>
        !            13: <LI>Make sure your software packages are up-to-date (based on www.lon-capa.org).
        !            14: <UL>
        !            15: <LI>As root, run the script <A HREF="http://www.lon-capa.org/install/verify/scripts/loncapaverifypackages">
        !            16: loncapaverifypackages</A>.  This script should be present on your system in the file
        !            17: /usr/sbin/loncapaverifypackages.  If packages are out-of-date, this script will output
        !            18: the out-of-date packages.  Packages that this script identifies as "should not be here",
        !            19: are packages that you may wish to remove to improve system security.  (These packages
        !            20: may represent important modifications of your institution, so do with care.  Removing
        !            21: packages is done with the command: <TT>rpm -e --nodeps PACKAGE_NAME</TT>.
        !            22: </UL>
        !            23: <LI>Upgrade old software packages.
        !            24: <UL>
        !            25: <LI>Upgrade software packages by either
        !            26: <UL>
        !            27: <LI>Running /usr/sbin/<A HREF="http://www.lon-capa.org/install/verify/scripts/loncapaupgradepackages">loncapaupgradepackages</A>.
        !            28: <LI>Or, going to <A HREF="http://www.lon-capa.org/install/RPMS/">http://www.lon-capa.org/install/RPMS/</A>,
        !            29: you can individual download each package from the world-wide web.  You then need to enter the command:
        !            30: <TT>rpm -Uvh --force PACKAGE_RPM_FILE_NAME</TT> to upgrade your system.
        !            31: </UL>
        !            32: </UL>
        !            33: <LI>Restore configuration files.
        !            34: <UL>
        !            35: <LI>As you run /usr/sbin/loncapaupgradepackages or enter in <TT>rpm -Uvh --force</TT> commands, you may
        !            36: see messages appear on your screen such as:
        !            37: <BR><TT>warning: /etc/httpd/conf/access.conf saved as /etc/httpd/conf/access.conf.rpmsave</TT>
        !            38: <BR>You can probably just type in commands like:
        !            39: <BR><TT>cp /etc/httpd/conf/access.conf.rpmsave /etc/httpd/conf/access.conf</TT>
        !            40: <BR>to restore your configurations.  However, it is worthwhile to use the 'diff' command
        !            41: to make sure that you are not accidentally losing important updates to the configuration
        !            42: files.  
        !            43: <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.
        !            44: </UL>
        !            45: <LI>Should you wish to automate all of this, you can (at your own risk) enable a script which will
        !            46: do all of this automatically.  <B>This definitely should NOT be implemented on a system that students
        !            47: are using)</B>.  You can enable this script by entering the command:
        !            48: <TT>cp /usr/sbin/<A HREF="http://www.lon-capa.org/install/verify/scripts/loncapaautoupgrade">loncapaautoupgrade</A> /etc/cron.daily/loncapaautoupgrade</TT>
        !            49: </OL>
        !            50: </P>
        !            51: <H3>Future Upgrade Procedure (not yet implemented)</H3>
        !            52: <P>
        !            53: In the future, LON-CAPA will be a versioned system that is released via CD.
        !            54: The upgrade procedure will be to insert the CD and follow instructions.  The CD
        !            55: upgrade procedure is already defined and somewhat implemented, but awaits
        !            56: completion.
        !            57: </P>
        !            58: </BODY>
        !            59: </HTML>

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