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.
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:
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 |
| Tomcat |
bin\setenv.bat (Windows)
bin/setenv.sh (Unix) |
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 Service |
n/a |
n/a |
See below. |
| 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.
RELATED TOPICS
Recognised System Properties
Configuring System Properties
Add Comment