From: Maria Odea B. Ching <oching@apache.org>
Date: Thu, 10 Jun 2010 03:28:03 +0000 (+0000)
Subject: [MRM-1373] Archiva fails when default charset in database is UTF 8
X-Git-Tag: archiva-1.3.1~4
X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=4e63f6923aeb374ab9766b8b6bf92e5ed8feafc8;p=archiva.git

[MRM-1373] Archiva fails when default charset in database is UTF 8
submitted by Gwen Harold Autencio

o added documentation for the workaround, which is to set the character encoding to UTF-8 after the database has been created


git-svn-id: https://svn.apache.org/repos/asf/archiva/branches/archiva-1.3.x@953209 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/archiva-docs/src/site/apt/adminguide/databases.apt b/archiva-docs/src/site/apt/adminguide/databases.apt
index cd56a98fd..149df5168 100644
--- a/archiva-docs/src/site/apt/adminguide/databases.apt
+++ b/archiva-docs/src/site/apt/adminguide/databases.apt
@@ -32,6 +32,9 @@ Apache Archiva Databases
   By default the archiva and users databases are stored in the <<<databases>>> directory where Archiva is installed. To change the
   path, just edit all instances of the "DatabaseName" property in <<<conf/jetty.xml>>> (see below). 
 
+  <<Note:>> If you are using MySQL as your database, Archiva fails when the users database created is initially set to UTF-8 for the character encoding. 
+  As a workaround, set the database to UTF-8 encoding after it has been populated. See {{{http://jira.codehaus.org/browse/MRM-1373} MRM-1373}} for more details.
+
 +------+
 ...
 <New id="archiva" class="org.mortbay.jetty.plus.naming.Resource">