How-to Install/Config on Mandriva Linux
Daisy installation on 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 :
> Erreur === "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 - Daisy Wiki
***********************************************
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)
2° 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):
1°) copy
……from.:.Daisy's webapp directory - DAISY_HOME/daisywiki/webapp)
……to……:.TOMCAT_HOME/webapps/cocoon (thus the webapp directory gets renamed to cocoon)
2°) Check recent versions of xerces and xalan are in the /endosed library path of Tomcat, you can do this like this (in the 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
3°) Launch Tomcat ,
… if ‘autodeploy’, you’ll find application
… if not, deploy
… 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:8080/cocoon/daisy/ if Apache/Tomcat
Other Port if you had configured others ..
5) STOP
-----------------------------------
1° - Daisy Wiki
2° - Daisy Repository Server - kill process ...??
Stop 3° - OpenJMS.
$: cd <OPENJMS_HOME>/bin
$: ./shutdown -u admin -p <your-password>
There are no comments.