[BACK]Return to upgrade.html CVS log [TXT] [DIR] Up to [LON-CAPA] / doc / build

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

1.6     ! 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</h3>
        !             8: <p>
1.5       harris41    9: Scott Harrison
1.6     ! harris41   10: </p>
        !            11: <p>
        !            12: Last updated: 4/18/2001
        !            13: </p>
        !            14: <p>
1.1       harris41   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 
1.6     ! harris41   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>.  
1.3       harris41   23: If packages are out-of-date, this script will output
1.6     ! harris41   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
1.1       harris41   57: see messages appear on your screen such as:
1.6     ! harris41   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
1.3       harris41   75: do all of this automatically.  You can run this script by entering the command:
1.6     ! harris41   76: <TT>/usr/sbin/loncapaautoupgrade</TT></li>
        !            77: </ol>
        !            78: </p>
        !            79: <h3>Future Upgrade Procedure (not yet implemented)</h3>
        !            80: <p>
1.1       harris41   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.
1.6     ! harris41   85: </p>
        !            86: </body>
        !            87: </html>
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>