Apache Geronimo v3.0 Documentation: System Properties

{scrollbar}

The tables below list various system level properties supported by the Geronimo server. These properties can be set using the GERONIMO_OPTS environment variable or using the etc/system.properties configuration file.

To set a given system property using the GERONIMO_OPTS environment variable use the following commands:

On a Windows system set GERONIMO_OPTS=-D<OptionClass>=<value>
On a Linux/Unix system export GERONIMO_OPTS=-D<OptionClass>=<value>

General System Properties

OptionClass	Value	Default	Description
org.apache.geronimo.deployment.LenientMFCP	true, false	false	Specifies lenience vs. strict manifest classpath interpretation. Specify true for more lenient processing such as ignoring missing jars and references that are not spec compliant.
org.apache.geronimo.deployment.util.DeploymentUtil.jarUrlRewrite	true, false	false	Prevents the lockout of archive during deployment, instead of returning a jar url, write the content to a temp file and return the url of that file.
org.apache.geronimo.gbean.NoProxy	true, false	true	Specifies whether to use fast proxy to access GBean. If not, reflection is used.
org.apache.geronimo.kernel.config.Marshaler		org.apache.geronimo.kernel.config.SerializedConfigurationMarshaler	Specifies the configuration marshaler class.
org.apache.geronimo.kernel.config.MPCLSearchOption	safe, optimized	safe	Specifies classLoaderSearchMode of the MultiParentClassLoader.
org.apache.geronimo.jacc.policy.provider		Policy provider of the JRE	Specifies the classname of the JACC policy provider. Must be a subclass of java.security.Policy.
org.apache.geronimo.config.file			Specifies the location of server config file.
org.apache.geronimo.config.substitutions.file			Specifies the location of server config substitutions file.
org.apache.geronimo.config.substitution.prefix		org.apache.geronimo.config.substitution	Specifies the prefix used to specify config substitutions. Users can specify a (key, value) to override the properties set in the config substitutions file. For example, an entry such as hostName=localhost can be overridden by setting `-Dorg.apache.geronimo.config.substitution.hostName=foo` when the prefix is `org.apache.geronimo.config.substitution`.
org.apache.geronimo.home.dir			Specifies server installation directory.
org.apache.geronimo.server.dir			Specifies the base directory of a server instance.
org.apache.geronimo.server.name			Specifies the name of a server instance, used to construct a base directory as a sub-directory of the server installation when `org.apache.geronimo.server.dir` is not specified.
org.apache.geronimo.repository.boot.path			Specifies the path of the server repository.
org.apache.geronimo.tomcat.GeronimoStandardContext.allowLinking	true, false	false	The option is for Tomcat assembly only. If the value of this flag is true, symlinks will be allowed inside the web application, pointing to resources outside the web application base path. If not specified, the default value of the flag is false.
org.apache.geronimo.webapplication.stage	development, production	production	If set to `development` the contents of a web module will be extracted on disk. This enables tooling to make faster updates to the application.
org.apache.geronimo.equinox.useURLClassLoader	true, false	false	If true, the module classloader will extend the URLClassLoader.

Web Services System Properties

OptionClass	Value	Default	Description
org.apache.geronimo.jaxws.wsgen.addToClassPath	true, false	true	Controls whether the wsgen generated classes should be added to the module classpath. By default, the generated classes will be added to the module classpath.
org.apache.geronimo.jaxws.wsgen.fork	true, false	true on Windows false on other OS
org.apache.geronimo.jaxws.wsgen.fork.timeout		1000 * 60 (microseconds)
org.apache.geronimo.jaxws.builder.useSimpleFinder	true, false	not set	Uses `org.apache.geronimo.jaxws.builder.SimpleWARWebServiceFinder` to locate WebServiceInfo objects, otherwise use `org.apache.geronimo.jaxws.builder.AdvancedWARWebServiceFinder`.
org.apache.geronimo.saaj.provider	axis2, sun	not set	Specifies the SAAJ provider.
org.apache.geronimo.webservice.provider.wsdl.ignore	true, false	not set	Ignores WSDL location that is specified for @WebServiceProvider service.

OSGi Application System Properties

OptionClass	Value	Default	Description
ariesApplicationResolver.returnOptionalResources	true, false	false	Controls whether optional bundles should be provisioned during OSGi application installation or not.
org.apache.geronimo.aries.failApplicationOnStartError	true, false	false	If true and one of the bundles of an OSGi application fails to start, the entire OSGi application is undeployed. If false, the OSGi application stays around even if there are bundle start errors.
org.apache.geronimo.aries.resolveApplicationOnDeploy	true, false	true	Controls whether OSGi application is resolved during installation. If false, the OSGi application is resolved each time it is started.
org.apache.geronimo.osgi.web.extender.synchronous	true, false	false	Support for synchronous deployment of Web Application Bundles (WABs). Equivalent with Synchronous-Deploy header in the `MANIFEST.MF` file of a WAB.