1.3-RC to 1.3 final upgrade

Changes

Bug fixes

• Fixed bug in recursive include processing (reported by clint, kipkerplunk-daisy <at> yahoo <dot> com)
• Fixed problem with variantLastModified query identifier.
• Re-enabled Postgresql choice in installation program, upon request.
• Fix a bug in the navigation tree when the first document child of a group node is not accessible by the current user (reported by Frank Taffelt)
• Fix the "input.replace is not a function" error that could occur in the navigation tree editor
• Upon request, added an equivalent for the old "/publisher/documentPage" request, which was replaced by the new publisher request model.

Upgrading

Before starting

Shutdown Daisy (the Repository Server, the Daisy Wiki, and the OpenJMS server)

Make backups! More specifically:

• make a copy of the daisy data directory
• do a dump of the database:
  mysqldump daisyrepository -uuser -ppassword > daisyrepo.sql

Copy over the old configuration

• Copy <OLD_DAISY_HOME>/openjms/config/openjms.xml to <NEW_DAISY_HOME>/openjms/config/openjms.xml
• Copy <OLD_DAISY_HOME>/daisywiki/webapp/daisy/sites/* to <NEW_DAISY_HOME>/daisywiki/webapp/daisy/sites
• In <NEW_DAISY_HOME>/daisywiki/webapp/WEB-INF/cocoon.xconf, adjust the following passwords with the values you can find in <OLD_DAISY_HOME>/daisywiki/webapp/WEB-INF/cocoon.xconf:
  • Adjust the password for openjms user (if not left to default): <credentials password="openjms" username="admin"/>
  • Adjust the password for "internal' user: <cacheUser login="internal" password="defaultpwd"/>
  • Adjust the password for the "registrar" user: <registrarUser login="registrar" password="defaultpwd"/>
• If you created any document type-specific stylesheets, you can copy them over also (see also the compatibilty notes!)
• If you developed a custom skin, then you'll have to update it to work with the new version (see also the compatibility notes).

Edit <DAISY_HOME>/openjms/bin/setenv.(sh|bat), uncomment the line defining the CLASSPATH and put the MySQL driver in the CLASSPATH, which can be found at (substitute DAISY_HOME by its actual location):

DAISY_HOME/lib/mysql/jars/mysql-connector-java-3.0.15-ga-bin.jar

Start the servers

Start OpenJMS, the Daisy Repository Server, and the Daisy Wiki.

If necessary, first update the DAISY_HOME and OPENJMS_HOME variables to point to the location of the new Daisy version.

Note about static resources and caching

Since static resources are cached for about 5 hours by your browser, you might need to do a full reload (shift + reload button on the browsers' toolbar). Also when opening the editor for the first time do a shift + reload.

If these instructions or unclear to you, or if you find an error in them, please share them with us on the Daisy mailing list or by leaving a comment.