Index: openacs-4/packages/acs-core-docs/www/upgrade-4.5-to-4.6.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/upgrade-4.5-to-4.6.html,v diff -u -r1.5 -r1.6 --- openacs-4/packages/acs-core-docs/www/upgrade-4.5-to-4.6.html 24 Jun 2003 03:58:11 -0000 1.5 +++ openacs-4/packages/acs-core-docs/www/upgrade-4.5-to-4.6.html 28 Jun 2003 05:07:03 -0000 1.6 @@ -1,13 +1,13 @@ -Upgrading OpenACS 4.5 to 4.6
Prev Chapter�7.�Upgrading Next

Upgrading OpenACS 4.5 to 4.6

Checklist

The required platform for OpenACS 4.6 is the same as +Upgrading OpenACS 4.5 to 4.6

Prev Chapter�8.�Upgrading Next

Upgrading OpenACS 4.5 to 4.6

Checklist

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 + 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�7.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 - + complete.

    Figure�8.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 - 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/
@@ -86,6 +86,6 @@
           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.

    3. On the next screen, click Install Packages

    4. When prompted, restart the server:

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

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

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

  3. OPTIONAL: Install the new OpenFTS Engine.�If you want to upgrade the OpenFTS Engine, do these + 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 4.7.0d.

  • 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
    Support for upgrades. Up Chapter�8.�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
    Support for upgrades. Up Chapter�9.�Maintenance
    docs@openacs.org
    View comments on this page at openacs.org