Index: openacs-4/packages/acs-core-docs/www/upgrade-overview.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/upgrade-overview.html,v diff -u -r1.28 -r1.29 --- openacs-4/packages/acs-core-docs/www/upgrade-overview.html 7 Aug 2017 23:47:53 -0000 1.28 +++ openacs-4/packages/acs-core-docs/www/upgrade-overview.html 8 Nov 2017 09:42:12 -0000 1.29 @@ -1,7 +1,36 @@ -Overview

Overview

Starting with Version 4.5, all OpenACS core packages support +Overview

Overview

+ +

Starting with Version 4.5, all OpenACS core packages support automatic upgrade. That means that, if you have OpenACS 4.5 or better, you should always be able to upgrade all of your core packages automatically. If you haven't changed anything, no manual intervention should be required. If you are running - OpenACS prior to 4.5, upgrading will require manual effort.

If all of these conditions are true:

  • Your OpenACS Core is 5.0.0 or later

  • You do not keep your OpenACS site in a local CVS repository

  • You do not have any custom code

then you can upgrade automatically using the automated installer in the OpenACS Package Manager (APM), and you can probably skip the rest of this chapter. To upgrade directly from the OpenACS repository using the APM:

  1. Browse to the Installer.

  2. Click install or upgrade under "Install from OpenACS Repository" and select the packages to install or upgrade.

  3. The APM will download the requested packages from OpenACS.org, install the files on your hard drive, run any appropriate database upgrade scripts, and prompt you to restart the server. After restarting the server again, the upgrade is complete.

Figure 5.1. Upgrading with the APM

Upgrading with the APM

It's always a good idea to precede an upgrade attempt with a snapshot backup.

Table 5.1. Assumptions in this section

name of OpenACS user$OPENACS_SERVICE_NAME
OpenACS server name$OPENACS_SERVICE_NAME
Root of OpenACS file tree/var/lib/aolserver/$OPENACS_SERVICE_NAME
Database backup directory/var/lib/aolserver/$OPENACS_SERVICE_NAME/database-backup

+ OpenACS prior to 4.5, upgrading will require manual effort.

+

If all of these conditions are true:

+
+

then you can upgrade automatically using the automated installer in the OpenACS Package Manager (APM), and you can probably skip the rest of this chapter. To upgrade directly from the OpenACS repository using the APM:

+
  1. +

    Browse to the Installer.

    +
  2. +

    Click install or upgrade under "Install from OpenACS Repository" and select the packages to install or upgrade.

    +
  3. +

    The APM will download the requested packages from OpenACS.org, install the files on your hard drive, run any appropriate database upgrade scripts, and prompt you to restart the server. After restarting the server again, the upgrade is complete.

    +
+

Figure 5.1. Upgrading with the APM

+ +
Upgrading with the APM
+

+ +

It's always a good idea to precede an upgrade attempt with a snapshot backup.

+

Table 5.1. Assumptions in this section

+ +
name of OpenACS user$OPENACS_SERVICE_NAME
OpenACS server name$OPENACS_SERVICE_NAME
Root of OpenACS file tree/var/lib/aolserver/$OPENACS_SERVICE_NAME
Database backup directory/var/lib/aolserver/$OPENACS_SERVICE_NAME/database-backup
+

+