Rough Installation instructions
===============================

First install and start the Daisy server as described in ../../README.txt

Repository Initialisation [skip when building dist only]
-------------------------

*  Start merlin as described in ../../README.txt
   (hint: this in itself requires that openjms and mysql are running)

*  Go to the daisy/install subdir and execute:

daisy-wiki-init-dev --advanced
(linux: sh daisy-wiki-init-dev if not executable)

NOTE THE -dev ON THE END OF THE NAME OF THE SCRIPT!

First you will be asked for a user, enter "testuser", password "testuser".
Next you're asked for the address of the repository server, just press enter.

Later on you're asked for a password for the 'registrar' user. It will suggest
a random generated password, but for a development environment it is easiest
to enter here 'defaultpwd' (without the quotes) (otherwise you'll need to
ajdust the password in the cocoon.xconf file after each clean build).

The install program continues its work and finishes.

*  Still in daisy/install, execute:

daisy-wiki-add-site-dev

Use again testuser/testuser to login, and enter when asked for the address of
the repository server.

Then you're asked for the name of the site to create. Choose something,
for example "testsite".

When asked for the "sites directory location", the proposed default should be
ok, so just press enter.

Building the frontend
---------------------

*  Check out a snapshot of Cocoon 2.1.X SVN (or download Cocoon 2.1.7)

This can be done with the following command:
svn co http://svn.apache.org/repos/asf/cocoon/branches/BRANCH_2_1_X cocoon

Note: due to some restructering of the cocoon.xconf file in Cocoon 2.2,
Daisy currently does not work with the 2.2 branch of Cocoon.

*  Go to the directory daisy/applications/daisywiki/xmlschema-bindings and execute:

maven jar:install

*  Go to the directory daisy/applications/daisywiki/frontend

Edit/create the file build.properties and specify a property called
cocoon.dist.home pointing to your Cocoon source tree. When using windows,
you have to specify this path using double backslashes 
(e.g. c:\\applications\\mycocoon2.1) or otherwise the build will fail.

Then execute:

maven cocoon.get

This will build a Cocoon. Can take a few minutes.

Once this is done, execute:

maven

This will build Java code and deploy/build the webapp.

Running the frontend [skip when building dist only]
--------------------

To run it, execute:

maven cocoon.run

You can view the app by surfing to:

http://localhost:8888/daisy/

(hint: you do need the slash on the end!)
(hint: you still need to have merlin, and thus also openjms and mysql running)

To view your created site, go to:

http://localhost:8888/daisy/testsite/

By default, you're guest user, so you won't be able to edit or create
anything unless you change the login. You can login with testuser/testuser.

After doing this for the first time, you can start Cocoon by
directly executing the script target/cocoon/runc2.sh, which will
avoid the maven overhead.