This page last changed on May 26, 2009 by jlargman.

In general, you can configure system properties by providing an argument of -Dprop=value to a Java program when it starts up.

Because Confluence is a Java web application, the Java program is typically your application server. Therefore, you need to configure system properties in your application server's start-up script.

Below is a general example of how system properties are configured for any Java application. The system property arguments can appear anywhere in the argument list.

java ... -Dhttp.proxyHost=proxy.example.org -Dhttp.proxyPort=8080

The above example configures two system properties: http.proxyHost and http.proxyPort with values proxy.example.org and 8080 respectively.

Sometimes instructions will say simply 'set system property X', without saying what it should be set to. In this case, it is usually sufficient to simply use -Dprop, without a value. For example:

java ... -Datlassian.mail.disable

Application Server Examples

Please consult your application server documentation for how to provide system properties to the Java runtime or to a particular application server.

Below are some examples of how to start up different application servers with these system properties set:

AppServer Startup Script Variable to Edit Example
Confluence Stand-alone .zip or .tar.gz Distribution
bin\setenv.bat (Windows)
bin/setenv.sh (Unix, Linux OS X)
JAVA_OPTS set JAVA_OPTS=-Dhttp.proxyHost=proxy.example.com -Dhttp.proxyPort=3128 (Windows)
export JAVA_OPTS="-Dhttp.proxyHost=proxy.example.com -Dhttp.proxyPort=3128" (Unix)
Tomcat Windows Service n/a n/a See below
Tomcat .war installation
bin\catalina.bat (Windows)
bin/catalina.sh (Unix)
JAVA_OPTS
set JAVA_OPTS=%JAVA_OPTS% -Dhttp.proxyHost=proxy.example.com -Dhttp.proxyPort=3128 (Windows)
export JAVA_OPTS="-Dhttp.proxyHost=proxy.example.com -Dhttp.proxyPort=3128" (Unix)
Weblogic $BEA_HOME/domain/<domain>/startWebLogic.sh JAVA_OPTIONS export JAVA_OPTIONS="$JAVA_OPTIONS -Dhttp.proxyHost=proxy.example.com -Dhttp.proxyPort=3128"
JBoss bin/run.sh JAVA_OPTS export JAVA_OPTS="-Dhttp.proxyHost=proxy.example.com -Dhttp.proxyPort=3128"
WebSphere n/a Application Server > Process Definition > JVM Arguments -Dhttp.proxyHost=proxy.example.com -Dhttp.proxyPort=3128

Configuring System Properties in Tomcat as a Windows Service

Defining JAVA_OPTS in your setenv.bat file will not be sufficient to configure system properties if you are running Confluence with Tomcat as a Windows Service. Rather, there are two ways to configure system properties:

  • through the Tomcat configuration application, normally found in the Windows system tray
  • updating the service configuration directly in your Windows Registry.

As an example of the latter, for Tomcat 5 you will need to modify HKEY_LOCAL_MACHINE -> SOFTWARE -> Apache Software Foundation -> Procrun 2.0 -> Tomcat5 -> Parameters -> Java -> Options and add the JAVA_OPTS parameter there with the necessary system properties. JvmMx and JvmMs are listed separately from the additional options. See Editing the Windows Registry for details.

Displaying the System Properties

To see what Confluence is using, check Displaying System Properties.

RELATED TOPICS

Recognised System Properties

Document generated by Confluence on Nov 05, 2009 23:26