====== Confluence ======

===== [[http://confluence.atlassian.com/display/DOC/Installing+Confluence+EAR-WAR+on+Tomcat|Installation]] =====

  * Download and unpack Confluence into temporary directory:
    <code console>
# wget -nv http://www.atlassian.com/software/confluence/downloads/binary/confluence-3.2.1_01.tar.gz
# tar -xzf confluence-3.2.1_01.tar.gz
</code>
  * Setup the local storage:
    <code diff|confluence-init.properties>
--- confluence-3.0.0_01/confluence/WEB-INF/classes/confluence-init.properties.orig	2009-06-01 16:10:19.000000000 +0200
+++ confluence-3.0.0_01/confluence/WEB-INF/classes/confluence-init.properties	2009-06-05 11:44:22.997782473 +0200
@@ -31,4 +31,4 @@
 
 # specify your directory below (don't forget to remove the '#' in front)
 
-# confluence.home=c:/confluence/data
\ No newline at end of file
+confluence.home=/usr/local/confluence
</code>
  * Build a package: ''cd confluence-3.2.1_01 && ./build.sh && mkdir -p /usr/local/confluence && mv dist/confluence-3.2.1_01.war /usr/local/confluence && cd /usr/local/confluence''
  * Create context descriptor ''/usr/local/confluence/confluence.xml'':
    <code xml|confluence.xml>
<Context path="/confluence" docBase="/usr/local/confluence/confluence-3.2.1_01.war" debug="0" reloadable="true">
	<Resource name="jdbc/ConfluenceDS" auth="Container"
		type="javax.sql.DataSource"
		username="confluence"
		password="***"
		driverClassName="com.mysql.jdbc.Driver"
		url="jdbc:mysql://localhost/confluence_db?useUnicode=true&amp;characterEncoding=UTF8"
		maxActive="20"
		validationQuery="select 1" />

	<Resource name="UserTransaction" auth="Container"
		type="javax.transaction.UserTransaction"
		factory="org.objectweb.jotm.UserTransactionFactory"
		jotm.timeout="60" />

	<Manager className="org.apache.catalina.session.PersistentManager" saveOnRestart="false" />
</Context>
</code>
  * Tune file permissions:
    <code console>
# cd /usr/local/confluence
# chown tomcat6.www -R .
# chmod a-w,o-rwx -R .
# chmod 750 .
</code>
  * Configure tomcat to start Confluence application:
    <code console>
# cd /usr/share/tomcat6/conf/Catalina/localhost
# ln -s /usr/local/confluence/confluence.xml
</code>


==== Problems ====

=== [[http://confluence.atlassian.com/display/CONF29/Fix+%27Not+supported+by+BasicDataSource%27+Setup+or+Startup+Error|Cannot setup Confluence connection via DS due to UnsupportedOperationException]] ===

<note tip>Fix ''confluence.cfg.xml'' in Confluence root directory as mentioned in FAQ and restart Tomcat.</note>