You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jackrabbit.apache.org by ju...@apache.org on 2012/12/31 13:40:13 UTC
svn commit: r1427110 [16/18] - in /jackrabbit/site/trunk/content/JCR: ./
a-simple-ocm-project-with-maven-eclipse.data/ concurrency-control.data/
deployment-models.data/ how-jackrabbit-works.data/
how-to-map-associations-between-objects.data/ index-read...
Added: jackrabbit/site/trunk/content/JCR/repository-server-howto.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/trunk/content/JCR/repository-server-howto.html?rev=1427110&view=auto
==============================================================================
--- jackrabbit/site/trunk/content/JCR/repository-server-howto.html (added)
+++ jackrabbit/site/trunk/content/JCR/repository-server-howto.html Mon Dec 31 12:40:09 2012
@@ -0,0 +1,165 @@
+
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML>
+ <HEAD>
+ <TITLE>Repository Server HOWTO</TITLE>
+ <LINK type="text/css" rel="stylesheet" href="http://jackrabbit.apache.org/style/site.css">
+ <META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD>
+ <BODY>
+ <DIV id="page">
+ <DIV id="header">
+ <P id="jcr"><A href="http://jackrabbit.apache.org/"><IMG src="http://jackrabbit.apache.org/style/jlogo.gif" alt="Apache Jackrabbit" height="100" width="336"></A></P>
+ <P id="asf"><A href="http://www.apache.org/"><IMG src="http://jackrabbit.apache.org/style/asf-logo.gif" alt="Apache Software Foundation" height="100" width="387"></A></P>
+ </DIV>
+ <DIV id="body">
+ <DIV id="navigation">
+ <UL>
+ <LI>Apache Jackrabbit
+ <UL>
+ <LI><A href="welcome-to-apache-jackrabbit.html" title="Welcome to Apache Jackrabbit">Welcome</A></LI>
+ <LI><A href="downloads.html" title="Downloads">Downloads</A></LI>
+ <LI><A href="frequently-asked-questions.html" title="Frequently Asked Questions">FAQ</A></LI>
+ <LI><A href="http://wiki.apache.org/jackrabbit/FrontPage" class="external-link">Jackrabbit Wiki</A></LI>
+ <LI><A href="jackrabbit-history.html" title="Jackrabbit History">Jackrabbit History</A></LI>
+ </UL>
+ </LI>
+ <LI>Documentation
+ <UL>
+ <LI><A href="getting-started-with-apache-jackrabbit.html" title="Getting Started with Apache Jackrabbit">Getting Started</A></LI>
+ <LI><A href="standalone-server.html" title="Standalone Server">Standalone Server</A></LI>
+ <LI><A href="jackrabbit-components.html" title="Jackrabbit Components">Jackrabbit Components</A></LI>
+ <LI><A href="first-hops.html" title="First Hops">First Hops</A></LI>
+ <LI><A href="jcr-api.html" title="JCR & API">JCR & API</A></LI>
+ <LI><A href="jackrabbit-architecture.html" title="Jackrabbit Architecture">Jackrabbit Architecture</A></LI>
+ <LI><A href="deployment-models.html" title="Deployment Models">Deployment Models</A></LI>
+ <LI><A href="jackrabbit-configuration.html" title="Jackrabbit Configuration">Jackrabbit Configuration</A></LI>
+ <LI><A href="node-types.html" title="Node Types">Node Types</A></LI>
+ <LI><A href="object-content-mapping.html" title="Object Content Mapping">Object Content Mapping</A></LI>
+ </UL>
+ </LI>
+ <LI>Development
+ <UL>
+ <LI><A href="jackrabbit-team.html" title="Jackrabbit Team">Jackrabbit Team</A></LI>
+ <LI><A href="jackrabbit-roadmap.html" title="Jackrabbit Roadmap">Jackrabbit Roadmap</A></LI>
+ <LI><A href="building-jackrabbit.html" title="Building Jackrabbit">Building Jackrabbit</A></LI>
+ <LI><A href="mailing-lists.html" title="Mailing Lists">Mailing Lists</A></LI>
+ <LI><A href="issue-tracker.html" title="Issue Tracker">Issue Tracker</A></LI>
+ <LI><A href="source-repository.html" title="Source Repository">Source Repository</A></LI>
+ <LI><A href="continuous-integration.html" title="Continuous Integration">Continuous Integration</A></LI>
+ <LI><A href="website.html" title="Website">Website</A></LI>
+ <LI><A href="creating-releases.html" title="Creating Releases">Creating Releases</A></LI>
+ <LI><A href="supporting-software-attribution.html" title="Supporting software attribution">Attribution</A></LI>
+ </UL>
+ </LI>
+ <LI>Apache Software Foundation
+ <UL>
+ <LI><A href="http://www.apache.org/foundation/how-it-works.html" class="external-link">Introduction</A></LI>
+ <LI><A href="http://www.apache.org/foundation/sponsorship.html" class="external-link">Sponsorship</A></LI>
+ <LI><A href="http://www.apache.org/foundation/thanks.html" class="external-link">Current Sponsors</A></LI>
+ </UL>
+ </LI>
+</UL>
+ </DIV>
+ <DIV id="content">
+ <H1>Repository Server HOWTO</H1>
+ <P>This document describes how to use a Jackrabbit content repository in the deployment model 3: The Repository Server. In this deployment model, a separate repository server is running outside the virtual machine the client application is running in. A repository server can serve multiple applications running on separate JVMs on separate network hosts. See the <A href="jcr-client-application-howto.html" title="JCR client application HOWTO">JCR client application HOWTO</A> for instructions on how to use the configured content repository server.</P>
+
+<P>Note that JCR specification defines no standard communication protocol for inter-JVM repository access, and that Jackrabbit supports no such protocol by default. However, Jackrabbit contains tools for using JCR content repositories over the RMI and WebDAV protocols (see the jcr-rmi and the jcr-server, webapp packages).</P>
+
+<P>This how-to contains instructions for accessing a JCR-RMI server in Tomcat versions 4.x and 5.x. It should be easy to modify the instructions for other container environments and communication protocols.</P>
+
+<P>In addition to the following the instructions in this document, you also need to have an already running JCR-RMI server. See the JCR-RMI javadocs for instructions on how to setup such a server.</P>
+
+<P>Warning: The current JCR-RMI library is designed for simplicity, not performance. You will probably experience major performance issues if you try running any non-trivial applications on top of JCR-RMI.</P>
+
+<H2><A name="RepositoryServerHOWTO-Tomcatinstructions"></A>Tomcat instructions</H2>
+
+<P>Follow the steps below to setup a model 3 JCR-RMI client deployment for your web application in Tomcat 4.x or 5.x. Example code for both versions of Tomcat is included after this overview.</P>
+
+<P>Note that these instructions closely follow the Model 1 HOWTO instructions. By making similar changes (change the factory class and parameters of the repository) to the Model 2 HOWTO instructions, you can setup a shared JCR-RMI client deployment for all applications in the container.</P>
+
+<OL>
+ <LI>Place the JCR-RMI jar file and its dependencies (including the JCR API jar) under <EM>Tomcat folder</EM>/webapps/<EM>your app</EM>/WEB-INF/lib.</LI>
+ <LI>Register the JCR-RMI client repository factory in the context scope.</LI>
+</OL>
+
+
+<H3><A name="RepositoryServerHOWTO-Step2Contextconfiguration"></A>Step 2 - Context configuration</H3>
+
+<P>In Tomcat 4.x and 5.0, add the following snippet in server.xml under the Context element of your web application.</P>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+<Resource name=<SPAN class="code-quote">"jcr/repository"</SPAN>
+ auth=<SPAN class="code-quote">"Container"</SPAN>
+ type=<SPAN class="code-quote">"javax.jcr.Repository"</SPAN>/>
+
+<ResourceParams name=<SPAN class="code-quote">"jcr/repository"</SPAN>>
+ <parameter>
+ <name>factory</name>
+ <value>org.apache.jackrabbit.rmi.client.ClientRepositoryFactory</value>
+ </parameter>
+ <parameter>
+ <name>url</name>
+ <value>[The RMI URL of the repository]</value>
+ </parameter>
+</ResourceParams>
+</PRE>
+</DIV></DIV>
+
+<P>In Tomcat 5.5, add the following snippet in your application's context.xml file (or in the server.xml file if you prefer central configuration).</P>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+<Resource name=<SPAN class="code-quote">"jcr/repository"</SPAN>
+ auth=<SPAN class="code-quote">"Container"</SPAN>
+ type=<SPAN class="code-quote">"javax.jcr.Repository"</SPAN>
+ factory=<SPAN class="code-quote">"org.apache.jackrabbit.rmi.client.ClientRepositoryFactory"</SPAN>
+ url=<SPAN class="code-quote">"[The RMI URL of the repository]"</SPAN>/>
+</PRE>
+</DIV></DIV>
+ </DIV>
+ <DIV id="end"></DIV>
+ </DIV>
+ <DIV id="footer">
+ <P>
+ © 2004-2010 The Apache Software Foundation.
+ - <A href="http://jackrabbit.apache.org/privacy-policy.html">Privacy Policy</A> -
+ [<A href="https://cwiki.apache.org/confluence/pages/editpage.action?pageId=75327">edit this page</A>]
+ <BR>
+ Apache Jackrabbit, Jackrabbit, Apache, the Apache feather logo, and the Apache
+ Jackrabbit project logo are trademarks of The Apache Software Foundation.
+ </P>
+ </DIV>
+ </DIV>
+<!-- JCR- 1315: Add Google Analytics to Jackrabbit web site -->
+<SCRIPT type="text/javascript">
+var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
+document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
+</SCRIPT>
+<SCRIPT type="text/javascript">
+var pageTracker = _gat._getTracker("UA-837900-2");
+pageTracker._initData();
+pageTracker._trackPageview();
+</SCRIPT>
+ </BODY>
+</HTML>