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.2.6 -r1.4.2.7 --- openacs-4/packages/acs-core-docs/www/upgrade-4.6.3-to-5.adp 13 Jul 2023 12:43:23 -0000 1.4.2.6 +++ openacs-4/packages/acs-core-docs/www/upgrade-4.6.3-to-5.adp 2 Sep 2024 09:40:24 -0000 1.4.2.7 @@ -2,37 +2,37 @@ {/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 how to upgrade an Oracle installation from OpenACS 4.6.3 to +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” +“Version Compatibility Matrix”

    1. Back up the database and filesystem.

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

    3. 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
       

      Manually execute each of the upgrade scripts in sequence, either @@ -41,8 +41,7 @@ -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
      +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
      @@ -58,8 +57,7 @@
       psql -f upgrade-5.0.0b3-5.0.0b4.sql $OPENACS_SERVICE_NAME
       
    4. -

      Upgrade ACS Service Contracts manually:

      -[$OPENACS_SERVICE_NAME aolserver]$ cd /var/lib/aolserver/ $OPENACS_SERVICE_NAME/packages/acs-service-contracts/sql/postgresql/upgrade
      +

      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
       
    5. @@ -73,8 +71,7 @@ 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]} {
      +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"]
       }
      @@ -89,8 +86,7 @@
       acs-kernel 0 number \
       security 1 1
       parameter::set_value -package_id [ad_acs_kernel_id] -parameter UsePasswordWidgetForUsername -value 0
      -}
      -
      +}
    6. If you can login, visit /acs-admin/apm and upgrade acs-kernel and acs-service-contract and uncheck the data model scripts. Restart. If everything is still working, make another backup of the