Index: openacs-4/packages/acs-core-docs/www/upgrade-detail.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/Attic/upgrade-detail.html,v diff -u -r1.16.2.1 -r1.16.2.2 --- openacs-4/packages/acs-core-docs/www/upgrade-detail.html 14 Nov 2003 09:43:47 -0000 1.16.2.1 +++ openacs-4/packages/acs-core-docs/www/upgrade-detail.html 21 Nov 2003 11:14:11 -0000 1.16.2.2 @@ -1,21 +1,17 @@ -Support for upgrades.
Prev Chapter�5.�Upgrading Next

Support for upgrades.

- by Joel Aufrecht
+Upgrading

Alex logo
Prev Chapter�5.�Upgrading Next

Upgrading

by Joel Aufrecht

OpenACS docs are written by the named authors, and may be edited by OpenACS documentation staff. -

Starting with Version 4.5, all OpenACS core packages support +

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.

Checklist

The required platform for OpenACS 4.6 is the same as + OpenACS prior to 4.5, upgrading will require manual effort.

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

OpenACS consists of files and a database schema. The files + in a new tarball include database upgrade scripts. To start the + upgrade, replace your existing files with the new files and then browse to the APM, which will detect the new packages and offer to run the appropriate database upgrade scripts. After restarting the server again, the upgrade is + complete.

Figure�5.1.�Assumptions in this section

name of OpenACS usernsadmin
OpenACS server nameopenacs-dev
Root of OpenACS file tree/web/openacs-dev
Database backup directory/backup/openacs/

Upgrading 4.6.3 to 5.0

Current working notes in Forum OpenACS Development: 4.6.3 upgrade to 5-HEAD: final results.

Upgrading 4.5 to 4.6

The required platform for OpenACS 4.6 is the same as 4.5, with the excepion of OpenFTS. You now need OpenFTS 0.3.2, not 0.2. - OpenACS 4.6 does not support PostGreSQL 7.3.

Overview

OpenACS consists of files and a database schema. The files - in the OpenACS 4.6 tarball include database upgrade scripts. To start the - upgrade, replace your existing files with the new files and - then restart the server. Then, browse to the APM, which will - detect the new packages and offer to run the appropriate database upgrade - scripts. After restarting the server again, the upgrade is - complete.

Figure�5.1.�Assumptions in this section

name of OpenACS usernsadmin
OpenACS server nameopenacs-dev
Root of OpenACS file tree/web/openacs-dev
Database backup directory/backup/openacs/

Upgrading on Linux/Unix

  1. Make a Backup.�Back up the database and file system (see the section called “Snapshot backup and recovery”).

  2. OPTIONAL: Upgrade OpenFTS.�OpenACS Full Text Search requires several pieces: the OpenFTS code, some database functions, and the OpenFTS Engine. If you have OpenFTS 0.2, you'll need to upgrade to to OpenFTS 0.3.2. This is backwards-compatible - + OpenACS 4.6 does not support PostGreSQL 7.3.

    Upgrade Sequence

    1. Make a Backup.�Back up the database and file system (see the section called “Snapshot backup and recovery”).

    2. OPTIONAL: Upgrade OpenFTS.�OpenACS Full Text Search requires several pieces: the OpenFTS code, some database functions, and the OpenFTS Engine. If you have OpenFTS 0.2, you'll need to upgrade to to OpenFTS 0.3.2. This is backwards-compatible - completing this step will not break a working OpenFTS Engine from 4.5.

      1. Uninstall the old OpenFTS Engine

        1. Browse to http://yourserver/openfts.

        2. Click Administration.

        3. Click Drop OpenFTS Engine

      2. Build and install the new OpenFTS driver and supporting tcl procedures. (This section of shell code is not fully documented; please exercise care.)

        cd /usr/local/src/
@@ -49,7 +45,9 @@
 
        su - nsadmin
 psql openacs-dev -f /usr/local/pgsql/share/contrib/openfts.sql
 psql openacs-dev -f /usr/local/src/postgresql-7.2.3/contrib/tsearch/tsearch.sql
-exit

    3. Stop the server.�

      [root@localhost root]# svc -d /service/openacs-dev

    4. Upgrade the file tree.�If you are using CVS, you will unpack the OpenACS 4.6 tarball into a working directory and then import that directory into cvs. If you have changed files in the core packages, cvs will attempt to merge your changes. You may have to manually merge some conflicts. When that's finished, you can update your normal development checkout directory and the new files will appear. If you aren't using CVS, you can unpack the tarball on top of your existing tree, but any customizations you've made to the kernel or core packages will be erased.

      • Upgrading files without CVS.�Unpack the tarball into a new directory and copy its contents on top of your working directory.

        [root@localhost root]# su - nsadmin
+exit

  3. + Stop the server + 

    [root@localhost root]# svc -d /service/openacs-dev

  4. Upgrade the file tree.�If you are using CVS, you will unpack the OpenACS 4.6 tarball into a working directory and then import that directory into cvs. If you have changed files in the core packages, cvs will attempt to merge your changes. You may have to manually merge some conflicts. When that's finished, you can update your normal development checkout directory and the new files will appear. If you aren't using CVS, you can unpack the tarball on top of your existing tree, but any customizations you've made to the kernel or core packages will be erased.

    • Upgrading files without CVS.�Unpack the tarball into a new directory and copy its contents on top of your working directory.

      [root@localhost root]# su - nsadmin
 [nsadmin@localhost aolserver]$ cd /web
 [nsadmin@localhost web]$ tar xzf /tmp/openacs-4-6.tgz
 [nsadmin@localhost web]$ cp -r openacs-4-6/* openacs-4
@@ -59,7 +57,9 @@
 cd /web
 tar xzf /tmp/openacs-4-6.tgz
 cp -r openacs-4-6/* openacs-4
-exit

    • Upgrading files with CVS.�

      1. Unpack the new files into a working directory.

        [root@localhost root]# su - nsadmin
+exit

      2. + Upgrading files with CVS +

        1. Unpack the new files into a working directory.

          [root@localhost root]# su - nsadmin
 [nsadmin@localhost aolserver]$ cd /tmp
 [nsadmin@localhost tmp]$ tar xzv openacs-4-6.tgz
 [nsadmin@localhost tmp]$ cd openacs-4.6
@@ -89,11 +89,13 @@
 [root@localhost root]#
 
          cd /web/openacs-dev
 cvs up -Pd
-exit

  5. Start the server.�

    [root@localhost root]# svc -u /service/openacs-dev

  6. Use APM to upgrade the database.�

    1. Browse to the package manager, http://yourserver/acs-admin/apm.

    2. Click Install packages.

    3. Select the packages you want to install. This should +exit

  • + Start the server + 

    [root@localhost root]# svc -u /service/openacs-dev

  • Use APM to upgrade the database.�

    1. Browse to the package manager, http://yourserver/acs-admin/apm.

    2. Click Install packages.

    3. Select the packages you want to install. This should be everything that says upgrade, plus any new packages you want. It's safest to upgrade the kernel by itself, and then come back and upgrade the rest of the - desired packages in a second pass.

    4. On the next screen, click Install Packages

    5. When prompted, restart the server:

      [root@localhost root]# restart-aolserver openacs-dev

    6. Wait a minute, then browse to the package manager, http://yourserver/acs-admin/apm.

    7. Check that the kernel upgrade worked by clicking All and making sure that acs-kernel version is 5.0.0b1.

  • OPTIONAL: Install the new OpenFTS Engine.�If you want to upgrade the OpenFTS Engine, do these + desired packages in a second pass.

  • On the next screen, click Install Packages

  • When prompted, restart the server:

    [root@localhost root]# restart-aolserver openacs-dev

  • Wait a minute, then browse to the package manager, http://yourserver/acs-admin/apm.

  • Check that the kernel upgrade worked by clicking All and making sure that acs-kernel version is 5.0.0b2.

  • OPTIONAL: Install the new OpenFTS Engine.�If you want to upgrade the OpenFTS Engine, do these steps. (You must have already upgraded the OpenFTS driver to - 0.3.2.)

    1. Browse to http://yourserver/admin/site-map

    2. On the openfts line, click on set parameters.

    3. Change the value of openfts_tcl_src_path from /usr/local/src/Search-OpenFTS-tcl-0.2/ to /usr/local/src/Search-OpenFTS-tcl-0.3.2/

    4. Click Set Parameters

    5. [root@localhost root]# restart-aolserver openacs-dev

    6. Browse to http://yourserver/openfts

    7. Click Administration.

    8. Click Initialize OpenFTS Engine

  • Rollback.�If anything goes wrong, roll back to the backup snapshot.

    • ($Id$)
    Prev Home Next
    Chapter�5.�Upgrading Up Chapter�6.�Maintenance
    docs@openacs.org
    View comments on this page at openacs.org
    + 0.3.2.)

    1. Browse to http://yourserver/admin/site-map

    2. On the openfts line, click on set parameters.

    3. Change the value of openfts_tcl_src_path from /usr/local/src/Search-OpenFTS-tcl-0.2/ to /usr/local/src/Search-OpenFTS-tcl-0.3.2/

    4. Click Set Parameters

    5. [root@localhost root]# restart-aolserver openacs-dev

    6. Browse to http://yourserver/openfts

    7. Click Administration.

    8. Click Initialize OpenFTS Engine

  • Rollback.�If anything goes wrong, roll back to the backup snapshot.

    • ($Id$)
    Prev Home Next
    Chapter�5.�Upgrading Up Chapter�6.�Maintenance
    docs@openacs.org
    View comments on this page at openacs.org