2.10.5 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 then 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.10.5.1 Updating wrapper configuration for the Daisy Wiki

Similarly as in the previous section, the Daisy Wiki needs the following additional parameter in dsy_wiki_wrapper.conf (see also the full script):

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

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

[.....]