From scm-return-46907-apmail-geronimo-scm-archive=geronimo.apache.org@geronimo.apache.org Wed Jul 20 12:19:31 2011 Return-Path: X-Original-To: apmail-geronimo-scm-archive@www.apache.org Delivered-To: apmail-geronimo-scm-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 02649702E for ; Wed, 20 Jul 2011 12:19:31 +0000 (UTC) Received: (qmail 41576 invoked by uid 500); 20 Jul 2011 12:19:30 -0000 Delivered-To: apmail-geronimo-scm-archive@geronimo.apache.org Received: (qmail 41516 invoked by uid 500); 20 Jul 2011 12:19:29 -0000 Mailing-List: contact scm-help@geronimo.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: List-Post: Reply-To: dev@geronimo.apache.org List-Id: Delivered-To: mailing list scm@geronimo.apache.org Received: (qmail 41509 invoked by uid 99); 20 Jul 2011 12:19:29 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 20 Jul 2011 12:19:29 +0000 X-ASF-Spam-Status: No, hits=-1994.3 required=5.0 tests=ALL_TRUSTED,HTML_FONT_LOW_CONTRAST,HTML_MESSAGE,MIME_HTML_ONLY X-Spam-Check-By: apache.org Received: from [140.211.11.22] (HELO thor.apache.org) (140.211.11.22) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 20 Jul 2011 12:19:22 +0000 Received: from thor (localhost [127.0.0.1]) by thor.apache.org (8.13.8+Sun/8.13.8) with ESMTP id p6KCJ0EP003481 for ; Wed, 20 Jul 2011 12:19:00 GMT Date: Wed, 20 Jul 2011 08:19:00 -0400 (EDT) From: confluence@apache.org To: scm@geronimo.apache.org Message-ID: <20463701.8864.1311164340027.JavaMail.confluence@thor> Subject: [CONF] Apache Geronimo v3.0 > System Properties MIME-Version: 1.0 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Auto-Submitted: auto-generated X-Virus-Checked: Checked by ClamAV on apache.org

System Properties

Page edited by Runhua Chi


Changes (22)

=20 =20
=20 <= /tr> =20
{scrollbar}
{note}This is an initial lis= t of system properties. The lines starting with "Found in" is jus= t for convenience for writing this page, and should be removed when the pag= e is finalized.
{note}

{excerpt}The following options table lists system level properties whi= ch can be set using GERONIMO_OPTS system variable, so that the settings could take effect by the time o= f server startup.{excerpt}
On a Windows: *set GERONIMO_= OPTS=3D-D<OptionClass>=3D<value>*
On non-Windows systems: *= export GERONIMO_OPTS=3D-D<OptionClass>=3D<value>*
!Setup^ngwin.gif|height=3D"13",width=3D"51",alt= =3D"(On a Windows system)"! *set GERONIMO_OPTS=3D-D<OptionClas= s>=3D<value>*
!Setup^ngaix.gif|height=3D"13",width= =3D"49",alt=3D"(On an AIX system)"!!Setup^nglinux.gif|h= eight=3D"13",width=3D"49",alt=3D"(On a Linux syste= m)"!!Setup^ngsolaris.gif|height=3D"13",width=3D"61"= ;,alt=3D"(On a Solaris system)"! *export GERONIMO_OPTS=3D-D<O= ptionClass>=3D<value>*

OptionClass:org.apache.geron= imo.deployment.LenientMFCP
Value: true, false
Default: false
<= /td>
|| OptionClass || Value || Default || Description ||
Description: Specify | org.apache.geronimo.deployment.LenientMFCP | tr= ue, false | false | Specifies lenience vs. strict manifest classpath= interpretation. Specify "true" *tr= ue* for more lenient processing such as ignoring missing jars and re= ferences that are not spec compliant.|
Found in framework\modules\g= eronimo-deployment\src\main\java\org\apache\geronimo\deployment\DeploymentC= ontext.java

OptionClass:org.apache.geronimo.deployment.util.Deploy= mentUtil.jarUrlRewrite
Value: true, false
Default: false
Description: To prevent | org.apache.geronimo.deployment.util.Deployme= ntUtil.jarUrlRewrite |true, false | false | Prevents the lockout of = archive during deployment, instead of returning a jar url, write the conten= t to a temp file and return the url of that file.= |
Found in framework\modules\g= eronimo-deployment\src\main\java\org\apache\geronimo\deployment\util\Deploy= mentUtil.java

OptionClass:org.apache.geronimo.gbean.NoProxy
Va= lue: true, false
Default: true
Description: Specify | org.apache.geronimo.gbean.NoProxy | true, false= | true | Specifies whether to use fast proxy to access GBean. If no= t, reflection is used.|
Found in framework\modules\g= eronimo-kernel\src\main\java\org\apache\geronimo\gbean\runtime\AbstractGBea= nReference.java

OptionClass:org.apache.geronimo.kernel.config.Mars= haler
Default: OptionClass:org.apache.geronimo.kernel.config.Serialized= ConfigurationMarshaler
Description: Specify the configuration marshaler= class.
Found in framework\modules\geronimo-kernel\src\main\java\org\a= pache\geronimo\kernel\config\ConfigurationUtil.java

OptionClass:or= g.apache.geronimo.kernel.config.MPCLSearchOption
Value: safe, optimized=
Default: safe
Description: Specify classLoaderSearchMode of the Mu= ltiParentClassLoader
Found in framework\modules\geronimo-kernel\src\mai= n\java\org\apache\geronimo\kernel\config\MultiParentClassLoader.java
<= br>geronimo.bootstrap.logging.enabled
Value: true, false
Default: t= rue
Description: TODO
Found in framework\modules\geronimo-kernel\sr= c\main\java\org\apache\geronimo\kernel\log\GeronimoLogging.java

Op= tionClass:org.apache.geronimo.jacc.policy.provider
Default: Policy prov= ider of the JRE
Description: Specify the classname of the JACC policy p= rovider. Must be a subclass of java.security.Policy.
Found in framework= \modules\geronimo-security\src\main\java\org\apache\geronimo\security\jacc\= mappingprovider\GeronimoPolicy.java

OptionClass:org.apache.geronim= o.config.file
Description: Specify the location of server config file <= br>Found in framework\modules\geronimo-system\src\main\java\org\apache\gero= nimo\system\configuration\LocalAttributeManager.java

OptionClass:o= rg.apache.geronimo.config.substitutions.file
Description: Specify the l= ocation of server config substitutions file
Found in framework\modules\= geronimo-system\src\main\java\org\apache\geronimo\system\configuration\Loca= lAttributeManager.java

OptionClass:org.apache.geronimo.config.subs= titution.prefix
Default: org.apache.geronimo.config.substitution.
<= /td>
| org.apache.geronimo.kernel.config.Marshaler | | org.apache.geronimo= .kernel.config.SerializedConfigurationMarshaler | Specifies the configurati= on marshaler class. |
| org.apache.geronimo.kernel.config.MPCLSearchOpt= ion | safe, optimized | safe | Specifies classLoaderSearchMode of the Multi= ParentClassLoader.|
| org.apache.geronimo.jacc.policy.provider | | Poli= cy provider of the JRE | Specifies the classname of the JACC policy provide= r. Must be a subclass of java.security.Policy.|
| org.apache.geronimo.c= onfig.file | | | Specifies the location of server config file. |
| org.= apache.geronimo.config.substitutions.file | | | Specifies the location of = server config substitutions file.|
Description: Specify | org.apache.geronimo.config.substitution.prefix = | | org.apache.geronimo.config.substitution |Specifies the prefix u= sed to specify config substitutions. Users can specify a (key, value) to ov= erride the properties set in the config substitutions file. For example, an= entry such as hostName=3Dlocalhost can be overridden by setting OptionClass:org.apache.geronimo.config.substitution.h= ostName=3Dfoo {{-Dorg.apache.geronimo.config.substitution.hostName=3Dfoo}} when the prefix is "OptionClass:o= rg.apache.geronimo.config.substitution.". {{org.apache.geronimo.config.s= ubstitution}}.|
Found in framework\modules\g= eronimo-system\src\main\java\org\apache\geronimo\system\configuration\Local= AttributeManager.java

OptionClass:org.apache.geronimo.home.dir Description: Specify geronimo installation directory
Found in framewor= k\modules\geronimo-system\src\main\java\org\apache\geronimo\system\serverin= fo\BasicServerInfo.java

OptionClass:org.apache.geronimo.server.dir=
Description: Specify the base dir of a server instance
Found in fr= amework\modules\geronimo-system\src\main\java\org\apache\geronimo\system\se= rverinfo\BasicServerInfo.java

OptionClass:org.apache.geronimo.serv= er.name
Description: Specify the name of a server instance, used to con= struct the base dir as a sub-dir of the geronimo installation dir when Opti= onClass:org.apache.geronimo.server.dir is not specified.
Found in frame= work\modules\geronimo-system\src\main\java\org\apache\geronimo\system\serve= rinfo\BasicServerInfo.java

OptionClass:org.apache.geronimo.reposit= ory.boot.path
Description: Specify the path of the server repository? <= br>Found in plugins\jaxws\geronimo-jaxws-builder\src\main\java\org\apache\g= eronimo\jaxws\builder\JAXWSToolsCLI.java

OptionClass:org.apache.ge= ronimo.jaxws.wsgen.addToClassPath
Value: true, false
Default: true =
Description: TODO
Found in plugins\jaxws\geronimo-jaxws-builder\src= \main\java\org\apache\geronimo\jaxws\builder\WsdlGenerator.java

Op= tionClass:org.apache.geronimo.jaxws.wsgen.fork
Value: true, false
D= efault: true on Windows, false on other OS
Description: TODO
Found = in plugins\jaxws\geronimo-jaxws-builder\src\main\java\org\apache\geronimo\j= axws\builder\WsdlGenerator.java

OptionClass:org.apache.geronimo.ja= xws.wsgen.fork.timeout
| org.apache.geronimo.home.dir | | | Specifies server installation di= rectory. |
| org.apache.geronimo.server.dir | | | Specifies the base di= rectory 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.s= erver.dir}} is not specified. |
| org.apache.geronimo.repository.boot.p= ath | | | Specifies the path of the server repository.|
| org.apache.ge= ronimo.jaxws.wsgen.addToClassPath | true, false | true | Controls whether t= he wsgen generated classes should be added to the module classpath. \\ By d= efault, the generated classes will be added to the module classpath. |
= | org.apache.geronimo.jaxws.wsgen.fork | true, false | true on Windows \\ f= alse on other OS | |
Default: | org.apache.geronimo.jaxws.wsgen.fork.timeout | | 10= 00 * 60 (microseconds) | |
Description: TODO
Found = in plugins\jaxws\geronimo-jaxws-builder\src\main\java\org\apache\geronimo\j= axws\builder\WsdlGenerator.java

OptionClass:org.apache.geronimo.to= mcat.GeronimoStandardContext.allowLinking
Value: true, false
Defaul= t: false
Description: TODO
Found in plugins\tomcat\geronimo-tomcat6= \src\main\java\org\apache\geronimo\tomcat\GeronimoStandardContext.java
=
OptionClass:org.apache.geronimo.saaj.provider
Value: axis2, sun Default: not set.
Description: Specify the SAAJ provider.
Found i= n plugins\webservices\geronimo-webservices\src\main\java\org\apache\geronim= o\webservices\saaj\SAAJFactoryFinder.java

OptionClass:org.apache.g= eronimo.jaxws.builder.useSimpleFinder
Value: true, false
Default: n= ot set
Description: Use org.apache.geronimo.jaxws.builder.SimpleWARWebS= erviceFinder to locate WebServiceInfo objects,otherwise use org.apache.gero= nimo.jaxws.builder.AdvancedWARWebServiceFinder.
Found in plugins/jaxws/= geronimo-jaxws-builder/src/main/java/org/apache/geronimo/jaxws/builder/WebS= erviceFinder

OptionClass:org.apache.geronimo.webservice.provider.w= sdl.ignore
Value: true, false
Default: not set
Description: Ign= ore WSDL location that is specified for @WebServiceProvider service.
Fo= und in plugins/axis/geronimo-axis2-builder/src/main/java.org/apache/geronim= o/axis2/builder/Axis2Builder.java

Option:ariesApplicationResolver= .returnOptionalResources
Value: true, false
Default: false
| org.apache.geronimo.tomcat.GeronimoStandardContext.allowLinking | t= rue, 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 spe= cified, the default value of the flag is false. |
| org.apache.geronimo= .saaj.provider | axis2, sun | not set | Specifies the SAAJ provider.|
|= org.apache.geronimo.jaxws.builder.useSimpleFinder | true, false | not set = | Uses {{org.apache.geronimo.jaxws.builder.SimpleWARWebServiceFinder}} to l= ocate WebServiceInfo objects, otherwise use {{org.apache.geronimo.jaxws.bui= lder.AdvancedWARWebServiceFinder}}. |
| org.apache.geronimo.webservice.= provider.wsdl.ignore | true, false | not set | Ignores WSDL location that i= s specified for @WebServiceProvider service.|
Description: Control | ariesApplicationResolver.returnOptionalResource= s | true, false | false | Controls whether optional bundles should b= e provisioned during EBA installation or not.|
Found in plugins/aries/geron= imo-aries/src/main/resources/OSGI-INF/blueprint/obr-resolver.xml

= Option:org.apache.geronimo.aries.failApplicationOnStartError
Value: tru= e, false
Default: false
Description: Keep bundles around if EBA sta= rt failed
Found in plugins/aries/geronimo-aries/src/main/java/org/apac= he/geronimo/aries/ApplicationGBean.java
| org.apache.geronimo.aries.failApplicationOnStartError | true, false= | false | Keeps bundles around if EBA start failed.|
| org.apache.gero= nimo.osgi.web.extender.synchronous | true, false | false | Support for sync= hronous deployment of WAB. \\ Equivalent with *Synchronous-Deploy* header i= n the {{manifest.mf}} file. |

Full Content

The following table lists system level properties which can be set using= GERONIMO_OPTS system variable, so that the settings could take effect by t= he time of server startup.
Unable to render embedded object: File (ngwin.gif) no= t found. set GERONIMO_OPTS=3D-D<OptionClass>=3D<value>= ;
Unable to render embedded object: File (ngaix.gif) no= t found.Unable to render embedded object: File= (nglinux.gif) not found.Unable to render embe= dded object: File (ngsolaris.gif) not found. export GERONIMO_OPT= S=3D-D<OptionClass>=3D<value>

OptionClass Value Default Description
org.apache.geronimo.deployment.LenientMFCP true, false false Specifies lenience vs. strict manifest classpat= h interpretation. Specify true for more lenient processing such as i= gnoring missing jars and references that are not spec compliant.
org.apache.geronimo.deployment.util.DeploymentU= til.jarUrlRewrite true, false false Prevents the lockout of archive during deployme= nt, instead of returning a jar url, write the content to a temp file and re= turn the url of that file.
org.apache.geronimo.gbean.NoProxy true, false true Specifies whether to use fast proxy to access G= Bean. If not, reflection is used.
org.apache.geronimo.kernel.config.Marshaler   org.apache.geronimo.kernel.config.SerializedCon= figurationMarshaler Specifies the configuration marshaler class.
org.apache.geronimo.kernel.config.MPCLSearchOpt= ion safe, optimized safe Specifies classLoaderSearchMode of the MultiPar= entClassLoader.
org.apache.geronimo.jacc.policy.provider   Policy provider of the JRE Specifies the classname of the JACC policy prov= ider. Must be a subclass of java.security.Policy.
org.apache.geronimo.config.file     Specifies the location of server config file. <= /td>
org.apache.geronimo.config.substitutions.file <= /td>     Specifies the location of server config substit= utions file.
org.apache.geronimo.config.substitution.prefix =   org.apache.geronimo.config.substitution Specifies the prefix used to specify config subs= titutions. Users can specify a (key, value) to override the properties set = in the config substitutions file. For example, an entry such as hostName=3D= localhost can be overridden by setting -Dorg.apache.geronimo.config.sub= stitution.hostName=3Dfoo when the prefix is org.apache.geronimo.co= nfig.substitution.
org.apache.geronimo.home.dir     Specifies server installation directory.
org.apache.geronimo.server.dir     Specifies the base directory of a server instan= ce.
org.apache.geronimo.server.name     Specifies the name of a server instance, used t= o 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.jaxws.wsgen.addToClassPath = true, false true Controls whether the wsgen generated classes sh= ould 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.tomcat.GeronimoStandardCont= ext.allowLinking true, false false The option is for Tomcat assembly only.
If the value of this flag is true, symlinks wil= l be allowed inside the web application, pointing to resources outside the = web application base path.
If not speci= fied, the default value of the flag is false.
org.apache.geronimo.saaj.provider axis2, sun not set Specifies the SAAJ provider.
org.apache.geronimo.jaxws.builder.useSimpleFind= er true, false not set Uses org.apache.geronimo.jaxws.builder.Simp= leWARWebServiceFinder to locate WebServiceInfo objects, otherwise use = org.apache.geronimo.jaxws.builder.AdvancedWARWebServiceFinder.
org.apache.geronimo.webservice.provider.wsdl.ig= nore true, false not set Ignores WSDL location that is specified for @We= bServiceProvider service.
ariesApplicationResolver.returnOptionalResource= s true, false false Controls whether optional bundles should be pro= visioned during EBA installation or not.
org.apache.geronimo.aries.failApplicationOnStar= tError true, false false Keeps bundles around if EBA start failed.
org.apache.geronimo.osgi.web.extender.synchrono= us true, false false Support for synchronous deployment of WAB.
Equivalent with Synchronous-Deploy h= eader in the manifest.mf file.