summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorWendy Smoak <wsmoak@apache.org>2007-02-18 05:07:10 +0000
committerWendy Smoak <wsmoak@apache.org>2007-02-18 05:07:10 +0000
commitf411740be0ecb73527c9e894a9d25d10f746fc52 (patch)
tree055aa050026ba3b79fdd9d1fc5afe7fd533658b8
parent2dc525f1c395b47b42ca2d8ea8091e707f8dc1b9 (diff)
downloadarchiva-f411740be0ecb73527c9e894a9d25d10f746fc52.tar.gz
archiva-f411740be0ecb73527c9e894a9d25d10f746fc52.zip
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
-rw-r--r--archiva-site/src/site/apt/guides/security-configuration.apt47
1 files changed, 44 insertions, 3 deletions
diff --git a/archiva-site/src/site/apt/guides/security-configuration.apt b/archiva-site/src/site/apt/guides/security-configuration.apt
index 1a6edc847..9ac74fcb5 100644
--- 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}}