jackrabbit-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ju...@apache.org
Subject 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...
Date Mon, 31 Dec 2012 12:40:13 GMT
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 &amp; 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">
+&lt;Resource name=<SPAN class="code-quote">&quot;jcr/repository&quot;</SPAN>
+          auth=<SPAN class="code-quote">&quot;Container&quot;</SPAN>
+          type=<SPAN class="code-quote">&quot;javax.jcr.Repository&quot;</SPAN>/&gt;
+
+&lt;ResourceParams name=<SPAN class="code-quote">&quot;jcr/repository&quot;</SPAN>&gt;
+  &lt;parameter&gt;
+    &lt;name&gt;factory&lt;/name&gt;
+    &lt;value&gt;org.apache.jackrabbit.rmi.client.ClientRepositoryFactory&lt;/value&gt;
+  &lt;/parameter&gt;
+  &lt;parameter&gt;
+    &lt;name&gt;url&lt;/name&gt;
+    &lt;value&gt;[The RMI URL of the repository]&lt;/value&gt;
+  &lt;/parameter&gt;
+&lt;/ResourceParams&gt;
+</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">
+&lt;Resource name=<SPAN class="code-quote">&quot;jcr/repository&quot;</SPAN>
+          auth=<SPAN class="code-quote">&quot;Container&quot;</SPAN>
+          type=<SPAN class="code-quote">&quot;javax.jcr.Repository&quot;</SPAN>
+          factory=<SPAN class="code-quote">&quot;org.apache.jackrabbit.rmi.client.ClientRepositoryFactory&quot;</SPAN>
+          url=<SPAN class="code-quote">&quot;[The RMI URL of the repository]&quot;</SPAN>/&gt;
+</PRE>
+</DIV></DIV>
+        </DIV>
+        <DIV id="end"></DIV>
+      </DIV>
+      <DIV id="footer">
+        <P>
+          &copy; 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>



Mime
View raw message