[MRM-1327] implement alternative or improve repository metadata storage: add documentation

git-svn-id: https://svn.apache.org/repos/asf/archiva/trunk@1179638 13f79535-47bb-0310-9956-ffa450edef68

3 files changed, 55 insertions, 4 deletions

diff --git a/archiva-docs/src/site/apt/adminguide/index.apt b/archiva-docs/src/site/apt/adminguide/index.apt
index 218bb5462..9e229ac63 100644
--- a/archiva-docs/src/site/apt/adminguide/index.apt
+++ b/archiva-docs/src/site/apt/adminguide/index.apt
@@ -45,6 +45,8 @@ System Administrators Guide to Apache Archiva
 
     * {{{./web-services.html} Archiva Web Services}}
 
+    * {{{./repositories-content-storage.html} Repositories Content Storage}}
+
 
     []
 
diff --git a/archiva-docs/src/site/apt/adminguide/repositories-content-storage.apt b/archiva-docs/src/site/apt/adminguide/repositories-content-storage.apt
new file mode 100644
index 000000000..5b847a77b
--- /dev/null
+++ b/archiva-docs/src/site/apt/adminguide/repositories-content-storage.apt
@@ -0,0 +1,48 @@
+ ------
+ Repositories Content Storage
+ ------
+ Olivier Lamy
+ ------
+ 2011-10-06
+ ------
+
+~~ 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.
+
+~~ NOTE: For help with the syntax of this file, see:
+~~ http://maven.apache.org/guides/mini/guide-apt-format.html
+
+Repositories Content Storage
+
+ Prior to version 1.4-M1, repository content is now stored in a jcr repository (based on Apache Jackrabbit implementation).
+
+ A default Jackrabbit configuration is provided :
+
+%{snippet|id=default-repository|url=http://svn.apache.org/repos/asf/archiva/trunk/archiva-modules/plugins/metadata-store-jcr/src/main/resources/org/apache/archiva/metadata/repository/jcr/repository.xml}
+
+ You can use your own configuration by adding a file repository.xml in $\{appserver.base}/conf.
+
+ By default, the Jcr repository is stored $\{appserver.base}/data/jcr.
+
+ If you want to change this default location, you must edit the file WEB-INF/applicationContext.xml, uncomment/edit lines and change with your values:
+
++----------------------
+  <bean id="jcr-config" class="org.apache.archiva.metadata.repository.jcr.ArchivaJcrRepositoryConfig" factory-method="create">
+    <constructor-arg value="${appserver.base}/conf/repository.xml"/>
+    <constructor-arg value="${appserver.base}/data/jcr"/>
+  </bean>
++----------------------
diff --git a/archiva-docs/src/site/site.xml b/archiva-docs/src/site/site.xml
index 1a626c294..8b2c30dbe 100644
--- a/archiva-docs/src/site/site.xml
+++ b/archiva-docs/src/site/site.xml
@@ -57,10 +57,11 @@
         <item name="Installing as a WAR"     href="/adminguide/webapp.html" />
         <item name="Upgrading to a New Version"     href="/adminguide/upgrade.html" />
       </item>
-      <item name="Databases"                 href="/adminguide/databases.html" />
-      <item name="Security"                  href="/adminguide/security.html" collapse="true">
-        <item name="Roles"                   href="/adminguide/roles.html" />
-        <item name="Customising"             href="/adminguide/customising-security.html" />
+      <item name="Databases"                    href="/adminguide/databases.html" />
+      <item name="Repositories Content Storage" href="/adminguide/repositories-content-storage.html"/>
+      <item name="Security"                     href="/adminguide/security.html" collapse="true">
+        <item name="Roles"                      href="/adminguide/roles.html" />
+        <item name="Customising"                href="/adminguide/customising-security.html" />
 <!-- TODO: for a future version
         <item name="Using LDAP"              href="/adminguide/ldap.html" />
 -->