Index: openacs-4/packages/acs-core-docs/www/upgrade-4.6.3-to-5.adp =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/upgrade-4.6.3-to-5.adp,v diff -u -r1.4 -r1.5 --- openacs-4/packages/acs-core-docs/www/upgrade-4.6.3-to-5.adp 25 Apr 2018 08:38:28 -0000 1.4 +++ openacs-4/packages/acs-core-docs/www/upgrade-4.6.3-to-5.adp 3 Sep 2024 15:37:32 -0000 1.5 @@ -1,7 +1,11 @@ -{/doc/acs-core-docs {ACS Core Documentation}} {Upgrading OpenACS 4.6.3 to 5.0} +{/doc/acs-core-docs/ {ACS Core Documentation}} {Upgrading OpenACS 4.6.3 to 5.0} Upgrading OpenACS 4.6.3 to 5.0 +

Upgrading OpenACS 4.6.3 to 5.0

  • -Oracle.  This forum posting documents +Oracle. This forum posting documents how to upgrade an Oracle installation from OpenACS 4.6.3 to 5 .

  • -PostGreSQL.  You must use PostGreSQL 7.3.x -or newer to upgrade OpenACS beyond 4.6.3. See Upgrade PostGreSQL to +PostgreSQL. You must use PostgreSQL 7.3.x +or newer to upgrade OpenACS beyond 4.6.3. See Upgrade PostgreSQL to 7.3; Table 2.2, “Version Compatibility Matrix”

      -

    1. Back up the database and file -system.

    2. -Upgrade the file system for +

    3. Back up the database and +filesystem.

    4. +Upgrade the filesystem for packages/acs-kernel. the section called “Upgrading the OpenACS files”

    5. Upgrade the kernel manually. (There is a script to do most of the rest: /contrib/misc/upgrade_4.6_to_5.0.sh on HEAD). You'll still have to do a lot of stuff manually, but automated -trial and error is much more fun.)

      [root root]# su - $OPENACS_SERVICE_NAME
+trial and error is much more fun.)
      [root root]# su - $OPENACS_SERVICE_NAME
 
-[$OPENACS_SERVICE_NAME aolserver]$ cd /var/lib/aolserver/ $OPENACS_SERVICE_NAME/packages/acs-kernel/sql/postgresql/upgrade
+[$OPENACS_SERVICE_NAME aolserver]$ cd /var/lib/aolserver/ $OPENACS_SERVICE_NAME/packages/acs-kernel/sql/postgresql/upgrade
 
      Manually execute each of the upgrade scripts in sequence, either
 from within psql or from the command line with commands such as
 psql
--f upgrade-4.6.3-4.6.4.sql $OPENACS_SERVICE_NAME
+-f upgrade-4.6.3-4.6.4.sql $OPENACS_SERVICE_NAME
 .
 Run the scripts in this order (order is tentative, not
-verified):
      -psql -f upgrade-4.6.3-4.6.4.sql $OPENACS_SERVICE_NAME
-psql -f upgrade-4.6.4-4.6.5.sql $OPENACS_SERVICE_NAME
-psql -f upgrade-4.6.5-4.6.6.sql $OPENACS_SERVICE_NAME
-psql -f upgrade-4.7d-4.7.2d.sql $OPENACS_SERVICE_NAME
-psql -f upgrade-4.7.2d-5.0d.sql $OPENACS_SERVICE_NAME
-psql -f upgrade-5.0d-5.0d2.sql $OPENACS_SERVICE_NAME
-psql -f upgrade-5.0d2-5.0d3.sql $OPENACS_SERVICE_NAME
-psql -f upgrade-5.0d6-5.0d7.sql $OPENACS_SERVICE_NAME
-psql -f upgrade-5.0d7-5.0d9.sql $OPENACS_SERVICE_NAME
-psql -f upgrade-5.0d11-5.0d12.sql $OPENACS_SERVICE_NAME
-psql -f upgrade-5.0.0a4-5.0.0a5.sql $OPENACS_SERVICE_NAME
-psql -f upgrade-5.0.0b1-5.0.0b2.sql $OPENACS_SERVICE_NAME
-psql -f upgrade-5.0.0b2-5.0.0b3.sql $OPENACS_SERVICE_NAME
-psql -f upgrade-5.0.0b3-5.0.0b4.sql $OPENACS_SERVICE_NAME
+verified):
      psql -f upgrade-4.6.3-4.6.4.sql $OPENACS_SERVICE_NAME
+psql -f upgrade-4.6.4-4.6.5.sql $OPENACS_SERVICE_NAME
+psql -f upgrade-4.6.5-4.6.6.sql $OPENACS_SERVICE_NAME
+psql -f upgrade-4.7d-4.7.2d.sql $OPENACS_SERVICE_NAME
+psql -f upgrade-4.7.2d-5.0d.sql $OPENACS_SERVICE_NAME
+psql -f upgrade-5.0d-5.0d2.sql $OPENACS_SERVICE_NAME
+psql -f upgrade-5.0d2-5.0d3.sql $OPENACS_SERVICE_NAME
+psql -f upgrade-5.0d6-5.0d7.sql $OPENACS_SERVICE_NAME
+psql -f upgrade-5.0d7-5.0d9.sql $OPENACS_SERVICE_NAME
+psql -f upgrade-5.0d11-5.0d12.sql $OPENACS_SERVICE_NAME
+psql -f upgrade-5.0.0a4-5.0.0a5.sql $OPENACS_SERVICE_NAME
+psql -f upgrade-5.0.0b1-5.0.0b2.sql $OPENACS_SERVICE_NAME
+psql -f upgrade-5.0.0b2-5.0.0b3.sql $OPENACS_SERVICE_NAME
+psql -f upgrade-5.0.0b3-5.0.0b4.sql $OPENACS_SERVICE_NAME
    6. -

      Upgrade ACS Service Contracts manually:

      -[$OPENACS_SERVICE_NAME aolserver]$ cd /var/lib/aolserver/ $OPENACS_SERVICE_NAME/packages/acs-service-contracts/sql/postgresql/upgrade
-psql -f upgrade-4.7d2-4.7d3.sql $OPENACS_SERVICE_NAME
+
      Upgrade ACS Service Contracts manually:
      [$OPENACS_SERVICE_NAME aolserver]$ cd /var/lib/aolserver/ $OPENACS_SERVICE_NAME/packages/acs-service-contracts/sql/postgresql/upgrade
+psql -f upgrade-4.7d2-4.7d3.sql $OPENACS_SERVICE_NAME
    7. -

      Load acs-authentication data model.

      psql -f /var/lib/aolserver/$OPENACS_SERVICE_NAME/openacs-5/packages/acs-authentication/sql/postgresql/acs-authentication-create.sql $OPENACS_SERVICE_NAME
+
      Load acs-authentication data model.
      psql -f /var/lib/aolserver/$OPENACS_SERVICE_NAME/openacs-5/packages/acs-authentication/sql/postgresql/acs-authentication-create.sql $OPENACS_SERVICE_NAME
    8. -

      Load acs-lang data model.

      psql -f /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/acs-lang/sql/postgresql/acs-lang-create.sql $OPENACS_SERVICE_NAME
+
      Load acs-lang data model.
      psql -f /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/acs-lang/sql/postgresql/acs-lang-create.sql $OPENACS_SERVICE_NAME

    9. (This step may overlap with the two previous steps, but I think it's harmless?) Create a file which will be executed on startup which takes care of a few issues with authentication and -internationalization: create $OPENACS_SERVICE_NAME/tcl/zzz-postload.tcl -containing:

      -if {![apm_package_installed_p acs-lang]} {
+internationalization: create $OPENACS_SERVICE_NAME/tcl/zzz-postload.tcl
+containing:
      if {![apm_package_installed_p acs-lang]} {
 apm_package_install -enable -mount_path acs-lang $::acs::rootdir/packages/acs-lang/acs-lang.info
 lang::catalog::import -locales [list "en_US"]
 }