Re: Current docs? Examples?

[Jukka Zitting <ju...@gmail.com>]

Hi,

On 3/1/06, Michael Wilson <mw...@imageworks.com> wrote:
> There once was a thread with step by step instructions on how to install
> Jackrabbit on Tomcat (including the RMI functionality).  I see reference
> that the final version was published somewhere in the wiki but in
> searching I can't find this document anywhere in there.

Which thread are you referring to?

> The version of the document I can find in the discussion groups appears
> to be for the 1.0-SNAPSHOT version.  Correct me if I'm wrong but the
> new .9 versions that were recently posted have been significantly
> refactored from the previous versions (I don't see a server/client.jar
> anywere which is referenced in the step-by-step instructions) so I'm
> afraid the previous thread's instructions are now out of date.

There are no major changes in 0.9 or in the upcoming 1.0 release. The
reason 0.9 may seem different is that it does not contain all the
contributed components. For example the WebDAV extensions that you
seem to be referring with the server and client jars is not included
in the 0.9 release.

> There is some configuration information on the Jackrabbit home site but
> it doesn't give examples of how to configure the repository.xml file for
> use with Tomcat.

You are right in that the Jackrabbit documentation is somewhat
lacking. We are slowly working at improving things, and of course all
help is eagerly accepted.

See the deployment howtos under
http://incubator.apache.org/jackrabbit/doc/deploy.html for a brief
introduction on setting up Jackrabbit in various Tomcat deployments.

Mark Slater recently wrote some great Jackrabbit/Tomcat instructions
which can be found at http://issues.apache.org/jira/browse/JCR-319.
Getting those instructions on the Jackrabbit web site is on my todo
list.

> Additionally there seems to be no information on how to configure the
> PersistenceManager to work with a relational database anywhere on the
> site. Some documented examples would be really helpful.

See the Persistence manager section in the Configuring Jackrabbit page:

    http://incubator.apache.org/jackrabbit/doc/config.html#Persistence_managers

This is probably the best configuration documentation we have at the
moment. Feel free to use the mailing list, wiki, or the issue tracker
to ask for more documentation and examples.

> I'm trying to install the latest .9 release from the downloads area and
> can't seem to get it to work with Tomcat 5.5.  Is there any better
> documentation available than on the Jackrabbit website somewhere?

See the documentation at http://issues.apache.org/jira/browse/JCR-319.
There's a version of Mark's instructions also at
http://whisper.cse.ucsc.edu/jackrabbit_deployment_test/.

I hope this helps you get started. :-)

BR,

Jukka Zitting

--
Yukatan - http://yukatan.fi/ - info@yukatan.fi
Software craftsmanship, JCR consulting, and Java development