2.12.6 Create wikidata directory

From now on, configurations parameters, skins, doctype XSLs, the book publication types and book store, the wiki log files, in short all 'wiki-instance-specific' stuff is stored in a separate "wikidata directory" (not to be confused with the daisydata directory, which performs a similar role but for the repository server).

We will now create such a directory and copy your existing configuration to it.

To create the wikidata directory, go to <DAISY_HOME>/install and execute:

daisy-wikidata-init

The program will ask you for a location for this directory. Just choose some location for this, for example put it next to (but not inside) the repository daisydata directory.

The program will also ask for the location of the repository daisydata directory, as it will take some configuration values from there (internal & jms user password) and put them in the wiki config.

It will also try to create the registrar user, but since you're doing an upgrade that user will already exist so it will simply skip that. However, you will need to enter the password for the registrar user. This can be found in <OLD_DAISY_HOME>/daisywiki/webapp/WEB-INF/cocoon.xconf, and look there for something like:

<registrarUser login="registrar" password="b6f84c35249a08d11ad6fa8279e2f9"/>

Just copy-and-paste that password to the input prompt.

Once the daisy-wikidata-init script has ended, we can copy over the remaining things:

• If modified, copy <OLD_DAISY_HOME>/daisywiki/webapp/daisy/external-include-rules.xml to <wikidata dir>/external-include-rules.xml
• Copy <OLD_DAISY_HOME>/daisywiki/webapp/daisy/sites/* (without the cocoon subdir) to <wikidata dir>/sites
• If you created your own skins, copy <OLD_DAISY_HOME>/daisywiki/webapp/daisy/resources/skins/(yourskin) to <wikidata dir>/resources/skins
• If you created your own doctype XSLs, then these also have to be copied into the wikidata directory, but at a new location, namely inside the directory of the skin. For example:
  <OLD_DAISY_HOME>/daisywiki/webapp/daisy/resources/document-styling/default/html/MyDoctype.xsl to <wikidata dir>/resources/skins/default/document-styling/html/MyDoctype.xsl
• Ditto for query-styling XSLs: copy all contents from <OLD_DAISY_HOME>/daisywiki/webapp/daisy/resources/ to <wikidata dir>/resources/skins/<skin-name>/query-styling/
• If you published any books, copy the from <OLD_DAISY_HOME>/daisywiki/webapp/daisy/bookstore to <wikidata dir>/bookstore
• If you made any custom book publication types, you can copy these from <OLD_DAISY_HOME>/daisywiki/webapp/daisy/books/publicationtypes to <wikidata dir>/books/publicationtypes

If you made any configuration changes to the repository manager, JMS client or registrar component which were previously in the cocoon.xconf, then you can now find these in <wikidata dir>/daisy.xconf.

2.12.6.1 Updating wrapper configuration for the Daisy Wiki

If you are using the service wrapper script to launch the Daisy Wiki, you need to adjust the dsy_wiki_wrapper.conf to include the following parameter (see also the full script):

wrapper.java.additional.7=-Ddaisywiki.data=%DAISYWIKI_DATADIR%

Daisy now ships with Jetty 5, which means that the classpath definition in the dsy_wiki_wrapper.conf needs to be updated. Just replace the existing wrapper.java.classpath entries with the new ones found in the updated dsy_wiki_wrapper.conf file.

The DAISYWIKI_DATADIR environment variable has to be declared in the shell script (dsy_wiki.sh or equivalent):

#! /bin/sh

DAISY_HOME=/home/daisy/daisy ; export DAISY_HOME
JETTY_HOME=$DAISY_HOME/daisywiki/jetty ; export JETTY_HOME
DAISYWIKI_DATADIR=/path/to/your/daisywikidata ; export DAISYWIKI_DATADIR

[.....]