svn commit: r508867 - /maven/archiva/trunk/archiva-site/src/site/apt/guides/security-configuration.apt

[ws...@apache.org]

Author: wsmoak
Date: Sat Feb 17 21:07:10 2007
New Revision: 508867

URL: http://svn.apache.org/viewvc?view=rev&rev=508867
Log:
Document external user database configuration.
MRM-283

Modified:
    maven/archiva/trunk/archiva-site/src/site/apt/guides/security-configuration.apt

Modified: maven/archiva/trunk/archiva-site/src/site/apt/guides/security-configuration.apt
URL: http://svn.apache.org/viewvc/maven/archiva/trunk/archiva-site/src/site/apt/guides/security-configuration.apt?view=diff&rev=508867&r1=508866&r2=508867
==============================================================================
--- maven/archiva/trunk/archiva-site/src/site/apt/guides/security-configuration.apt (original)
+++ maven/archiva/trunk/archiva-site/src/site/apt/guides/security-configuration.apt Sat Feb 17 21:07:10 2007
@@ -81,7 +81,48 @@
  
 * 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:
 
- * {{{http://docs.codehaus.org/display/MAVENUSER/Archiva+User+DB+on+Derby+Network+Server}
-   Archiva User DB on Derby Network Server}}
++------+
+<!--
+     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>
++------+
+
+ 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}}