You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@archiva.apache.org by ol...@apache.org on 2012/09/19 15:36:39 UTC

svn commit: r1387592 [5/14] - in /archiva/site-content/docs/1.4-M2: ./ adminguide/ adminguide/webservices/ css/ customising/ images/ images/fancybox/ images/logos/ images/tour/ js/ tour/ userguide/

Added: archiva/site-content/docs/1.4-M2/adminguide/standalone.html
URL: http://svn.apache.org/viewvc/archiva/site-content/docs/1.4-M2/adminguide/standalone.html?rev=1387592&view=auto
==============================================================================
--- archiva/site-content/docs/1.4-M2/adminguide/standalone.html (added)
+++ archiva/site-content/docs/1.4-M2/adminguide/standalone.html Wed Sep 19 13:36:34 2012
@@ -0,0 +1,260 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!-- Generated by Apache Maven Doxia at Dec 16, 2011 -->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+    <title>Installing Standalone Distribution of Apache Archiva</title>
+    <link rel="stylesheet" href="../css/apache-maven-fluido.min.css" />
+    <link rel="stylesheet" href="../css/site.css" />
+    <link rel="stylesheet" href="../css/print.css" media="print" />
+        <style>body{padding-top: 20px;}</style>
+    
+    <script type="text/javascript" src="../js/apache-maven-fluido.min.js"></script>
+
+          
+                
+        <?xml version="1.0" encoding="UTF-8"?>
+<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>
+      
+                
+        <?xml version="1.0" encoding="UTF-8"?>
+<script type="text/javascript">var pageTracker = _gat._getTracker("UA-140879-5");
+pageTracker._initData();
+pageTracker._trackPageview();</script>
+          
+      <meta name="author" content="Olivier Lamy" />
+    <meta name="Date-Creation-yyyymmdd" content="20110929" />
+    <meta name="Date-Revision-yyyymmdd" content="20111216" />
+    <meta http-equiv="Content-Language" content="en" />
+    
+        </head>
+  <body>
+        
+    
+        <div class="container-fluid">
+                <div id="banner">
+        <div class="pull-left">                                <a href="../../../" id="bannerLeft">
+                                                <img src="../../../images/archiva.png" alt="Apache Archiva"/>
+                </a>
+      </div>
+        <div class="pull-right">                  <a href="http://www.apache.org/" id="bannerRight">
+                                        <img src="http://www.apache.org/images/asf_logo_wide.png" alt="Apache Software Foundation"/>
+                </a>
+      </div>
+        <div class="clear"><hr/></div>
+      </div>
+      
+      <div id="breadcrumbs">
+        <ul class="breadcrumb">
+                
+                
+                              <li class="">
+                    <a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a>
+        <li class="divider ">/</li>
+      </li>
+            <li class="">
+                    <a href="../" title="Apache Archiva">Apache Archiva</a>
+        <li class="divider ">/</li>
+      </li>
+            <li class="">
+                    <a href="../index.html" title="1.4-M2">1.4-M2</a>
+        <li class="divider ">/</li>
+      </li>
+    <li class="">Installing Standalone Distribution of Apache Archiva</li>
+                      
+                
+                  <li id="publishDate" class="pull-right">Last Published: 2011-12-16</li> <li class="divider pull-right">|</li>
+              <li id="projectVersion" class="pull-right">Version: 1.4-M2</li>
+                    </ul>
+      </div>
+
+            <div id="leftColumn" class="sidebar">
+        <div class="well">
+                
+                
+                                   <h5>Introduction</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="../quick-start.html" title="Quick Start">Quick Start</a>
+            </li>
+                  <li class="none">
+                          <a href="../tour/index.html" title="Feature Tour">Feature Tour</a>
+            </li>
+                  <li class="none">
+                          <a href="../release-notes.html" title="Release Notes">Release Notes</a>
+            </li>
+                  <li class="none">
+                          <a href="../../../download.html" title="Downloads">Downloads</a>
+            </li>
+          </ul>
+                       <h5>Users Guide</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="../userguide/browsing.html" title="Browsing">Browsing</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/searching.html" title="Searching">Searching</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/find-artifact.html" title="Identifying an Artifact">Identifying an Artifact</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/delete-artifact.html" title="Deleting an Artifact">Deleting an Artifact</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/using-repository.html" title="Using as a repository">Using as a repository</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/deploy.html" title="Deploying to repository">Deploying to repository</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/virtual-repositories.html" title="Configuring Virtual Repositories">Configuring Virtual Repositories</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/rss.html" title="Rss Feeds in Archiva">Rss Feeds in Archiva</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/auditlog-report.html" title="Audit Log Report">Audit Log Report</a>
+            </li>
+          </ul>
+                       <h5>Administrators Guide</h5>
+                  <ul>
+                                                                                                                  <li class="expanded">
+                          <a href="../adminguide/installing.html" title="Installing Archiva">Installing Archiva</a>
+                    <ul>
+                      <li class="none">
+            <strong>Installing Standalone</strong>
+          </li>
+                      <li class="none">
+                          <a href="../adminguide/webapp.html" title="Installing as a WAR">Installing as a WAR</a>
+            </li>
+                      <li class="none">
+                          <a href="../adminguide/upgrade.html" title="Upgrading to a New Version">Upgrading to a New Version</a>
+            </li>
+              </ul>
+        </li>
+                  <li class="none">
+                          <a href="../adminguide/databases.html" title="Databases">Databases</a>
+            </li>
+                  <li class="none">
+                          <a href="../adminguide/repositories-content-storage.html" title="Repositories Content Storage">Repositories Content Storage</a>
+            </li>
+                                                                                      <li class="collapsed">
+                          <a href="../adminguide/security.html" title="Security">Security</a>
+                  </li>
+                                                                                                                                                                                <li class="collapsed">
+                          <a href="../adminguide/configuration.html" title="Runtime Configuration">Runtime Configuration</a>
+                  </li>
+                  <li class="none">
+                          <a href="../adminguide/configuration-files.html" title="Configuration Files">Configuration Files</a>
+            </li>
+                                                                                                        <li class="collapsed">
+                          <a href="../adminguide/logging.html" title="Log Files">Log Files</a>
+                  </li>
+                  <li class="none">
+                          <a href="../adminguide/reports.html" title="Reports">Reports</a>
+            </li>
+                                                                                <li class="expanded">
+                          <a href="../adminguide/web-services.html" title="Web Services">Web Services</a>
+                    <ul>
+                      <li class="none">
+                          <a href="../adminguide/webservices/xml-rpc.html" title="Xml Rpc">Xml Rpc</a>
+            </li>
+                      <li class="none">
+                          <a href="../adminguide/webservices/rest.html" title="REST">REST</a>
+            </li>
+              </ul>
+        </li>
+          </ul>
+                       <h5>Customising Archiva</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="../customising/writing-consumer.html" title="Writing a Consumer Plugin">Writing a Consumer Plugin</a>
+            </li>
+          </ul>
+                       <h5>More Information</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="http://cwiki.apache.org/confluence/display/ARCHIVA/Index" class="externalLink" title="Archiva Wiki">Archiva Wiki</a>
+            </li>
+          </ul>
+                       <h5>ASF</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How Apache Works">How Apache Works</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/" class="externalLink" title="Foundation">Foundation</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsoring Apache">Sponsoring Apache</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks">Thanks</a>
+            </li>
+          </ul>
+                       <h5>Project Documentation</h5>
+                  <ul>
+                                                                                      <li class="collapsed">
+                          <a href="../project-info.html" title="Project Information">Project Information</a>
+                  </li>
+          </ul>
+                      
+                
+      
+          
+          <div id="poweredBy">
+                            <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+        <img class="poweredBy" alt="Built by Maven" src="../images/logos/maven-feather.png" />
+      </a>
+                </div>
+        </div>
+      </div>
+      
+      <div id="bodyColumn" class="content">
+        <div id="contentBox">
+                              
+          <!-- 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. --><div class="section"><h2>Installing Standalone Distribution of Apache Archiva<a name="Installing_S
 tandalone_Distribution_of_Apache_Archiva"></a></h2><p>Installing the standalone distribution of Archiva is quite simple - for an example, see the <a href="../quick-start.html"> Quick Start</a> guide.</p><p>However, the best way to use this installation technique is to separate the configuration from the installation to make it easy to upgrade to newer versions in the future.</p><div class="section"><h3>Running Archiva<a name="Running_Archiva"></a></h3><p>Archiva can be run by executing:</p><ul><li><tt>bin/archiva</tt>, or <tt>bin\archiva.bat</tt> for Windows (select the one for your environment). The argument can be <tt>console</tt> to run interactively, or <tt>start</tt> to run in the background (in this case, run the script with <tt>stop</tt> to later stop the server). The logs are available in the <tt>logs</tt> directory where Archiva is installed.</li></ul><p>There is an issue with regard to the version of <tt>tr</tt> installed/used by default on Solaris so you might enc
 ounter a series of <tt>Bad String</tt> errors when you run the Archiva binaries in Solaris. You need to use a different version of <tt>tr</tt> in order to get it to work. See <a class="externalLink" href="http://jira.codehaus.org/browse/MRM-1467"> MRM-1467</a> for more details.</p></div><div class="section"><h3>Installing as a Service on Windows<a name="Installing_as_a_Service_on_Windows"></a></h3><p>On Windows, to use the <tt>start</tt> and <tt>stop</tt> commands you must first install it as a service. This is done by running:</p><div><pre>.\bin\archiva.bat install</pre></div><p>You can then use the <tt>start</tt> and <tt>stop</tt> commands as well as the traditional Windows service management console to manage the Archiva service.</p><p>This procedure installs the service to run as the local system user. You must ensure that it has access to read the installation, and to write to the logs and data directories.</p><p>You can later remove the service with:</p><div><pre>.\bin
 \archiva.bat remove</pre></div></div><div class="section"><h3>Separating the base from the installation<a name="Separating_the_base_from_the_installation"></a></h3><p>The standalone installation of Archiva is capable of separating its configuration from installation in much the same way Tomcat does.</p><p>This is achieved by the following steps:</p><ol style="list-style-type: decimal"><li>Create the base location. For example, you might install Archiva in <tt>/opt/archiva-1.4</tt> and the data in <tt>/var/archiva</tt>. Create the directories <tt>/var/archiva/logs</tt>, <tt>/var/archiva/data</tt>, <tt>/var/archiva/temp</tt> and <tt>/var/archiva/conf</tt>.</li><li>Move the configuration files from the Archiva installation (e.g. <tt>/opt/archiva-1.4/conf</tt> to the new location (e.g. <tt>/var/archiva/conf</tt>). If you've previously run Archiva, you may need to edit <tt>conf/archiva.xml</tt> to change the location of the repositories.</li><li>(Optionally, leave a README file i
 n the old conf location as a reminder of where you moved the config files.)</li><li>Set the environment variable <tt>ARCHIVA_BASE</tt> to the new location (e.g. <tt>/var/archiva</tt>). In bash, be sure to export the variable.</li><li>Start Archiva standalone as described above from the installation location</li></ol></div><div class="section"><h3>Configuring Archiva<a name="Configuring_Archiva"></a></h3><p>Archiva's configuration is loaded from the following files, in order of precedence:</p><ul><li><tt>~/.m2/archiva.xml</tt></li><li><tt>$ARCHIVA_BASE/conf/archiva.xml</tt></li><li><tt>conf/archiva.xml</tt> in the Archiva installation</li></ul><p>When Archiva saves its configuration, all configuration is stored in a single file. The file chosen is by the following rules:</p><ul><li>If <tt>~/.m2/archiva.xml</tt> exists, it is saved there</li><li>Otherwise, if <tt>$ARCHIVA_BASE/conf/archiva.xml</tt> exists, it is saved there</li><li>If neither apply, it is saved to <tt>~/.m2/ar
 chiva.xml</tt>.</li></ul><p>The configuration will never be saved in the Archiva installation directory if you are using a separate base directory.</p><p>Note that the configuration can be edited, but only when Archiva is not running as it will not reload a changed configuration file, and will save over it if something is changed in the web interface.</p></div><div class="section"><h3>Database<a name="Database"></a></h3><p>By default, Archiva uses embedded <a class="externalLink" href="http://db.apache.org/derby">Apache Derby</a> to store the user information. It can be configured to use an external database by providing a JDBC driver and editing the <tt>jetty.xml</tt> file.</p><ol style="list-style-type: decimal"><li>Place the jar containing the JDBC driver in the <tt>lib</tt> directory of the Archiva installation.</li><li>Edit <tt>conf/jetty.xml</tt>, providing the JDBC driver class name, database url, username, and password.</li></ol><p>The example below uses Mysql for th
 e database server. You can take a look at <a class="externalLink" href="http://cwiki.apache.org/confluence/display/ARCHIVA/Archiva+with+MySQL">Archiva with MySQL</a> for more details.</p><div class="source"><pre class="prettyprint">  ...
+
+  &lt;!-- Users / Security Database --&gt;
+
+  &lt;New id=&quot;users&quot; class=&quot;org.mortbay.jetty.plus.naming.Resource&quot;&gt;
+    &lt;Arg&gt;jdbc/users&lt;/Arg&gt;
+    &lt;Arg&gt;
+      &lt;New class=&quot;com.mysql.jdbc.jdbc2.optional.MysqlDataSource&quot;&gt;
+        &lt;Set name=&quot;serverName&quot;&gt;localhost&lt;/Set&gt;
+        &lt;Set name=&quot;databaseName&quot;&gt;redback&lt;/Set&gt;
+        &lt;Set name=&quot;user&quot;&gt;archiva&lt;/Set&gt;
+        &lt;Set name=&quot;password&quot;&gt;sa&lt;/Set&gt;
+      &lt;/New&gt;
+    &lt;/Arg&gt;
+  &lt;/New&gt;
+
+  &lt;New id=&quot;usersShutdown&quot; class=&quot;org.mortbay.jetty.plus.naming.Resource&quot;&gt;
+    &lt;Arg&gt;jdbc/usersShutdown&lt;/Arg&gt;
+    &lt;Arg&gt;
+      &lt;New class=&quot;com.mysql.jdbc.jdbc2.optional.MysqlDataSource&quot;&gt;
+        &lt;Set name=&quot;url&quot;&gt;jdbc:mysql://localhost/redback&lt;/Set&gt;
+        &lt;Set name=&quot;user&quot;&gt;archiva&lt;/Set&gt;
+        &lt;Set name=&quot;password&quot;&gt;sa&lt;/Set&gt;
+      &lt;/New&gt;
+    &lt;/Arg&gt;
+  &lt;/New&gt;
+  ...</pre></div><p>More information about using Derby Network Server as an external user database for Archiva can be found on the wiki: <a class="externalLink" href="http://cwiki.apache.org/confluence/display/ARCHIVA/Archiva+User+DB+on+Derby+Network+Server"> Archiva User DB on Derby Network Server</a></p></div></div>
+                  </div>
+      </div>
+    </div>
+
+    <footer class="footer">
+            <div class="container-fluid">
+              <div class="row span16">Copyright &copy;                    2006-2011
+                        <a href="http://www.apache.org/">The Apache Software Foundation</a>.
+            All Rights Reserved.      
+                
+      </div>
+
+                      </div>
+    </footer>
+  </body>
+</html>

Added: archiva/site-content/docs/1.4-M2/adminguide/upgrade.html
URL: http://svn.apache.org/viewvc/archiva/site-content/docs/1.4-M2/adminguide/upgrade.html?rev=1387592&view=auto
==============================================================================
--- archiva/site-content/docs/1.4-M2/adminguide/upgrade.html (added)
+++ archiva/site-content/docs/1.4-M2/adminguide/upgrade.html Wed Sep 19 13:36:34 2012
@@ -0,0 +1,232 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!-- Generated by Apache Maven Doxia at Dec 16, 2011 -->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+    <title>Upgrading Archiva</title>
+    <link rel="stylesheet" href="../css/apache-maven-fluido.min.css" />
+    <link rel="stylesheet" href="../css/site.css" />
+    <link rel="stylesheet" href="../css/print.css" media="print" />
+        <style>body{padding-top: 20px;}</style>
+    
+    <script type="text/javascript" src="../js/apache-maven-fluido.min.js"></script>
+
+          
+                
+        <?xml version="1.0" encoding="UTF-8"?>
+<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>
+      
+                
+        <?xml version="1.0" encoding="UTF-8"?>
+<script type="text/javascript">var pageTracker = _gat._getTracker("UA-140879-5");
+pageTracker._initData();
+pageTracker._trackPageview();</script>
+          
+    <meta name="Date-Revision-yyyymmdd" content="20111216" />
+    <meta http-equiv="Content-Language" content="en" />
+    
+        </head>
+  <body>
+        
+    
+        <div class="container-fluid">
+                <div id="banner">
+        <div class="pull-left">                                <a href="../../../" id="bannerLeft">
+                                                <img src="../../../images/archiva.png" alt="Apache Archiva"/>
+                </a>
+      </div>
+        <div class="pull-right">                  <a href="http://www.apache.org/" id="bannerRight">
+                                        <img src="http://www.apache.org/images/asf_logo_wide.png" alt="Apache Software Foundation"/>
+                </a>
+      </div>
+        <div class="clear"><hr/></div>
+      </div>
+      
+      <div id="breadcrumbs">
+        <ul class="breadcrumb">
+                
+                
+                              <li class="">
+                    <a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a>
+        <li class="divider ">/</li>
+      </li>
+            <li class="">
+                    <a href="../" title="Apache Archiva">Apache Archiva</a>
+        <li class="divider ">/</li>
+      </li>
+            <li class="">
+                    <a href="../index.html" title="1.4-M2">1.4-M2</a>
+        <li class="divider ">/</li>
+      </li>
+    <li class="">Upgrading Archiva</li>
+                      
+                
+                  <li id="publishDate" class="pull-right">Last Published: 2011-12-16</li> <li class="divider pull-right">|</li>
+              <li id="projectVersion" class="pull-right">Version: 1.4-M2</li>
+                    </ul>
+      </div>
+
+            <div id="leftColumn" class="sidebar">
+        <div class="well">
+                
+                
+                                   <h5>Introduction</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="../quick-start.html" title="Quick Start">Quick Start</a>
+            </li>
+                  <li class="none">
+                          <a href="../tour/index.html" title="Feature Tour">Feature Tour</a>
+            </li>
+                  <li class="none">
+                          <a href="../release-notes.html" title="Release Notes">Release Notes</a>
+            </li>
+                  <li class="none">
+                          <a href="../../../download.html" title="Downloads">Downloads</a>
+            </li>
+          </ul>
+                       <h5>Users Guide</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="../userguide/browsing.html" title="Browsing">Browsing</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/searching.html" title="Searching">Searching</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/find-artifact.html" title="Identifying an Artifact">Identifying an Artifact</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/delete-artifact.html" title="Deleting an Artifact">Deleting an Artifact</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/using-repository.html" title="Using as a repository">Using as a repository</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/deploy.html" title="Deploying to repository">Deploying to repository</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/virtual-repositories.html" title="Configuring Virtual Repositories">Configuring Virtual Repositories</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/rss.html" title="Rss Feeds in Archiva">Rss Feeds in Archiva</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/auditlog-report.html" title="Audit Log Report">Audit Log Report</a>
+            </li>
+          </ul>
+                       <h5>Administrators Guide</h5>
+                  <ul>
+                                                                                                                  <li class="expanded">
+                          <a href="../adminguide/installing.html" title="Installing Archiva">Installing Archiva</a>
+                    <ul>
+                      <li class="none">
+                          <a href="../adminguide/standalone.html" title="Installing Standalone">Installing Standalone</a>
+            </li>
+                      <li class="none">
+                          <a href="../adminguide/webapp.html" title="Installing as a WAR">Installing as a WAR</a>
+            </li>
+                      <li class="none">
+            <strong>Upgrading to a New Version</strong>
+          </li>
+              </ul>
+        </li>
+                  <li class="none">
+                          <a href="../adminguide/databases.html" title="Databases">Databases</a>
+            </li>
+                  <li class="none">
+                          <a href="../adminguide/repositories-content-storage.html" title="Repositories Content Storage">Repositories Content Storage</a>
+            </li>
+                                                                                      <li class="collapsed">
+                          <a href="../adminguide/security.html" title="Security">Security</a>
+                  </li>
+                                                                                                                                                                                <li class="collapsed">
+                          <a href="../adminguide/configuration.html" title="Runtime Configuration">Runtime Configuration</a>
+                  </li>
+                  <li class="none">
+                          <a href="../adminguide/configuration-files.html" title="Configuration Files">Configuration Files</a>
+            </li>
+                                                                                                        <li class="collapsed">
+                          <a href="../adminguide/logging.html" title="Log Files">Log Files</a>
+                  </li>
+                  <li class="none">
+                          <a href="../adminguide/reports.html" title="Reports">Reports</a>
+            </li>
+                                                                                <li class="expanded">
+                          <a href="../adminguide/web-services.html" title="Web Services">Web Services</a>
+                    <ul>
+                      <li class="none">
+                          <a href="../adminguide/webservices/xml-rpc.html" title="Xml Rpc">Xml Rpc</a>
+            </li>
+                      <li class="none">
+                          <a href="../adminguide/webservices/rest.html" title="REST">REST</a>
+            </li>
+              </ul>
+        </li>
+          </ul>
+                       <h5>Customising Archiva</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="../customising/writing-consumer.html" title="Writing a Consumer Plugin">Writing a Consumer Plugin</a>
+            </li>
+          </ul>
+                       <h5>More Information</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="http://cwiki.apache.org/confluence/display/ARCHIVA/Index" class="externalLink" title="Archiva Wiki">Archiva Wiki</a>
+            </li>
+          </ul>
+                       <h5>ASF</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How Apache Works">How Apache Works</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/" class="externalLink" title="Foundation">Foundation</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsoring Apache">Sponsoring Apache</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks">Thanks</a>
+            </li>
+          </ul>
+                       <h5>Project Documentation</h5>
+                  <ul>
+                                                                                      <li class="collapsed">
+                          <a href="../project-info.html" title="Project Information">Project Information</a>
+                  </li>
+          </ul>
+                      
+                
+      
+          
+          <div id="poweredBy">
+                            <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+        <img class="poweredBy" alt="Built by Maven" src="../images/logos/maven-feather.png" />
+      </a>
+                </div>
+        </div>
+      </div>
+      
+      <div id="bodyColumn" class="content">
+        <div id="contentBox">
+                              
+          <!-- 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. --><div class="section"><h2>Upgrading Archiva<a name="Upgrading_Archiva"></a></h2><p>Upgrading Archiv
 a is straightforward, particularly if the directions for separating the base from the installation are followed. You need to retain the following directories:</p><ul><li><tt>conf</tt> - the configuration files can be reused across different versions. Note that when the standalone version is used, <tt>wrapper.conf</tt> and <tt>jetty.xml</tt> may need to be replaced after upgrade and changes reapplied. See specific notes in the version details below.</li><li><tt>data</tt> - all Archiva data. More specifically:<ul><li><tt>data/repositories</tt> is portable across versions (both forwards and backwards).</li><li><tt>data/databases/users</tt> must always be retained as it contains the permissions and user information across versions, even if LDAP is being used for authentication.</li><li><tt>data/databases/archiva</tt> exists for Archiva 1.3.x and below. This can be retained through upgrades, but can also be regenerated at any time. This no longer exists in Archiva 1.4+.</li></ul>
 </li></ul><p>The following describes instructions specific to upgrading between different versions.</p><div class="section"><h3>Upgrading Archiva to 1.4+<a name="Upgrading_Archiva_to_1.4"></a></h3><div class="section"><h4>Metadata Repository<a name="Metadata_Repository"></a></h4><!-- TODO: metadata repository description --></div><div class="section"><h4>Java Package Changes and Library Changes<a name="Java_Package_Changes_and_Library_Changes"></a></h4><p>All Java packages have changed from <tt>org.apache.maven.archiva</tt> to <tt>org.apache.archiva</tt> and have undergone significant changes. If you have written custom consumers, are using the XML-RPC client, or interfacing with other Java libraries the code will need to be adjusted.</p></div><div class="section"><h4>Configuration References<a name="Configuration_References"></a></h4><p>If you had used the undocumented ability to modify <tt>application.xml</tt> to alter the configuration search path, note that in Archiva 1.
 4+ you must use the <tt>org.apache.archiva</tt> configuration search path instead of <tt>org.apache.maven.archiva</tt>.</p></div><div class="section"><h4>Updated Jetty configuration<a name="Updated_Jetty_configuration"></a></h4><p>If you are using the Jetty standalone configuration with a custom <tt>jetty.xml</tt>, note that it has been upgraded to Jetty 7 as of Archiva 1.4-M2. You will need to recreate your customisations using the <tt>jetty.xml</tt> shipped with Archiva.</p><p>In addition, you now need to ensure that a <tt>temp</tt> directory is created inside the Archiva application base directory (alongside <tt>conf</tt>, <tt>data</tt> and <tt>logs</tt>).</p></div></div><div class="section"><h3>Upgrading Archiva to 1.2.2<a name="Upgrading_Archiva_to_1.2.2"></a></h3><p>Since Archiva 1.2.2, the Jetty version has been upgraded to 6.1.19. If upgrading to Archiva 1.2.2 (or higher versions), there is a need to update the library contents listed in <tt>ARCHIVA_BASE/conf/wrapper
 .conf</tt> with the ones included in the new distribution if the <tt>ARCHIVA_BASE</tt> directory is separate from the installation.</p></div></div>
+                  </div>
+      </div>
+    </div>
+
+    <footer class="footer">
+            <div class="container-fluid">
+              <div class="row span16">Copyright &copy;                    2006-2011
+                        <a href="http://www.apache.org/">The Apache Software Foundation</a>.
+            All Rights Reserved.      
+                
+      </div>
+
+                      </div>
+    </footer>
+  </body>
+</html>

Added: archiva/site-content/docs/1.4-M2/adminguide/web-services.html
URL: http://svn.apache.org/viewvc/archiva/site-content/docs/1.4-M2/adminguide/web-services.html?rev=1387592&view=auto
==============================================================================
--- archiva/site-content/docs/1.4-M2/adminguide/web-services.html (added)
+++ archiva/site-content/docs/1.4-M2/adminguide/web-services.html Wed Sep 19 13:36:34 2012
@@ -0,0 +1,224 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!-- Generated by Apache Maven Doxia at Dec 16, 2011 -->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+    <title>Using Archiva Web Services</title>
+    <link rel="stylesheet" href="../css/apache-maven-fluido.min.css" />
+    <link rel="stylesheet" href="../css/site.css" />
+    <link rel="stylesheet" href="../css/print.css" media="print" />
+        <style>body{padding-top: 20px;}</style>
+    
+    <script type="text/javascript" src="../js/apache-maven-fluido.min.js"></script>
+
+          
+                
+        <?xml version="1.0" encoding="UTF-8"?>
+<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>
+      
+                
+        <?xml version="1.0" encoding="UTF-8"?>
+<script type="text/javascript">var pageTracker = _gat._getTracker("UA-140879-5");
+pageTracker._initData();
+pageTracker._trackPageview();</script>
+          
+      <meta name="author" content="Maria Odea Ching
+Olivier Lamy" />
+    <meta name="Date-Creation-yyyymmdd" content="20110916" />
+    <meta name="Date-Revision-yyyymmdd" content="20111216" />
+    <meta http-equiv="Content-Language" content="en" />
+    
+        </head>
+  <body>
+        
+    
+        <div class="container-fluid">
+                <div id="banner">
+        <div class="pull-left">                                <a href="../../../" id="bannerLeft">
+                                                <img src="../../../images/archiva.png" alt="Apache Archiva"/>
+                </a>
+      </div>
+        <div class="pull-right">                  <a href="http://www.apache.org/" id="bannerRight">
+                                        <img src="http://www.apache.org/images/asf_logo_wide.png" alt="Apache Software Foundation"/>
+                </a>
+      </div>
+        <div class="clear"><hr/></div>
+      </div>
+      
+      <div id="breadcrumbs">
+        <ul class="breadcrumb">
+                
+                
+                              <li class="">
+                    <a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a>
+        <li class="divider ">/</li>
+      </li>
+            <li class="">
+                    <a href="../" title="Apache Archiva">Apache Archiva</a>
+        <li class="divider ">/</li>
+      </li>
+            <li class="">
+                    <a href="../index.html" title="1.4-M2">1.4-M2</a>
+        <li class="divider ">/</li>
+      </li>
+    <li class="">Using Archiva Web Services</li>
+                      
+                
+                  <li id="publishDate" class="pull-right">Last Published: 2011-12-16</li> <li class="divider pull-right">|</li>
+              <li id="projectVersion" class="pull-right">Version: 1.4-M2</li>
+                    </ul>
+      </div>
+
+            <div id="leftColumn" class="sidebar">
+        <div class="well">
+                
+                
+                                   <h5>Introduction</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="../quick-start.html" title="Quick Start">Quick Start</a>
+            </li>
+                  <li class="none">
+                          <a href="../tour/index.html" title="Feature Tour">Feature Tour</a>
+            </li>
+                  <li class="none">
+                          <a href="../release-notes.html" title="Release Notes">Release Notes</a>
+            </li>
+                  <li class="none">
+                          <a href="../../../download.html" title="Downloads">Downloads</a>
+            </li>
+          </ul>
+                       <h5>Users Guide</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="../userguide/browsing.html" title="Browsing">Browsing</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/searching.html" title="Searching">Searching</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/find-artifact.html" title="Identifying an Artifact">Identifying an Artifact</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/delete-artifact.html" title="Deleting an Artifact">Deleting an Artifact</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/using-repository.html" title="Using as a repository">Using as a repository</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/deploy.html" title="Deploying to repository">Deploying to repository</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/virtual-repositories.html" title="Configuring Virtual Repositories">Configuring Virtual Repositories</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/rss.html" title="Rss Feeds in Archiva">Rss Feeds in Archiva</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/auditlog-report.html" title="Audit Log Report">Audit Log Report</a>
+            </li>
+          </ul>
+                       <h5>Administrators Guide</h5>
+                  <ul>
+                                                                                                        <li class="collapsed">
+                          <a href="../adminguide/installing.html" title="Installing Archiva">Installing Archiva</a>
+                  </li>
+                  <li class="none">
+                          <a href="../adminguide/databases.html" title="Databases">Databases</a>
+            </li>
+                  <li class="none">
+                          <a href="../adminguide/repositories-content-storage.html" title="Repositories Content Storage">Repositories Content Storage</a>
+            </li>
+                                                                                      <li class="collapsed">
+                          <a href="../adminguide/security.html" title="Security">Security</a>
+                  </li>
+                                                                                                                                                                                <li class="collapsed">
+                          <a href="../adminguide/configuration.html" title="Runtime Configuration">Runtime Configuration</a>
+                  </li>
+                  <li class="none">
+                          <a href="../adminguide/configuration-files.html" title="Configuration Files">Configuration Files</a>
+            </li>
+                                                                                                        <li class="collapsed">
+                          <a href="../adminguide/logging.html" title="Log Files">Log Files</a>
+                  </li>
+                  <li class="none">
+                          <a href="../adminguide/reports.html" title="Reports">Reports</a>
+            </li>
+                                                                                    <li class="expanded">
+            <strong>Web Services</strong>
+                  <ul>
+                      <li class="none">
+                          <a href="../adminguide/webservices/xml-rpc.html" title="Xml Rpc">Xml Rpc</a>
+            </li>
+                      <li class="none">
+                          <a href="../adminguide/webservices/rest.html" title="REST">REST</a>
+            </li>
+              </ul>
+        </li>
+          </ul>
+                       <h5>Customising Archiva</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="../customising/writing-consumer.html" title="Writing a Consumer Plugin">Writing a Consumer Plugin</a>
+            </li>
+          </ul>
+                       <h5>More Information</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="http://cwiki.apache.org/confluence/display/ARCHIVA/Index" class="externalLink" title="Archiva Wiki">Archiva Wiki</a>
+            </li>
+          </ul>
+                       <h5>ASF</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How Apache Works">How Apache Works</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/" class="externalLink" title="Foundation">Foundation</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsoring Apache">Sponsoring Apache</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks">Thanks</a>
+            </li>
+          </ul>
+                       <h5>Project Documentation</h5>
+                  <ul>
+                                                                                      <li class="collapsed">
+                          <a href="../project-info.html" title="Project Information">Project Information</a>
+                  </li>
+          </ul>
+                      
+                
+      
+          
+          <div id="poweredBy">
+                            <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+        <img class="poweredBy" alt="Built by Maven" src="../images/logos/maven-feather.png" />
+      </a>
+                </div>
+        </div>
+      </div>
+      
+      <div id="bodyColumn" class="content">
+        <div id="contentBox">
+                              
+          <!-- 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 --><div class="section"><h2>Using Archiva Web Services<a name="Using_Archiva_Web_Services"></a></h2><p>Web services is a new feature for 1.2. Archiva exposes two types of services: administrative and search. More details : <a href="./webservices/xml-rpc.html"> Archiva Xml Rpc Services</a></p><p>Starting version 1.4, you can now use REST services : More details : <a href="./webservices/rest.html"> Archiva REST Services</a></p></div>
+                  </div>
+      </div>
+    </div>
+
+    <footer class="footer">
+            <div class="container-fluid">
+              <div class="row span16">Copyright &copy;                    2006-2011
+                        <a href="http://www.apache.org/">The Apache Software Foundation</a>.
+            All Rights Reserved.      
+                
+      </div>
+
+                      </div>
+    </footer>
+  </body>
+</html>

Added: archiva/site-content/docs/1.4-M2/adminguide/webapp.html
URL: http://svn.apache.org/viewvc/archiva/site-content/docs/1.4-M2/adminguide/webapp.html?rev=1387592&view=auto
==============================================================================
--- archiva/site-content/docs/1.4-M2/adminguide/webapp.html (added)
+++ archiva/site-content/docs/1.4-M2/adminguide/webapp.html Wed Sep 19 13:36:34 2012
@@ -0,0 +1,272 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!-- Generated by Apache Maven Doxia at Dec 16, 2011 -->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+    <title>Installing Apache Archiva as a Web Application</title>
+    <link rel="stylesheet" href="../css/apache-maven-fluido.min.css" />
+    <link rel="stylesheet" href="../css/site.css" />
+    <link rel="stylesheet" href="../css/print.css" media="print" />
+        <style>body{padding-top: 20px;}</style>
+    
+    <script type="text/javascript" src="../js/apache-maven-fluido.min.js"></script>
+
+          
+                
+        <?xml version="1.0" encoding="UTF-8"?>
+<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>
+      
+                
+        <?xml version="1.0" encoding="UTF-8"?>
+<script type="text/javascript">var pageTracker = _gat._getTracker("UA-140879-5");
+pageTracker._initData();
+pageTracker._trackPageview();</script>
+          
+      <meta name="author" content="Olivier Lamy" />
+    <meta name="Date-Creation-yyyymmdd" content="20110929" />
+    <meta name="Date-Revision-yyyymmdd" content="20111216" />
+    <meta http-equiv="Content-Language" content="en" />
+    
+        </head>
+  <body>
+        
+    
+        <div class="container-fluid">
+                <div id="banner">
+        <div class="pull-left">                                <a href="../../../" id="bannerLeft">
+                                                <img src="../../../images/archiva.png" alt="Apache Archiva"/>
+                </a>
+      </div>
+        <div class="pull-right">                  <a href="http://www.apache.org/" id="bannerRight">
+                                        <img src="http://www.apache.org/images/asf_logo_wide.png" alt="Apache Software Foundation"/>
+                </a>
+      </div>
+        <div class="clear"><hr/></div>
+      </div>
+      
+      <div id="breadcrumbs">
+        <ul class="breadcrumb">
+                
+                
+                              <li class="">
+                    <a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a>
+        <li class="divider ">/</li>
+      </li>
+            <li class="">
+                    <a href="../" title="Apache Archiva">Apache Archiva</a>
+        <li class="divider ">/</li>
+      </li>
+            <li class="">
+                    <a href="../index.html" title="1.4-M2">1.4-M2</a>
+        <li class="divider ">/</li>
+      </li>
+    <li class="">Installing Apache Archiva as a Web Application</li>
+                      
+                
+                  <li id="publishDate" class="pull-right">Last Published: 2011-12-16</li> <li class="divider pull-right">|</li>
+              <li id="projectVersion" class="pull-right">Version: 1.4-M2</li>
+                    </ul>
+      </div>
+
+            <div id="leftColumn" class="sidebar">
+        <div class="well">
+                
+                
+                                   <h5>Introduction</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="../quick-start.html" title="Quick Start">Quick Start</a>
+            </li>
+                  <li class="none">
+                          <a href="../tour/index.html" title="Feature Tour">Feature Tour</a>
+            </li>
+                  <li class="none">
+                          <a href="../release-notes.html" title="Release Notes">Release Notes</a>
+            </li>
+                  <li class="none">
+                          <a href="../../../download.html" title="Downloads">Downloads</a>
+            </li>
+          </ul>
+                       <h5>Users Guide</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="../userguide/browsing.html" title="Browsing">Browsing</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/searching.html" title="Searching">Searching</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/find-artifact.html" title="Identifying an Artifact">Identifying an Artifact</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/delete-artifact.html" title="Deleting an Artifact">Deleting an Artifact</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/using-repository.html" title="Using as a repository">Using as a repository</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/deploy.html" title="Deploying to repository">Deploying to repository</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/virtual-repositories.html" title="Configuring Virtual Repositories">Configuring Virtual Repositories</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/rss.html" title="Rss Feeds in Archiva">Rss Feeds in Archiva</a>
+            </li>
+                  <li class="none">
+                          <a href="../userguide/auditlog-report.html" title="Audit Log Report">Audit Log Report</a>
+            </li>
+          </ul>
+                       <h5>Administrators Guide</h5>
+                  <ul>
+                                                                                                                  <li class="expanded">
+                          <a href="../adminguide/installing.html" title="Installing Archiva">Installing Archiva</a>
+                    <ul>
+                      <li class="none">
+                          <a href="../adminguide/standalone.html" title="Installing Standalone">Installing Standalone</a>
+            </li>
+                      <li class="none">
+            <strong>Installing as a WAR</strong>
+          </li>
+                      <li class="none">
+                          <a href="../adminguide/upgrade.html" title="Upgrading to a New Version">Upgrading to a New Version</a>
+            </li>
+              </ul>
+        </li>
+                  <li class="none">
+                          <a href="../adminguide/databases.html" title="Databases">Databases</a>
+            </li>
+                  <li class="none">
+                          <a href="../adminguide/repositories-content-storage.html" title="Repositories Content Storage">Repositories Content Storage</a>
+            </li>
+                                                                                      <li class="collapsed">
+                          <a href="../adminguide/security.html" title="Security">Security</a>
+                  </li>
+                                                                                                                                                                                <li class="collapsed">
+                          <a href="../adminguide/configuration.html" title="Runtime Configuration">Runtime Configuration</a>
+                  </li>
+                  <li class="none">
+                          <a href="../adminguide/configuration-files.html" title="Configuration Files">Configuration Files</a>
+            </li>
+                                                                                                        <li class="collapsed">
+                          <a href="../adminguide/logging.html" title="Log Files">Log Files</a>
+                  </li>
+                  <li class="none">
+                          <a href="../adminguide/reports.html" title="Reports">Reports</a>
+            </li>
+                                                                                <li class="expanded">
+                          <a href="../adminguide/web-services.html" title="Web Services">Web Services</a>
+                    <ul>
+                      <li class="none">
+                          <a href="../adminguide/webservices/xml-rpc.html" title="Xml Rpc">Xml Rpc</a>
+            </li>
+                      <li class="none">
+                          <a href="../adminguide/webservices/rest.html" title="REST">REST</a>
+            </li>
+              </ul>
+        </li>
+          </ul>
+                       <h5>Customising Archiva</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="../customising/writing-consumer.html" title="Writing a Consumer Plugin">Writing a Consumer Plugin</a>
+            </li>
+          </ul>
+                       <h5>More Information</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="http://cwiki.apache.org/confluence/display/ARCHIVA/Index" class="externalLink" title="Archiva Wiki">Archiva Wiki</a>
+            </li>
+          </ul>
+                       <h5>ASF</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How Apache Works">How Apache Works</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/" class="externalLink" title="Foundation">Foundation</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsoring Apache">Sponsoring Apache</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks">Thanks</a>
+            </li>
+          </ul>
+                       <h5>Project Documentation</h5>
+                  <ul>
+                                                                                      <li class="collapsed">
+                          <a href="../project-info.html" title="Project Information">Project Information</a>
+                  </li>
+          </ul>
+                      
+                
+      
+          
+          <div id="poweredBy">
+                            <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+        <img class="poweredBy" alt="Built by Maven" src="../images/logos/maven-feather.png" />
+      </a>
+                </div>
+        </div>
+      </div>
+      
+      <div id="bodyColumn" class="content">
+        <div id="contentBox">
+                              
+          <!-- 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. --><div class="section"><h2>Installing Apache Archiva as a Web Application<a name="Installing_Apache_
 Archiva_as_a_Web_Application"></a></h2><!-- TODO: link to wiki location for other application servers --><p>Archiva can be deployed as a web application into any Java EE application server. This document will show an example of doing so with Tomcat 5.5 and Tomcat 6.0.x.</p><p><b>Note</b>: When you first start Archiva, you will see an Exception that schema SA does not exist - however it doesn't cause a problem. If you use a username other than 'sa', such as 'archiva', then you seem to get the same error but Tomcat fails to start the context and you have to shutdown and restart again.</p></div><div class="section"><h2>To deploy Archiva on Tomcat 5.5 and Tomcat 6.0<a name="To_deploy_Archiva_on_Tomcat_5.5_and_Tomcat_6.0"></a></h2><ul><li>Create a directory in tomcat called archiva, at the same level as bin, conf, logs and the others.</li><li>Copy the war file into the new directory</li><li>Create a <tt>&lt;tomcat home&gt;/conf/Catalina/localhost/archiva.xml</tt> file with the fo
 llowing data (replace the database paths with a suitable location). When using Tomcat 6.0+, do not include the first line (XML encoding) in the <tt>archiva.xml</tt> configuration specified below to avoid parsing errors during startup: <div class="source"><pre class="prettyprint"> &lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;
+ &lt;Context path=&quot;/archiva&quot;
+          docBase=&quot;${catalina.home}/archiva/apache-archiva-1.1.war&quot;&gt;
+
+ &lt;Resource name=&quot;jdbc/users&quot; auth=&quot;Container&quot; type=&quot;javax.sql.DataSource&quot;
+           username=&quot;sa&quot;
+           password=&quot;&quot;
+           driverClassName=&quot;org.apache.derby.jdbc.EmbeddedDriver&quot;
+           url=&quot;jdbc:derby:/path/to/database/users;create=true&quot; /&gt;
+
+ &lt;Resource name=&quot;mail/Session&quot; auth=&quot;Container&quot;
+            type=&quot;javax.mail.Session&quot;
+            mail.smtp.host=&quot;localhost&quot;/&gt;
+ &lt;/Context&gt;</pre></div></li><li>Install <tt>derby-10.1.3.1.jar</tt> (or later), <tt>activation-1.1.jar</tt> and <tt>mail-1.4.jar</tt> into the Tomcat 5.5 <tt>common/lib</tt> or Tomcat 6.0 <tt>lib</tt> directory. This is required since the data sources are instantiated before the web application.<p><b>Note</b>: Tomcat 5.5.20 and 5.5.23 are missing MailSessionFactory and a few other classes. JNDI mail sessions will <i>not</i> work. Use Tomcat 5.5.25 instead, or see <a class="externalLink" href="http://issues.apache.org/bugzilla/show_bug.cgi?id=40668"> Bug 40668</a> for a workaround.</p></li><li>The $<a name="appserver.base">appserver.base</a> java property is used by the Archiva internal logging configuration to determine where to output its logs to. It is important to define this property either in the $CATALINA_OPTS system environment variable if Tomcat is being launched via the command line) or the service properties (if being launched as a service or daemon). The for
 mat typically expected is -Dappserver.base=<i>SOMEWHERE</i>. In this example, we'll put the logs in Tomcat's <tt>logs</tt> directory so we need to set appserver.base property to where Tomcat is installed:<div class="source"><pre class="prettyprint">export CATALINA_OPTS=&quot;-Dappserver.home=$CATALINA_HOME -Dappserver.base=$CATALINA_HOME&quot; (for UNIX)
+
+OR
+
+set CATALINA_OPTS=&quot;-Dappserver.home=%CATALINA_HOME% -Dappserver.base=%CATALINA_HOME%&quot; (for Windows)</pre></div></li><li>If setting the $<a name="appserver.base">appserver.base</a> and $<a name="appserver.home">appserver.home</a> using the previous step does not work, you can set it in the unpacked Archiva web application's <tt>WEB-INF/classes/application.properties</tt> as follows:<div class="source"><pre class="prettyprint"># for Windows:
+appserver.base=%CATALINA_HOME%
+appserver.base=%CATALINA_BASE%
+
+# or, for UNIX:
+appserver.base=$CATALINA_HOME
+appserver.home=$CATALINA_BASE</pre></div></li><li>When running Tomcat as a <b>Windows</b> service, you need to edit <tt>regedit</tt> and then, in <tt>HKEY_LOCAL_MACHINE &gt; SOFTWARE &gt; Apache Software Foundation &gt; Procrun 2.0 &gt; TomcatX &gt; Parameters &gt; Java</tt>, modify the <tt>Options</tt> variable. Set the $<a name="appserver.base">appserver.base</a> property by adding the following parameters at the end:<div class="source"><pre class="prettyprint">-Dappserver.base=%CATALINA_HOME% -Dappserver.home=%CATALINA_HOME%</pre></div></li></ul><p>For more information, see <a class="externalLink" href="http://cwiki.apache.org/confluence/display/ARCHIVA/Archiva+on+Tomcat"> Archiva on Tomcat</a> in the wiki.</p></div><div class="section"><h2>Archiva Configuration<a name="Archiva_Configuration"></a></h2><p>Archiva is configured using the <tt>~/.m2/archiva.xml</tt> configuration file by default when using a Java EE application server. </p><!-- TODO: how to configure the othe
 r file --></div><div class="section"><h2>Upgrading Archiva<a name="Upgrading_Archiva"></a></h2><p>To upgrade the Archiva web application, simply replace the web application with an alternative. Since the database and configuration files are stored externally to the application, no further maintainance is needed.</p><p>For general information about upgrading Archiva, see the relevant section in the <a href="./standalone.html#Upgrading20Archiva"> Installing standalone</a> guide.</p></div><div class="section"><h2>Configuring and Running Archiva<a name="Configuring_and_Running_Archiva"></a></h2><p>Once Archiva is running, it is configured in the same way as the standalone instance. See the <a href="../quick-start.html#Setting20up20your20Archiva20instance"> quick start</a> guide for more information.</p></div><div class="section"><h2>Troubleshooting<a name="Troubleshooting"></a></h2><div class="section"><h3>Error During Startup<a name="Error_During_Startup"></a></h3><p>There are 
 cases when the Tomcat logs only shows the following error during startup:</p><div class="source"><pre class="prettyprint">...
+Aug 17, 2009 11:04:02 AM org.apache.catalina.core.StandardContext start
+SEVERE: Error listenerStart
+Aug 17, 2009 11:04:02 AM org.apache.catalina.core.StandardContext start
+SEVERE: Context [/archiva] startup failed due to previous errors
+Aug 17, 2009 11:04:04 AM org.apache.coyote.http11.Http11BaseProtocol start
+...</pre></div><p>One of the common causes for this <tt>listenerStart Error</tt> is a failure during Spring's initialization. One way to diagnose or confirm the exact cause of the error is by adding the following configuration to the unpacked Archiva webapp's <tt>WEB-INF/classes/log4j.xml</tt>:</p><div class="source"><pre class="prettyprint">&lt;appender name=&quot;console&quot; class=&quot;org.apache.log4j.ConsoleAppender&quot;&gt;
+  &lt;layout class=&quot;org.apache.log4j.PatternLayout&quot;&gt;
+    &lt;param name=&quot;ConversionPattern&quot; value=&quot;%d [%t] %-5p %c %x - %m%n&quot;/&gt;
+  &lt;/layout&gt;
+&lt;/appender&gt;
+
+&lt;logger name=&quot;org.springframework.web&quot;&gt;
+  &lt;level value=&quot;debug&quot;/&gt;
+  &lt;appender-ref ref=&quot;console&quot;/&gt;
+&lt;/logger&gt;</pre></div><p>The above configuration directs Spring's output logs to the Tomcat console and be recorded in Tomcat's log files. </p></div><div class="section"><h3>Diagnosing Errors<a name="Diagnosing_Errors"></a></h3><p>One of the least decipherable errors you can get from Tomcat is a <tt>404</tt> when the deployment fails. In <tt>&lt;tomcat home&gt;/logs/catalina.out</tt> you will only find that it fails, but not why. Also Archiva's logs will not tell you.</p><p>The log messages and stack traces in case of a <tt>404</tt> can be found in <tt>&lt;tomcat home&gt;/logs/localhost.&lt;date&gt;</tt>.</p></div></div>
+                  </div>
+      </div>
+    </div>
+
+    <footer class="footer">
+            <div class="container-fluid">
+              <div class="row span16">Copyright &copy;                    2006-2011
+                        <a href="http://www.apache.org/">The Apache Software Foundation</a>.
+            All Rights Reserved.      
+                
+      </div>
+
+                      </div>
+    </footer>
+  </body>
+</html>

Added: archiva/site-content/docs/1.4-M2/adminguide/webservices/rest.html
URL: http://svn.apache.org/viewvc/archiva/site-content/docs/1.4-M2/adminguide/webservices/rest.html?rev=1387592&view=auto
==============================================================================
--- archiva/site-content/docs/1.4-M2/adminguide/webservices/rest.html (added)
+++ archiva/site-content/docs/1.4-M2/adminguide/webservices/rest.html Wed Sep 19 13:36:34 2012
@@ -0,0 +1,292 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!-- Generated by Apache Maven Doxia at Dec 16, 2011 -->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+    <title>Using REST Services</title>
+    <link rel="stylesheet" href="../../css/apache-maven-fluido.min.css" />
+    <link rel="stylesheet" href="../../css/site.css" />
+    <link rel="stylesheet" href="../../css/print.css" media="print" />
+        <style>body{padding-top: 20px;}</style>
+    
+    <script type="text/javascript" src="../../js/apache-maven-fluido.min.js"></script>
+
+          
+                
+        <?xml version="1.0" encoding="UTF-8"?>
+<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>
+      
+                
+        <?xml version="1.0" encoding="UTF-8"?>
+<script type="text/javascript">var pageTracker = _gat._getTracker("UA-140879-5");
+pageTracker._initData();
+pageTracker._trackPageview();</script>
+          
+      <meta name="author" content="Olivier Lamy" />
+    <meta name="Date-Creation-yyyymmdd" content="20110916" />
+    <meta name="Date-Revision-yyyymmdd" content="20111216" />
+    <meta http-equiv="Content-Language" content="en" />
+    
+        </head>
+  <body>
+        
+    
+        <div class="container-fluid">
+                <div id="banner">
+        <div class="pull-left">                                <a href="../../../../" id="bannerLeft">
+                                                <img src="../../../../images/archiva.png" alt="Apache Archiva"/>
+                </a>
+      </div>
+        <div class="pull-right">                  <a href="http://www.apache.org/" id="bannerRight">
+                                        <img src="http://www.apache.org/images/asf_logo_wide.png" alt="Apache Software Foundation"/>
+                </a>
+      </div>
+        <div class="clear"><hr/></div>
+      </div>
+      
+      <div id="breadcrumbs">
+        <ul class="breadcrumb">
+                
+                
+                              <li class="">
+                    <a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a>
+        <li class="divider ">/</li>
+      </li>
+            <li class="">
+                    <a href="../../" title="Apache Archiva">Apache Archiva</a>
+        <li class="divider ">/</li>
+      </li>
+            <li class="">
+                    <a href="../../index.html" title="1.4-M2">1.4-M2</a>
+        <li class="divider ">/</li>
+      </li>
+    <li class="">Using REST Services</li>
+                      
+                
+                  <li id="publishDate" class="pull-right">Last Published: 2011-12-16</li> <li class="divider pull-right">|</li>
+              <li id="projectVersion" class="pull-right">Version: 1.4-M2</li>
+                    </ul>
+      </div>
+
+            <div id="leftColumn" class="sidebar">
+        <div class="well">
+                
+                
+                                   <h5>Introduction</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="../../quick-start.html" title="Quick Start">Quick Start</a>
+            </li>
+                  <li class="none">
+                          <a href="../../tour/index.html" title="Feature Tour">Feature Tour</a>
+            </li>
+                  <li class="none">
+                          <a href="../../release-notes.html" title="Release Notes">Release Notes</a>
+            </li>
+                  <li class="none">
+                          <a href="../../../../download.html" title="Downloads">Downloads</a>
+            </li>
+          </ul>
+                       <h5>Users Guide</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="../../userguide/browsing.html" title="Browsing">Browsing</a>
+            </li>
+                  <li class="none">
+                          <a href="../../userguide/searching.html" title="Searching">Searching</a>
+            </li>
+                  <li class="none">
+                          <a href="../../userguide/find-artifact.html" title="Identifying an Artifact">Identifying an Artifact</a>
+            </li>
+                  <li class="none">
+                          <a href="../../userguide/delete-artifact.html" title="Deleting an Artifact">Deleting an Artifact</a>
+            </li>
+                  <li class="none">
+                          <a href="../../userguide/using-repository.html" title="Using as a repository">Using as a repository</a>
+            </li>
+                  <li class="none">
+                          <a href="../../userguide/deploy.html" title="Deploying to repository">Deploying to repository</a>
+            </li>
+                  <li class="none">
+                          <a href="../../userguide/virtual-repositories.html" title="Configuring Virtual Repositories">Configuring Virtual Repositories</a>
+            </li>
+                  <li class="none">
+                          <a href="../../userguide/rss.html" title="Rss Feeds in Archiva">Rss Feeds in Archiva</a>
+            </li>
+                  <li class="none">
+                          <a href="../../userguide/auditlog-report.html" title="Audit Log Report">Audit Log Report</a>
+            </li>
+          </ul>
+                       <h5>Administrators Guide</h5>
+                  <ul>
+                                                                                                        <li class="collapsed">
+                          <a href="../../adminguide/installing.html" title="Installing Archiva">Installing Archiva</a>
+                  </li>
+                  <li class="none">
+                          <a href="../../adminguide/databases.html" title="Databases">Databases</a>
+            </li>
+                  <li class="none">
+                          <a href="../../adminguide/repositories-content-storage.html" title="Repositories Content Storage">Repositories Content Storage</a>
+            </li>
+                                                                                      <li class="collapsed">
+                          <a href="../../adminguide/security.html" title="Security">Security</a>
+                  </li>
+                                                                                                                                                                                <li class="collapsed">
+                          <a href="../../adminguide/configuration.html" title="Runtime Configuration">Runtime Configuration</a>
+                  </li>
+                  <li class="none">
+                          <a href="../../adminguide/configuration-files.html" title="Configuration Files">Configuration Files</a>
+            </li>
+                                                                                                        <li class="collapsed">
+                          <a href="../../adminguide/logging.html" title="Log Files">Log Files</a>
+                  </li>
+                  <li class="none">
+                          <a href="../../adminguide/reports.html" title="Reports">Reports</a>
+            </li>
+                                                                                          <li class="expanded">
+                          <a href="../../adminguide/web-services.html" title="Web Services">Web Services</a>
+                    <ul>
+                      <li class="none">
+                          <a href="../../adminguide/webservices/xml-rpc.html" title="Xml Rpc">Xml Rpc</a>
+            </li>
+                      <li class="none">
+            <strong>REST</strong>
+          </li>
+              </ul>
+        </li>
+          </ul>
+                       <h5>Customising Archiva</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="../../customising/writing-consumer.html" title="Writing a Consumer Plugin">Writing a Consumer Plugin</a>
+            </li>
+          </ul>
+                       <h5>More Information</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="http://cwiki.apache.org/confluence/display/ARCHIVA/Index" class="externalLink" title="Archiva Wiki">Archiva Wiki</a>
+            </li>
+          </ul>
+                       <h5>ASF</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How Apache Works">How Apache Works</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/" class="externalLink" title="Foundation">Foundation</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsoring Apache">Sponsoring Apache</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks">Thanks</a>
+            </li>
+          </ul>
+                       <h5>Project Documentation</h5>
+                  <ul>
+                                                                                      <li class="collapsed">
+                          <a href="../../project-info.html" title="Project Information">Project Information</a>
+                  </li>
+          </ul>
+                      
+                
+      
+          
+          <div id="poweredBy">
+                            <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+        <img class="poweredBy" alt="Built by Maven" src="../../images/logos/maven-feather.png" />
+      </a>
+                </div>
+        </div>
+      </div>
+      
+      <div id="bodyColumn" class="content">
+        <div id="contentBox">
+                              
+          <!-- 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 --><div class="section"><h2>Using REST Services<a name="Using_REST_Services"></a></h2><p>Starting version 1.4, you can use some REST Services to manage your Apache Archiva instance and Search artifacts. All samples here will use Apache CXF REST client API. By the way you can use some others REST client frameworks. NOTE: a wadl is available in your Archiva instance : http(s)://ip:port/../restServices/application.wadl</p><div class="section"><h3>Search Service<a name="Search_Service"></a></h3><p>Authentication headers for connect to your Archiva instance :</p><div class="source"><pre class="prettyprint">    // guest with an empty password
+    public String guestAuthzHeader =
+        &quot;Basic &quot; + org.apache.cxf.common.util.Base64Utility.encode( ( &quot;guest&quot; + &quot;:&quot; ).getBytes() );
+
+    // with an other login/password
+    //public String authzHeader =
+    //    &quot;Basic &quot; + org.apache.cxf.common.util.Base64Utility.encode( ( &quot;login&quot; + &quot;:password&quot; ).getBytes() );
+
+</pre></div><p>Get a Search Service Client :</p><div class="source"><pre class="prettyprint">        SearchService service =
+            JAXRSClientFactory.create( getBaseUrl() + &quot;/&quot; + getRestServicesPath() + &quot;/archivaServices/&quot;,
+                                       SearchService.class );
+
+        if ( authzHeader != null )
+        {
+            WebClient.client( service ).header( &quot;Authorization&quot;, authzHeader );
+        }
+        WebClient.getConfig( service ).getHttpConduit().getClient().setReceiveTimeout( 100000000 );
+        return service;
+</pre></div><p>Quick Search</p><div class="source"><pre class="prettyprint">List&lt;Artifact&gt; artifacts = searchService.quickSearch( &quot;commons-logging&quot; );
+// return all artifacts with groupId OR artifactId OR version OR packaging OR className
+// NOTE : only artifacts with classifier empty are returned
+</pre></div><p>Search Artifacts Version : to search all availables version with a groupId and artifactId and packaging (if empty jar is used)</p><div class="source"><pre class="prettyprint">        SearchService searchService = getSearchService( authorizationHeader );
+
+        List&lt;Artifact&gt; artifacts = searchService.getArtifactVersions( &quot;commons-logging&quot;, &quot;commons-logging&quot;, &quot;jar&quot; );
+
+</pre></div><p>Search Service with a classifier :</p><div class="source"><pre class="prettyprint">        SearchRequest searchRequest = new SearchRequest();
+        searchRequest.setGroupId( &quot;commons-logging&quot; );
+        searchRequest.setArtifactId( &quot;commons-logging&quot; );
+        searchRequest.setClassifier( &quot;sources&quot; );
+
+        List&lt;Artifact&gt; artifacts = searchService.searchArtifacts( searchRequest );
+</pre></div><p>Search Service with a classifier :</p><div class="source"><pre class="prettyprint">        SearchRequest searchRequest = new SearchRequest();
+        searchRequest.setGroupId( &quot;commons-logging&quot; );
+        searchRequest.setArtifactId( &quot;commons-logging&quot; );
+        searchRequest.setClassifier( &quot;sources&quot; );
+
+        List&lt;Artifact&gt; artifacts = searchService.searchArtifacts( searchRequest );
+</pre></div><p>Copy Artifact from a repository to an other one :</p><p>For some reasons you want to use a test repository before moving your artifacts to a repository used by final users. To achieve this, you can use a service which can copy an artifact from a repository to an other one</p><div class="source"><pre class="prettyprint">// configure the artifact you want to copy
+// if package ommited default will be jar
+ArtifactTransferRequest artifactTransferRequest = new ArtifactTransferRequest();
+artifactTransferRequest.setGroupId( &quot;org.apache.karaf.features&quot; );
+artifactTransferRequest.setArtifactId( &quot;org.apache.karaf.features.core&quot; );
+artifactTransferRequest.setVersion( &quot;2.2.2&quot; );
+artifactTransferRequest.setRepositoryId( SOURCE_REPO_ID );
+artifactTransferRequest.setTargetRepositoryId( TARGET_REPO_ID );
+// retrieve the service
+RepositoriesService repositoriesService = getRepositoriesService( authorizationHeader );
+// copy the artifact
+Boolean res = repositoriesService.copyArtifact( artifactTransferRequest );
+</pre></div><p>To know all the possible options, you can refer to the javadoc of SearchRequest class.</p><p>Dependencies to add in order to use those REST Services</p><div class="source"><pre class="prettyprint">
+    &lt;dependency&gt;
+      &lt;groupId&gt;org.apache.archiva&lt;/groupId&gt;
+      &lt;artifactId&gt;archiva-rest-api&lt;/artifactId&gt;
+      &lt;version&gt;1.4-M2
+    &lt;/dependency&gt;
+
+    if you use CXF:
+
+    &lt;dependency&gt;
+      &lt;groupId&gt;org.apache.cxf&lt;/groupId&gt;
+      &lt;artifactId&gt;cxf-bundle-jaxrs&lt;/artifactId&gt;
+      &lt;version&gt;2.4.2&lt;/version&gt;
+      &lt;exclusions&gt;
+        &lt;exclusion&gt;
+          &lt;groupId&gt;org.eclipse.jetty&lt;/groupId&gt;
+          &lt;artifactId&gt;jetty-server&lt;/artifactId&gt;
+        &lt;/exclusion&gt;
+      &lt;/exclusions&gt;
+    &lt;/dependency&gt;
+</pre></div></div><div class="section"><h3>Security Framework Services:<a name="Security_Framework_Services:"></a></h3><p>You can use Redback Rest Services to control user creation/modification and add/remove roles.</p><p>See <a class="externalLink" href="http://redback.codehaus.org/integration/rest.html">http://redback.codehaus.org/integration/rest.html</a></p></div></div>
+                  </div>
+      </div>
+    </div>
+
+    <footer class="footer">
+            <div class="container-fluid">
+              <div class="row span16">Copyright &copy;                    2006-2011
+                        <a href="http://www.apache.org/">The Apache Software Foundation</a>.
+            All Rights Reserved.      
+                
+      </div>
+
+                      </div>
+    </footer>
+  </body>
+</html>