Daisy install on Mandriva Linux :

System configuration = Mandriva 10.x server 2005LE - Apache 2.0xx avec Virtual Hosts - Java 1.5x - Tomcat 5.x - mod-jk 1.2x

Version française du document : http://www.apachefrance.com/Forums/index.php?showtopic=3606

Step 1 - Create Databases & Users - (syntax issue fixed here)

• CREATE DATABASE daisyrepository
• DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci
• GRANT ALL ON daisyrepository.* TO daisy@'localhost' IDENTIFIED BY 'daisy'
• CREATE DATABASE openjms
• DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci
• GRANT ALL ON openjms.* TO openjms@'localhost' IDENTIFIED BY 'openjms'

Step 2 - Download & tar

• console as root
• $: cd /usr/share/
• Download « daisy-<version>.tar.gz” from http://svn.cocoondev.org/dist/daisy/
• $: tar xvzf daisy-<version>.tar.gz
• >> Get : /usr/share/daisy-<version>
• >> Rename: /usr/share/daisy
• $: chown if necessary: « chown –R root :root daisy  (root or other user)

Step 3 - OpenJMS - configuration

1° environment parameters

“DAISY_HOME /usr/share/daisy”

“OPENJMS_HOME /usr/share/daisy/openjms”

So, as root :

$: export DAISY_HOME=/usr/share/daisy

$: export OPENJMS_HOME=/usr/share/daisy/openjms

Verify ..

$: echo $DAISY_HOME

$: echo $OPENJMS_HOME

2° configuration

$: cd /usr/share/daisy/install (go directory <DAISY_HOME>/install)

Launch configuration script (as root)

$: ./daisy-openjms-config

Information required :

• Choose database = 1
• Database driver class default = com.mysql.jdbc.Driver (accept)
• database driver location /usr/share/daisy/lib/mysql/jars/mysql-connector-java-xx .jar (accept)
• database url (enter) jdbc:mysql//localhost/openjms
• database user default (enter) openjms
• password (as you want)
• (updating files in) ../openjms/.&. /config/openjms.xml & /bin/setenv.sh cocoon.xconf

3° create tables inside openjms database

$: cd /usr/share/daisy/openjms/bin = go to directory <OPENJMS_HOME>/bin 

Launch configuration script (console as root)

$: ./dbtool.sh -create -config $OPENJMS_HOME/config/openjms.xml

Dlog4j.configuration=$DAISY_HOME/misc/openjms-log4j.properties

I Get an error : >=== "pooled connection" try to connect as daisy@mandrake - host name not choosed as localhost but as ‘mandrake’ whose name is Mandriva Linux hostname

Solution >===  as Webmin/servers/Mysql - Global Options / Host permissions - Add host 'mandrake'

We retry configuration  script:

$:./dbtool.sh -create -config $OPENJMS_HOME/config/openjms.xml

Dlog4j.configuration=$DAISY_HOME/misc/openjms-log4j.properties

Successfully created tables

4° start OpenJMS:

go directory <OPENJMS_HOME>/bin

Launch script

$: ./startup.sh

Session is working and dedicated

Step 4 - Daisy Repository Server

1°) Open a new shell session

$: export DAISY_HOME=/usr/share/daisy

2°) Install

go directory <DAISY_HOME>/install

$: ./daisy-repository-init

(information suggested or/and requested)

• > Database 1 mysql ((accept))
• > driver class default = com.mysql.jdbc.Driver ((accept))
• > database driver location /usr/share/daisy/lib/mysql/jars/mysql-connector-java-xx .jar ((accept))
• > database url (enter) jdbc:mysql//localhost/daisyrepository
• > database user/passw = daisy/daisy ((accept or choose))
• > Enter initial Daisy user default = testuser/testuser  ((accept or choose))
• > creation database
• > smtp = smtp.free.fr  ((accept or choose your ISP smtp))
• > from adress = toto@free.fr  ((accept or choose))
• > Daisy data directory location = /var/local/daisydata  ((accept or choose))
• > modify File cocoon.xconf (user/pass)

3° Start Daisy Repository Server

go directory <DAISY_HOME>/repository-server/bin & run daisy-repository-server

$: cd /usr/share/daisy/repository-server/bin

$: ./daisy-repository-server /var/local/daisydata

starting Merlin 3.3.0 ...

Step 5 - Initialising the Daisy Wiki

1°) Start a new shell session

$: export DAISY_HOME=/usr/share/daisy

2° Install Daisy Wiki

Go directory <DAISY_HOME>/install

$: ./daisy-wiki-init

Config Information requested :

• > daisy repository listening http://localhost:9263/ ((accept or choose))
• > testuser/testuser ((same as last step choice))
• > creation guest user & role, registrar user & update cocoon.xconf
• > Acl default role guest (read) & for others (read/write)

3° Create Daisy Wiki Site

The Daisy Wiki has the concept of multiple sites, these are multiple views on top of the same repository. You need at least one site to do something useful with the Daisy Wiki, so we are now going to create one. Open a command prompt or shell and set an environment variable DAISY_HOME, pointing to the directory where Daisy is installed.

Go directory <DAISY_HOME>/install

$: ./daisy-wiki-add-site

• > daisy repository server listening htttp://localhost:9263
• > testuser/testuser ((same as last step choice))
• > Nom pour le site : wikitest (name collection, directory name) ((accept or choose))
• > langage = default
• > sites directory location = /usr/share/daisy/daisywiki/webapp/daisy/sites ((((accept or choose))

Create Daisy Wiki new site = collection docs, navigation, home page, siteconf.xml

Step 6 - Tomcat/Apache in place of Jetty

Two Solutions:

1. copy/move /DAISY_HOME/daisywiki
2. Use <host> <context> Tomcat parameter in « server.xml » (redirect Host or sub-dir to DAISY_HOME/daisywiki

6-1° copy/move /DAISY_HOME/daisywiki

Deploying on Tomcat The Daisy webapp can be freely moved out of the DAISY_HOME/daisywiki directory and deployed on another servlet container. It has no external dependencies: it needs no other stuff from DAISY_HOME, nor does it need access to the daisy data directory. Here is how you can deploy Daisy on Tomcat (this was tried with Tomcat 5.0.28):

6-1-1°) copy

……from.:.Daisy's webapp directory - DAISY_HOME/daisywiki/webapp)

……to……:.TOMCAT_HOME/webapps/cocoon (thus the webapp directory gets renamed to cocoon)

6-1-2°) Check versions of xerces and xalan in  /endosed library path of Tomcat directory):

$: ls common/endorsed/

xercesImpl.jar xml-apis.jar

$: rm common/endorsed/*

$: cp webapps/cocoon/WEB-INF/lib/xercesImpl-<version>.jar common/endorsed/

$: cp webapps/cocoon/WEB-INF/lib/xml-apis.jar common/endorsed/

$: cp webapps/cocoon/WEB-INF/lib/xalan-<version>.jar common/endorsed/ 

Releases in Mandriva 2005LE working :

• xerces-j2-2.6.2-6jpp - /usr/share/java/xerces-j2.jar - 13/06/05
• xalan-j2-2.6.0-3jpp - /usr/share/java/xalan-j2.jar - 27/05/05

6-1-3°) Launch Tomcat ,

1. … if ‘autodeploy’, you’ll find application
2. … if not, deploy
3. … if ‘jk-mod.conf’ autogenerate, don’t forget to stop/start apache after generation of file

6-2° Solution – server.xml de Tomcat redirection to /DAISY_HOME/daisywiki

See this article Ici . http://www.apachefrance.com/Forums/index.php?showtopic=3584 - Translation comes later for this how-to

Step 7 – Process Start/Stop

1°) Start OpenJMS

$: export DAISY_HOME=/usr/share/daisy

$: export OPENJMS_HOME=$DAISY_HOME/openjms

$: cd $DAISY_HOME/openjms/bin

$: ./startup.sh

2) Start Daisy Repository Server

$: export DAISY_HOME=/usr/share/daisy

$: cd $DAISY_HOME/repository-server/bin

$: ./daisy-repository-server /var/local/daisydata

3°) start Tomcat OR Jetty

Daisy requires an expanded webapp, not a war archive.

4°) Web Browser access to application

• http://localhost:8080/cocoon/daisy/ if Tomcat
• http://localhost/cocoon/daisy/ if Apache/Tomcat
• Other Port if you had configured others ..

5) STOP

1° - Daisy Wiki

2° - Daisy Repository Server - kill process ...??

3° - OpenJMS.

$: cd <OPENJMS_HOME>/bin

$: ./shutdown -u admin -p <your-password>

Fields

Name	Value
Category	Install & config