HomeDocumentation > Reference > Tools and commands > 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.