This page last changed on Oct 17, 2006 by david.soul@atlassian.com.
Reasons For Hosting Confluence As A Service
If you are hosting Confluence on a Windows-based server, installation as a Windows Service offers these advantages:
- Automated Confluence recovery after server restart
- Improved troubleshooting through logging server output to file
Installing Confluence Standalone As A Service
From your Windows-based server running Confluence 1.5 or earlier:
- Open a DOS prompt
- Set the CATALINA_HOME variable to the Confluence Standalone root directory (that containing the bin and confluence director):
C:\> set CATALINA_HOME=c:\progra~1\confluence-1.3.5-standalone
If a directory in the path has spaces (eg. 'C:\Program Files\..'), please convert it to its eight-character equivalent.
- Ensure the JAVA_HOME variable is set to the JDK base directory, with echo %JAVA_HOME%.
- Run the following command, all on one line (or download it):
"%CATALINA_HOME%\bin\tomcat.exe" -install Confluence
"%JAVA_HOME%\jre\bin\server\jvm.dll"
-Djava.class.path="%CATALINA_HOME%\bin\bootstrap.jar;%JAVA_HOME%\lib\tools.jar"
-Dcatalina.home="%CATALINA_HOME%" -Xms128m -Xmx256m
-start org.apache.catalina.startup.BootstrapService
-params start -stop org.apache.catalina.startup.BootstrapService -params stop -out
"%CATALINA_HOME%\logs\stdout.log" -err "%CATALINA_HOME%\logs\stderr.log"
Once you've run this command successfully, you can start Confluence by running the following command
C:\> net start Confluence
Alternatively you can pull up the Windows Services page and start the service from there.
 |
You will need to ensure that the %CATALINA_HOME%*, index and database directories are all writeable by the user the service is running as.
Confluence should now be installed as a service, but will not automatically start up until the next server reboot. |
The Confluence service can be uninstalled with:
"%CATALINA_HOME%\bin\tomcat.exe" -uninstall Confluence
|