Index: openacs-4/packages/acs-core-docs/www/upgrade-supporting.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/upgrade-supporting.html,v diff -u -r1.4 -r1.5 --- openacs-4/packages/acs-core-docs/www/upgrade-supporting.html 18 Feb 2004 14:43:03 -0000 1.4 +++ openacs-4/packages/acs-core-docs/www/upgrade-supporting.html 24 Feb 2004 17:42:25 -0000 1.5 @@ -32,7 +32,16 @@ psql service0 -f /usr/local/src/postgresql-7.2.3/contrib/tsearch/tsearch.sql exit
  • 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 root]# restart-aolserver service0
    6. Browse to http://yourserver/openfts

    7. Click Administration.

    8. Click Initialize OpenFTS Engine

  • Upgrading from PostGreSQL 7.2 to 7.3

    An OpenACS database created in PostGreSQL 7.2 will not work correctly in PostGreSQL 7.3. This is because 7.2 truncates function names to 31 characters, but 7.3 does not. This does not cause problems in 7.2, because truncation occurs both at function creation and at function calling, so they still match. But if you use a database created in 7.2 in 7.3, the function names in the database remain truncated but the function calls are not, and so they don't match. Also some functions use casting commands that no longer work in 7.3 and these functions must be recreated.

    + 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 root]# restart-aolserver service0
    6. Browse to http://yourserver/openfts

    7. Click Administration.

    8. Click Initialize OpenFTS Engine

    Upgrading from PostGreSQL 7.2 to 7.3

    An OpenACS database created in PostGreSQL 7.2 will not + work correctly in PostGreSQL 7.3. This is because 7.2 truncates + function names to 31 characters, but 7.3 does not. This does + not cause problems in 7.2, because truncation occurs both at + function creation and at function calling, so they still match. + But if you use a database created in 7.2 in 7.3, the function + names in the database remain truncated but the function calls + are not, and so they don't match. Also some functions use + casting commands that no longer work in 7.3 and these functions + must be recreated.

    To upgrade an OpenACS site from PostGreSQL 7.2 to 7.3, first upgrade the kernel to 4.6.3. Then, dump the database, run the upgrade script /var/lib/aolserver/service0/bin/pg_7.2to7.3_upgrade_helper.pl on the dump file, and reply the dump. See Forum OpenACS Q&A: PG 7.2->7.3 upgrade gotcha?. Example:

    1. Back up the database as per PostgreSQL.

    2. Run the upgrade script on the backup file.

      [root root]# su - service0
                 [service0 service0]# cd /var/lib/aolserver/service0/bin
                 [service0 bin]$ ./pg_7.2to7.3_upgrade_helper.pl \
      @@ -48,6 +57,20 @@
                 (many lines omitted)
                 [service0 bin]$
                 
    3. Use perl to replace timestamp with timestamptz in the dump file.

      find . -type f -name "*sql" | xargs perl -p -i.tmp -e "s/timestamp with time zone/timestamptz/g"
      -          find . -type f -name "*sql" | xargs perl -p -i.tmp -e "s/\\wtimestamp[^t]/ timestamptz/g"
    4. Install PostgreSQL 7.3.x. Note that you PostgreSQL + find . -type f -name "*sql" | xargs perl -p -i.tmp -e "s/\\wtimestamp[^t]/ timestamptz/g"

    5. Create a new user for PostgreSQL 7.3.x, as per the + Postgres installation guide. Keep in mind that your + installation location is different, and your startup script + (/etc/init.d/postgres73 should be named differently. You + might even need to edit that file to make the paths correct) +

    6. Install PostgreSQL 7.3.x. Note that you PostgreSQL must listen on a different port in order to work - correctly.

    7. Restore the database from dump as per the recovery instructions.

    View comments on this page at openacs.org
    + correctly, so you'll need to edit the configuration file + (/usr/local/pgsql73/data/postgresql.conf) and + change the port (to 5433, say). create a second postgres + user to differentiate between the two postgres + installs. When you do ./configure, you'll need to include + --prefix=$HOME to ensure that it is installed in the + postgres73 user's home directory.

  • Change the path in + service0's .bashrc or + .bash_profile (or both) files to reflect the new postgres73 + user directory.

  • Restore the database from dump as per the recovery instructions.

  • View comments on this page at openacs.org