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.

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 ActiveMQ 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 ActiveMQ, edit the following file:

<daisydata directory>/conf/activemq-conf.xml

Look for the <property name="url" value="..."/> element.

For the Daisy Repository Server, edit the following file:

<daisydata directory>/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 ActiveMQ on a different port

The port to which ActiveMQ listens (by default 61616) can be changed in the ActiveMQ configuration:

<daisydata directory>/conf/activemq-conf.xml

Since ActiveMQ is embedded in the repository server, the repository server itself does not communicate via a TCP connection and thus needs no configuration change.

For the Daisy Wiki: edit the following file:

<wikidata directory>/daisy.xconf

Search for the following element:

<property name="java.naming.provider.url" value="tcp://localhost:61616"/>

and adjust.

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:

<daisydata directory>/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:

<wikidata directory>/daisy.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:

<daisydata directory>/conf/myconfig.xml

Look for the following element and adjust:

<httpAdaptor port="9264"/>

Changing the Daisy Wiki (Jetty) port

Copy the default jetty configuration to the wiki data directory

cp DAISY_HOME/daisywiki/conf/jetty-daisywiki.xml WIKI_DATA/jetty_daisywiki.xml
or
copy DAISY_HOME/daisywiki/conf/jetty-daisywiki.xml WIKI_DATA/jetty_daisywiki.xml

Edit your newly copied file and look for the following line and adjust the '8888' value:

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

If you are using the tanuki wrapper scripts you must point jetty in the direction of your new settings. Comment the default settings and uncomment the custom settings

# Default Daisy Jetty configuration
# set.DAISY_JETTY_CONF=%DAISY_HOME%/daisywiki/conf/jetty-daisywiki.xml
# Override Jetty configuration (uncomment the line below to override default configuration)
set.DAISY_JETTY_CONF=%DAISYWIKI_DATADIR%/jetty-daisywiki.xml