2.11.3 Upgrading

These instructions are for upgrading from Daisy 1.3, 1.3.1 or 1.4-M1. To upgrade from earlier releases, first check the upgrade instructions for the earlier releases to run any required database updates or to perform the required configuration changes.

2.11.3.1 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

2.11.3.2 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.
• If you developed a custom skin, then you can copy it over too.
• 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.0.15-ga-bin.jar

2.11.3.3 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.

2.11.3.4 Add new types for books

This only applies if you did not upgrade to 1.4-M1 before.

For the books, some new part, field and document types are defined. If you want to make use of the books functionality, it is required to install these (better install them to avoid future suprises). This is done simply by running the daisy-wiki-init application from the <DAISY_HOME>/install directory. No restart of the servers is needed.

2.11.3.5 Note about static resources and caching

Since static resources are cached for about 5 hours by your browser, you might need to clear the browsers' cache.

In Firefox, this is done using Edit -> Preferences -> Privacy -> press the "Clear" button next to Cache

Internet Explorer users, see here.

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.