| Prev | Chapter�5.�Upgrading | Next |
|---|
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 7.3; Table�2.2
- Upgrade the file system for packages/acs-kernel.�Section�, “Upgrading the OpenACS files” 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.)
- 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. Run the scripts in this order (order is tentative, not verified):
+ 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”
+ Upgrade the file system for packages/acs-kernel. the section called “Upgrading the OpenACS files” 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.)
+ Manually execute each of the upgrade scripts in sequence, either from within psql or from the command line with commands such as Upgrade ACS Service Contracts manually: Upgrade ACS Service Contracts manually: Load acs-authentication data model. Load acs-lang data model. (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: Load acs-authentication data model. Load acs-lang data model. (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 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 database.
- Upgrade other packages via the APM
- See also these forum posts: Forum OpenACS Development: 4.6.3 upgrade to 5-HEAD: final results, OpenACS 5.0 Upgrade Experiences.
+} 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 database.
+ Upgrade other packages via the APM
+ See also these forum posts: Forum OpenACS Development: 4.6.3 upgrade to 5-HEAD: final results, OpenACS 5.0 Upgrade Experiences.
There are a few things you might want to do once you've
upgraded. First, the acs-kernel parameters need to be set to
allow HREF and IMG tags, if you want users who can edit HTML
[root root]# su - $OPENACS_SERVICE_NAME
-[$OPENACS_SERVICE_NAME aolserver]$ cd /var/lib/aolserver/ $OPENACS_SERVICE_NAME/packages/acs-kernel/sql/postgresql/upgrade
[root root]#
su - $OPENACS_SERVICE_NAME
+[$OPENACS_SERVICE_NAME aolserver]$ cd /var/lib/aolserver/ $OPENACS_SERVICE_NAME/packages/acs-kernel/sql/postgresql/upgradepsql -f upgrade-4.6.3-4.6.4.sql $OPENACS_SERVICE_NAMEpsql -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
@@ -20,26 +20,26 @@
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
[$OPENACS_SERVICE_NAME aolserver]$ cd /var/lib/aolserver/ $OPENACS_SERVICE_NAME/packages/acs-service-contracts/sql/postgresql/upgrade
+psql -f upgrade-5.0.0b3-5.0.0b4.sql $OPENACS_SERVICE_NAME
[$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
-psql -f /var/lib/aolserver/$OPENACS_SERVICE_NAME/openacs-5/packages/acs-authentication/sql/postgresql/acs-authentication-create.sql $OPENACS_SERVICE_NAME
psql -f /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/acs-lang/sql/postgresql/acs-lang-create.sql $OPENACS_SERVICE_NAME
if {![apm_package_installed_p acs-lang]} {
+psql -f /var/lib/aolserver/$OPENACS_SERVICE_NAME/openacs-5/packages/acs-authentication/sql/postgresql/acs-authentication-create.sql $OPENACS_SERVICE_NAMEpsql -f /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/acs-lang/sql/postgresql/acs-lang-create.sql $OPENACS_SERVICE_NAMEif {![apm_package_installed_p acs-lang]} {
apm_package_install -enable -mount_path acs-lang [acs_root_dir]/packages/acs-lang/acs-lang.info
-lang::catalog::import -locales [list "en_US"]
+lang::catalog::import -locales [list "en_US"]
}
if {![apm_package_installed_p acs-authentication]} {
apm_package_install -enable [acs_root_dir]/packages/acs-authentication/acs-authentication.info
-apm_parameter_register "UsePasswordWidgetForUsername" \
-"Should we hide what the user types in the username
+apm_parameter_register "UsePasswordWidgetForUsername" \
+"Should we hide what the user types in the username
field, the way we do with the password field? Set
this to 1 if you are using sensitive information
-such as social security number for username." \
+such as social security number for username." \
acs-kernel 0 number \
security 1 1
parameter::set_value -package_id [ad_acs_kernel_id] -parameter UsePasswordWidgetForUsername -value 0
-}