Current docs? Examples?

[Michael Wilson <mw...@imageworks.com>]

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.  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 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.  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.

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?  The
wiki seems very light on details also.  Or better yet, does anyone out
there have a  .war with a hellojcp.jsp page?  I'm sorry but the
documention seems to be scattered about and possibly out of date.

Thanks for any reference you can point me at.

Mike 

-----Original Message-----
From: Stefan Guggisberg (JIRA) [mailto:jira@apache.org] 
Sent: Wednesday, March 01, 2006 8:43 AM
To: jackrabbit-dev@incubator.apache.org
Subject: [jira] Closed: (JCR-329) NodeReferencesId.equals() is not
symetric

     [ http://issues.apache.org/jira/browse/JCR-329?page=all ]
     
Stefan Guggisberg closed JCR-329:
---------------------------------

    Resolution: Fixed

incorporated all suggested changes (svn r382075)

> NodeReferencesId.equals() is not symetric
> -----------------------------------------
>
>          Key: JCR-329
>          URL: http://issues.apache.org/jira/browse/JCR-329
>      Project: Jackrabbit
>         Type: Improvement
>     Versions: 0.9
>     Reporter: Marcel Reutegger
>     Assignee: Stefan Guggisberg
>     Priority: Minor
>      Fix For: 1.0
>  Attachments: NodeReferencesId.patch
>
> NodeReferencesId.equals() is not symetric when equality is tested
against a NodeId.
> Code example:
> UUID uuid = UUID.randomUUID();
> NodeId id = new NodeId(uuid);
> NodeReferencesId refId = new NodeReferencesId(uuid); id.equals(refId);

> // will return true refId.equals(id); // will return false 
> NodeReferencesId should be decouled from the ItemId hierarchy. The
class NodeReferences already does not extend from NodeState which makes
perfectly sense. So, the same should apply to the identifier of
NodeReferences.
> The attached patch to NodeReferencesId also requires minor changes to
some of the persistence managers.

--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira

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