This page last changed on Feb 16, 2006 by mryall.
 | Old documentation
This documentation is for old versions prior to Confluence 2.0. For the latest documentation see the Confluence Installation Guide. |
You will need
- A Java Application Server, as described in the Requirements
- To know how to install and configure your application server. If you do not, we suggest you download Confluence Standalone instead.
- (Optional) A database, as described in the Requirements
Installing the WAR version is a piece of cake:
- Unzip the Confluence WAR zip that you have downloaded
- Find the confluence folder in this unpacked distribution and copy this over to the webapps directory of your application server (assuming you are using tomcat and resin).
- Edit the confluence-init.properties file in the webapps\confluence\WEB-INF\classes directory and set the confluence.home property to a directory of your choice. This directory is where Confluence will store it's configuration information, indexes and attachments.
- Restart your webserver if necessary.
- Point your browser at www.mydomain.com/confluence where mydomain is your website domain. You should see the Confluence Setup Wizard!
Unix without X11
On some Java installations (i.e. Unix without X11), you need to pass an additional parameter to Java when you are starting up to tell it how to use its image-manipulation libraries.
To get thumbnail support working in this configuration, you need to start java with the argument '-Djava.awt.headless=true'. If you are using tomcat (or the Confluence standalone edition), try setting the environment variable JAVA_OPTS before starting the server. Assuming you're using the bourne or bash shell:
export JAVA_OPTS=-Djava.awt.headless=true
Alternatives to confluence-init.properties
 | This is an advanced note for experienced Java application server administrators. If you do not know how to set system properties or edit web.xml in your application server, we recommend you stick with editing confluence-init.properties as described above. |
If you wish to deploy the WAR directly into an application server (or several application servers), you may want to skip the step of exploding the WAR file.
Confluence needs one piece of information in order to get running: the location of the confluence.home directory in which it should save its configuration files and other data. It obtains this information by looking at the following three places (in order):
- System properties (i.e. start the application with -Dconfluence.home=/path/to/your/confluence/home)
- confluence-init.properties (i.e. follow the procedure above)
- Servlet context (i.e. customise the web.xml deployment descriptor to include a <context-param> called confluence.home)
The first not-null value Confluence finds will be used as the confluence home.
So, if your application server supports the easy editing of system properties or servlet context parameters when deploying an application, you may want to use one of these methods instead of editing confluence-init.properties
How about how to set up DB access?
And why not have a war build script like Jira?

Posted by chrome at Mar 07, 2004 21:09
|
Database access is configured from the setup wizard after installation is complete.

Posted by cmiller at Mar 07, 2004 22:05
|
Deploying a WAR to Weblogic fails due to it not being able to load a resource (it looks like a SiteMesh CL problem)

Posted by noahcampbell at Mar 16, 2004 12:30
|
Anyone added Confluence to Orion successfully?

Posted by jon_cheyne at Mar 19, 2004 08:41
|
Worked for me with JBoss 3.2.3 and Postgres (On RHEL 3.0), but you need the Postgres driver from http://jdbc.postgresql.org/download.html (thanks Dave Loeng at Atlassian for helping me out!)

Posted by simonc@amphora-research.com at May 13, 2004 04:04
|
Jon: confluence.atlassian.com is running on Orion, so I'd say that's a definite Yes. 

Posted by cmiller at May 13, 2004 05:57
|
tomcat hint:
use a context xml file in tomcat webapps to simplify tomcat, and confluence updates.
Put this is in a file confluence.xml:
<Context path="/confluence" docBase="/export/home/web/webapps/confluence"
debug="0" >
</Context>

Posted by valentinedwv at Jun 09, 2004 13:01
|
not working on websphere 5.0.x only works on containers running java 1.4 or better, depends on java.lang.CharSequence unfortunately.

Posted by at Jul 08, 2004 16:03
|
DB Access to Oracle9 via JNDI on Tomcat 5 should be as easy as this:
1. Add oracle jdbc driver to CATLINA_HOME/common/lib, Install as above, Restart server
2. Using Tomcat Admin add a JNDI datasource (e.g. jdbc/ConfDS ) to the confluence context using tested connection parameters, Save and Commit the changes
3. Access confluence, and point the Setup Datasource Connection to jdbc/ConfDS Datasource Name and the Oracle 9 dialect
But it fails with "Could not lookup datasource successfully". Why should I not expect this to succeed?

Posted by cardenizen at Aug 10, 2004 09:13
|
There should be a chmod 777 on the confluence folder in step 4.

Posted by jonas at Sep 09, 2004 09:17
|
anyone successfully follow the above in an os x 10.3 xserve environment with jboss?

Posted by at Sep 17, 2004 00:15
|
Looks like you might need to be careful with MySQL if you have InnoDB set as the default table type. The FK Indexes that the setup wizard creates were not unique in my install. May very well be a hibernate issue more than a Confluence issue.

Posted by at Oct 27, 2004 15:40
|
Not sure what I am missing. Java… Check… Servlet… check. Confluence Home directory parameter specified: fails.
WEB-INF/classes/confluence-init.properties is set to confluence.home=e:
confluenceHome , a created directory with full permissions. Using Windows XP Pro.

Posted by carl at Nov 24, 2004 14:57
|
Failed under JBoss 4.0?

Posted by tifa at Mar 06, 2005 01:00
|
Oh, I meet this error too, my server is Weblogic 8

Posted by at Jul 22, 2005 05:55
|
Is it possible to integrate confluence as a uPortal servlet ? As anybody ever seen this ?
I tried & i tried but it doesn't work !! Please help me

Posted by at Aug 01, 2005 08:42
|
I'm interested in too !!!
Can anybody answer it ???
Thank you in advance

Posted by at Aug 04, 2005 09:50
|
We have not taken a look at uPortal servlets yet. Please feel free to add this as an integration suggestion at http://jira.atlassian.com.
Cheers,
Dave

Posted by dave@atlassian.com at Aug 04, 2005 11:51
|
To finally make run Confluence 1.4.4 with WebLogic 8.1 SP3.
We had to:
1/ Deploy Confluence as an EXPLODED war!
2/ CHMOD 777 the confluence home dir.
3/ Enter confluence.
4/ Not choose the standart installation but the CUSTOM (Otherwise We get a SQL error: duplicate index, and the setup finished in an invalid state: no user, no admin!)
5/ Choose the embedded database.
6/ Not install the default demo site but restore a site from a backup (A backup I got from a local confluence running on Resin)!
That's may be not the only way to get it up and runing but at least it can help those who just wants to get it deployed for development and testing purpose under WebLogic.

Posted by olivier.david at Aug 24, 2005 06:38
|
If Confluence is developed like we develop our applications, I think the first problem might be that when you deploy a .war packaged application in WebLogic, ServletContext.getRealPath(path) does not return a value, and if you depend on that to find some configuration files, then it breaks. Resin, Tomcat and Orion unpackage the .war files and return the "unpackaged" path to you, but WebLogic does not, and that's why it fails.
That's one the reason we don't deploy our applications as .war files, along with details like being able to update a simple .css or .gif without having to restart the whole context .
Please note that the servlet specification allows containers to do that, returning null from getRealPath(path), so WebLogic behaviour is "correct" in that sense.
But of course it might not be the problem, it's just an assumption .

Posted by at Sep 30, 2005 03:21
|
|