This page last changed on Mar 14, 2007 by david.soul@atlassian.com.
This install guide is for users running Windows, Solaris, Unix or Linux. OS X users should use this document instead.
Notes
STAGE 1 - Install The Java Developers Kit
Do you already have the Java Developers Kit 1.4 or newer installed?
JDK 1.5 Or Earlier
You must confirm the JDK is installed correctly:
- Open a command prompt. On Windows this is done by opening your Start menu and selecting Run, then typing cmd and pressing OK
- In the command prompt, type echo %JAVA_HOME% and press Enter
If a line is printed such as C:\Progra~1\Java\jdk1.5.0_06 with the last two letters being dk, the JDK is installed. If nothing is printed, or the last two letters in the path are not dk, click the 'No, or unsure' instructions and follow those
- Users who have installed a non-Sun JDK must install the Sun JSSE package
- Go to STAGE 2
JDK Unknown or Not Installed
Install the JDK:
- Download JDK 1.5_08 to the Confluence server
- Once downloaded, run the installer. At one point, you will be asked to choose a directory to install to. Copy or write this directory down for use later
- Windows users follow these instructions to set your JAVA_HOME environment variable to the directory you just installed the JDK in. The default directory is under C:\Program Files\Java
- Go to STAGE 2
STAGE 2 - Download & Unzip Confluence
Select your operating system:
Windows
- The default Windows unzipper cannot unzip Confluence
If you have already unzipped Confluence using the default Windows unzip, delete the directory created now
- You will need a third-party unzip program like 7Zip or Winzip. If you do not have one, download and install one before continuing:
- 7Zip Recommended. If in doubt, download the '32-bit .exe' version
- Winzip
- If you have not downloaded Confluence already, download the Standalone zip
- Use your unzip program to unzip the install file to a directory such as c:\confluence, avoiding directories with spaces. To make upgrades easier, Windows users should aim to create a directory structure like below:
c:\confluence\confluence-2.2.10-std <-- Install directory, unzipped now
c:\confluence\data <-- Home directory, created next
You have now created your install directory. This is the directory where you unzipped Confluence, for example c:\confluence\confluence-2.2.10-std
- Go to STAGE 3
Unix, Linux or Solaris
- Install these X11 libraries
- If you have not downloaded Confluence already, download the Standalone zip
- Use your unzip program to unzip the install file to a directory such as c:\confluence, avoiding directories with spaces. Linux or Unix users can use any unzip program to unzip Confluence, but Solaris users must use GNU Tar instead of Solaris Tar
You have now created your install directory. This is the directory where you unzipped Confluence, for example c:\confluence\confluence-2.2.10-std
- Go to STAGE 3
STAGE 3 - Set Your Home Directory
This stage creates a Home directory where Confluence will store it's configuration information, indexes and attachments.
- Open your Confluence install directory
- Under the install directory, find \confluence\WEB-INF\classes\confluence-init.properties|
|
- Open the file confluence-init.properties in a text editor such as Notepad
- Scroll to the bottom and find the line
# confluence.home=c:/confluence/data
- Remove the '#' and the space at the front of this line to uncomment it. It should now begin with confluence.home
- Choose what your Home directory will be. Windows users should use the default c:\confluence\data for simplicity but you can chose any directory that does not contain a space in the path
- If you are using a different Home directory from c:\confluence\data, edit the line now. Windows users must use / characters to separate each directory in the path. Linux users should specify Home using the absolute path instead of a symbolic link
Windows users can save the Home directory as the default by saving the line as
confluence.home=c:/confluence/data
You have now set your Home directory.
STAGE 4 - Review Release Notes
Review the Release Notes for your Confluence version and apply any patches listed.
STAGE 5 - Start Confluence
To start Confluence for the first time,
- Go to your install directory
- Under your install directory, open the bin directory and run the startup script. Windows users run \bin\startup.bat while users with other operating systems run /bin/startup.sh|
|
If the window closes immediately when started, click here for assistance
An error is preventing Confluence from starting. To view this error:
1. Open a command prompt. On Windows, do this by clicking on your Start menu, then click Run. In the Run box, type cmd and press OK
3. From the command prompt, go to your Confluence install directory
4. Go into the bin subdirectory
5. Run startup.bat and read the error message
6. Find the solution to that error in the Troubleshooting section
- Once Confluence is running, open a web browser and visit http://localhost:8080/
The Confluence Setup Wizard should appear for you to enter your licence key. If the address shows an error, check the Troubleshooting section
NEXT STEP
Proceed to the Confluence Setup Wizard Guide
TROUBLESHOOTING
Solutions to common issues with installing Confluence. Click on a problem to show the solution.
Confluence window closes immediately when started
An error is preventing Confluence from starting.
- Open a command prompt. On Windows, do this by clicking on your Start menu, then click Run. In the Run box, type cmd and press OK
- From the command prompt, go to your Confluence install directory
- Go into the bin subdirectory
- Run startup.bat and read the error message
- Find the solution to that error below
Confluence won't start - java.lang.NoClassDefFoundError IntraHibernateAttachmentCopier
If you are seeing "java.lang.NoClassDefFoundError: com/atlassian/confluence/pages/persistence/dao/hibernate/AbstractHibernateAttachmentDao$IntraHibernateAttachmentCopier", you have unzipped Confluence using a program that cannot handle long filenames. You must delete your install directory and go back to the point in the instructions that covers unzipping Confluence using a third-party unzip program.
Confluence won't start - Error creating Confluence Home directory
The confluence.home variable specified in confluence-init.properties cannot be created. To fix this, edit /confluence/WEB-INF/classes/confluence-init.properties and check the path specified exists. Make sure all the directory slashes use / and that the # has been removed. If you're stuck, try using confluence.home=c:/confluence/data
Confluence won't start - JAVA_HOME environment variable is not defined correctly
You have not installed the Java Development Kit, or not set the %JAVA_HOME% to the directory of the JDK. You should re-check your steps in Stage 2.
Confluence won't start - Port 8080 is in use
If you have another Tomcat running on the same machine, you must edit <INSTALL>/conf/server.xml and change both 8080 and 8005 to ports that do not conflict with your other Tomcat instance according to these instructions.
Confluence won't start - Error creating bean with name 'scheduler'
Confluence won't start - Error registering bean with name 'fileSystemAttachmentDataDao'
If you did not use one of the recommended unzipping tools, and happened to use for instance the default Windows XP extractor, one of the classes required for starting up Confluence may not be located due to the lengthy file-path. This is due to the reason that the default Windows tool silently fails to extract files with long names. We suggest you to use other tools such as WinZIP and 7zip and redo the deployment process.
Cause:
org.springframework.beans.factory.BeanDefinitionStoreException: Error registering bean with name 'fileSystemAttachmentDataDao' defined in class path resource applicationContext.xml: Class that bean class com.atlassian.confluence.pages.persistence.dao.FileSystemAttachmentDataDao depends on not found; nested exception is java.lang.NoClassDefFoundError: com/atlassian/confluence/pages/persistence/dao/FileSystemAttachmentDataDao$FileSystemAttachmentNamingStrategy
at org.springframework.beans.factory.xml.DefaultXmlBeanDefinitionParser.parseBeanDefinition(DefaultXmlBeanDefinitionParser.java:366)
caused by: java.lang.NoClassDefFoundError: com/atlassian/confluence/pages/persistence/dao/FileSystemAttachmentDataDao$FileSystemAttachmentNamingStrategy
at java.lang.Class.forName0(Native Method)
Confluence starts but localhost:8080 times out
Check the server logs for errors. If you are running Confluence Standalone on Windows, error messages will be printed to the console window that opened when you ran startup.bat. On Unix systems, Confluence will log messages to logs/catalina.out.
Confluence starts but localhost:8080 goes to Tomcat start homepage
The CATALINA_HOME environment variable is set to another instance of Tomcat. You should run shutdown.sh, remove the CATALINA_HOME reference to the other Tomcat version, and run startup.sh again.
Confluence starts but logins fail at login screen
If you try to login with the correct username and password but are always returned to the login screen without any error messages, and you are running Zone Alarm, please check that it is not blocking the Confluence server
Change listen port for Confluence Standalone
Adding SSL on Confluence 2.1.5a and earlier
Confluence Setup Guide
Configuration Guide
Documentation Home
Stage 2, Unix/Linux section, step 3 mentions windows type of path. In reality it'll most likely to be /opt/confluence or /home/confluence/

Posted by andrek at Mar 07, 2007 19:59
|
|