1.4 TO 1.4.1 UPGRADE

Changes

The Daisy 1.4 release shipped with incorrect character-decoding of request parameters and POST-bodies submitted from a web browser to the Daisy Wiki. This release fixes this problem.

Next to that, the following small changes have been made:

  • When creating a new document in Firefox 1.5, the cursor in the rich text editor was not visible (though you can just start typing).
  • LDAP authentication: disallow empty or whitespace passwords. See DSY-242.
  • Fixed a problem in the Oracle SQL-generation templates, which contained everything double. See DSY-241. Note that these templates still not generate working Oracle-SQL.
  • Fixed a problem in the FopImageSrcTransformer: the image path started with two slashes (//). In a normal setup this did not cause any problems.

Compatibiity

No issues, this release only contains a few small patches.

Upgrading

The instructions below are for upgrading from Daisy 1.4. If you want to upgrade from earlier releases, see 1.3 to 1.4 upgrade. The instructions over there are also valid for the 1.4.1 release.

Before starting

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

Make backups! More specifically:

daisy-backup-tool -b -d $DAISYDATA_DIR -l $DAISY_BACKUP_DIR -o $DAISY_HOME/openjms -a additional-entries.xml

The '-a additional-entries.xml' is not required to make a backup, but if specified you can backup daisywiki specific files.  If you want to backup these files you must first create the addition-entries.xml file, an example can be found in the backup documentation.

When deploying the Daisy Wiki on Tomcat

Edit the file TOMCAT_HOME/conf/server.xml, search for the element <Connector port="8080" ...  (or equivalent) and add to it the attribute URIEncoding="UTF-8".

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. Same applies for other resources (e.g. skins).
  • If modified, copy <OLD_DAISY_HOME>/daisywiki/webapp/daisy/external-include-rules.xml to <NEW_DAISY_HOME>/daisywiki/webapp/daisy/external-include-rules.xml

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.1.7-bin.jar

Note that this is a different version of the MySQL jar file than in earlier Daisy versions!

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.

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.