Document external user database configuration.

MRM-283

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

diff --git a/archiva-site/src/site/apt/guides/security-configuration.apt b/archiva-site/src/site/apt/guides/security-configuration.apt
index 1a6edc8473ecee0ef4b30df44d75e6c1ef29ba8b..9ac74fcb5a62b119b0de26b6a34eef52192932fd 100644 (file)
--- a/archiva-site/src/site/apt/guides/security-configuration.apt
+++ b/archiva-site/src/site/apt/guides/security-configuration.apt
@@ -81,7 +81,48 @@ security.policy.password.rule.nowhitespace.enabled=true
  
 * Database
 
- TODO
+ By default, Archiva uses embedded {{{http://db.apache.org/derby}Apache Derby}}
+ to store the user information. It can be configured to use an external database
+ by providing a JDBC driver and editing the <<<plexus.xml>>> file.
+ 
+ [[1]] Place the jar containing the JDBC driver in <<<$ARCHIVA_HOME/core>>>.
+ 
+ [[2]] Edit <<<$ARCHIVA_HOME/conf/plexus.xml>>>, providing the JDBC driver class
+ name, and the database url, username, and password.
+    
+ []
+ 
+ For example:
+
++------+
+<!--
+     Datasources
+-->
+<resource>
+  <name>jdbc/users</name>
+  <type>javax.sql.DataSource</type>
+  <properties>
+    <property>
+      <name>driverClassName</name>
+      <value>org.apache.derby.jdbc.ClientDriver</value>
+    </property>
+    <property>
+      <name>url</name>
+      <value>jdbc:derby://localhost:1527/archiva-users;create=true</value>
+    </property>
+    <property>
+      <name>username</name>
+      <value>user1</value>
+    </property>
+    <property>
+      <name>password</name>
+      <value>user1</value>
+    </property>
+  </properties>
+</resource>
++------+
 
- * {{{http://docs.codehaus.org/display/MAVENUSER/Archiva+User+DB+on+Derby+Network+Server}
-   Archiva User DB on Derby Network Server}}
+ More information about using Derby Network Server as an external user database
+ for Archiva can be found on the wiki:
+ {{{http://docs.codehaus.org/display/MAVENUSER/Archiva+User+DB+on+Derby+Network+Server}
+ Archiva User DB on Derby Network Server}}