INSTALL AND CONFIG NOTES

Changing location (port or machine) of the different processes

This section details the changes to be done to run the different servers needed for Daisy on different machines or let them listen to different ports.

The machine on which you want to run the Daisy Wiki only needs the DAISY_HOME/daisywiki subdirectory. The machine on which you want to run the repository server needs at least DAISY_HOME/lib and DAISY_HOME/repository-server, in addition to your daisy data directory. The install utility programs need DAISY_HOME/install and DAISY_HOME/lib. OpenJMS only needs DAISY_HOME/openjms.

After editing any of the configuration files, you need to restart the application to which the configuration file(s) belongs.

Running MySQL at a different location

Both OpenJMS and the Daisy Repository Server talk to MySQL, so the configuration of both needs to be adjusted. Both could use a different MySQL instance.

For OpenJMS: edit the following file:

DAISY_HOME/openjms/config/openjms.xml

Look for the <DatabaseConfiguration> element, and change its url attribute.

For the Daisy Repository Server: edit the following file:

<your datadir>/conf/myconfig.xml

Look for the override of the datasource configuration:

<target path="/daisy/datasource/datasource">

and adjust there the content of the <url> element.

Running OpenJMS at a different location

Both the Daisy Wiki and the Daisy Repository Server connect to OpenJMS, so if you run some of these on different machines, or change the RMI port number of OpenJMS (1099 by default), you need to adjust the following configurations.

For the Daisy Wiki: edit the following file:

DAISY_HOME/daisywiki/webapp/WEB-INF/cocoon.xconf

Search for the following element:

<property name="java.naming.provider.url" value="rmi://localhost:1099/"/>

and adjust.

For the Daisy Repository Server: exactly the same but then in the following file:

<your datadir>/conf/myconfig.xml

Running the Daisy Repository Server at a different location

If you want to change the default HTTP port (9263) of the Daisy Repository Server, edit the following file:

<your datadir>/conf/myconfig.xml

Look for the following element and adjust:

<port>9263</port>

The Daisy Wiki talks to Daisy Repository Server, so if you change the port or run the repository server on a different machine, edit the following file:

DAISY_HOME/daisywiki/webapp/WEB-INF/cocoon.xconf

Look for the following element and adjust:

<repository-server-base-url>http://localhost:9263</repository-server-base-url>

Changing the JMX console port

Edit the following file:

<your datadir>/conf/myconfig.xml

Look for the following element and adjust:

<httpAdaptor port="9264"/>

Changing the Daisy Wiki (Jetty) port

To change the port of the Daisy Wiki web frontend, edit the following file: 

DAISY_HOME/daisywiki/conf/jetty-daisywiki.xml

Look for the following line and adjust the '8888' value:

<Set name="Port"><SystemProperty name="jetty.port" default="8888"/></Set>

Deploying on Tomcat

Here is how you can deploy Daisy on Tomcat (this was tried with Tomcat 5.0.28):

First copy Daisy's webapp (directory DAISY_HOME/daisywiki/webapp) to TOMCAT_HOME/webapps/cocoon (thus the webapp directory gets renamed to cocoon).

Then make sure recent versions of xerces and xalan are in the endosed library path of Tomcat, you can do this like this:

$ ls common/endorsed/
xercesImpl.jar  xml-apis.jar
$ rm common/endorsed/*
$ cp webapps/cocoon/WEB-INF/lib/xercesImpl-2.6.2.jar common/endorsed/
$ cp webapps/cocoon/WEB-INF/lib/xml-apis.jar common/endorsed/
$ cp webapps/cocoon/WEB-INF/lib/xalan-2.6.0.jar common/endorsed/

Now start Tomcat, and surf to http://localhost:8080/cocoon/daisy/. That's all there is to it. Note that Daisy requires an expanded webapp, not a war archive.