• wrapper.app.parameter.<n> property
• wrapper.app.parameter.default.stripquotes property
• wrapper.app.parameter_file property
• wrapper.app.parameter_file.stripquotes property

Compatibility :	1.0.0
Editions :
Platforms :

Application parameters to pass to your application when it is launched. These are the parameters passed to your application's main method.

When the value of wrapper.java.mainclass property is org.tanukisoftware.wrapper.WrapperSimpleApp, the first parameter to the application must be the name of the class which contains your main method. All other parameters are then passed to your application's main method in order. See the Integration section for more details.

<n> component:

Each element has a property name which starts with wrapper.app.parameter. and the "<n>" component of the property name is an integer number counting up from "1". By default, there can be no missing numbers. The wrapper.ignore_sequence_gaps property can optionally be set to allow gaps in the sequence.

Quotes:

For each entry, you can also have a corresponding strip quotes flag (stripquotes property = TRUE) which will remove unescaped quotes from the element when run on Linux/UNIX machines. This is necessary to allow for file references which contain spaces. For parameters like the one below, it would not otherwise be possible to decide when to remove quotes and when to leave them alone. All other characters except for the followings will remain unchanged.

• '\\' will become '\',
• '\"' will become '"'
• '"' will become ''

wrapper.java.mainclass=org.tanukisoftware.wrapper.WrapperSimpleApp
wrapper.app.parameter.1=com.widgetsrus.MyAppMain
wrapper.app.parameter.2=-d
wrapper.app.parameter.3=-c"../conf/myapp.conf"
wrapper.app.parameter.3.stripquotes=TRUE
wrapper.app.parameter.4=-p4

wrapper.app.parameter.1=-c conf/myconffile.conf

wrapper.app.parameter.1=-c
wrapper.app.parameter.2=conf/myconffile.conf

Compatibility :	3.5.17
Editions :
Platforms :

Makes it possible to change the default strip quotes behavior on UNIX when you wish to have the same behavior for all wrapper.app.parameter.<n> property values. The default value is "FALSE". The property is ignored on Windows.

wrapper.app.parameter.default.stripquotes=FALSE

Compatibility :	3.5.17
Editions :
Platforms :

In certain cases, it can be inconvenient to list up your application parameters in the Wrapper configuration file. This property provides a way to specify a file which can contain one or more parameters that will be passed as is to the JVM when it is launched. This can be very useful when the parameter list needs to be generated dynamically or via an installer.

Any parameters defined in this file will appear after those defined using the standard wrapper.app.parameter.<n> properties.

Starting with Wrapper version 3.5.23, any environment variable references in the file will be expanded.

Parameter File Format:

The file format is simple.

• It must start with an encoding directive line just like the Wrapper configuration file. This is needed to tell the Wrapper what encoding to use when reading the file. If this line is missing then the Wrapper will attempt to proceed after logging a warning. The encoding used in the file may be different from the encoding used in other configuration files.
• Multiple parameters can be written in one line by separating each parameter with one or more spaces.
• It is also possible to break the parameters into multiple lines.
• The '#' character is interpreted as a comment character. To include a '#' character in a property value, the value must either be quoted ("#") or escaped by a second '#' character.
• If any of the values need to include a space, then it is necessary to add quotes following the rules described below to make sure the file works consistently across all platforms.

#encoding=UTF-8
# Example parameters: Multiple parameters in one line
-DTEST1=Value1 -DTEST2=Value2

# More parameters
-DTEST3=Value3

Compatibility :	3.5.17
Editions :
Platforms :

Different platforms handle parameters with spaces differently. To make a given configuration work consistently, you should always quote those values. They will be used as is on Windows. However, on UNIX platforms, the quotes will be stripped as the command line is broken into a parameter list.

In almost all cases you will want to strip these quotes. To be consistent with the way the wrapper.app.parameter.<n>.stripquotes property works, this property defaults to the value of the wrapper.app.parameter.default.stripquotes property, which itself defaults to "FALSE".

wrapper.app.parameter_file.stripquotes=FALSE

#encoding=UTF-8
-DTEST1=Value1 -DTEST2="Test Value with spaces."

• wrapper.app.parameter.<n> (1.0.0)

  Configuration of parameters when applications are launched.

• wrapper.app.parameter_file (3.5.17)

  Specifies the parameters to be used by the JVM.

• wrapper.app.parameter_file.stripquotes (3.5.17)

  Configures a solution using parameters with stripquotes.

• wrapper.java.additional.<n> (1.0.0)

  Configures additional Java parameters to pass to Java when it is launched.

• wrapper.java.additional.<n>.stripquotes (1.0.0)

  This property tells the Wrapper to automatically strip extra quotes only on UNIX.

• wrapper.java.additional.default.stripquotes (3.5.17)

  Makes it possible to change the default strip quotes behavior on UNIX.

• wrapper.java.additional_file (3.5.16)

  This property provides a way to specify a file which can contain one or more parameters.

• wrapper.java.additional_file.stripquotes (3.5.16)

  This property helps to handle parameters with spaces from different platforms to work consistently.

• wrapper.java.mainclass (1.0.0)

  Configuring the mainclass when the Wrapper starts an application.

• wrapper.java.tmpdir.<x> (3.5.0)

  This is often used for caching downloaded files or remote jars, etc.

• wrapper.java.tmpdir.required (3.5.0)

  Controls what the Wrapper should do when it detects the Java temporary directory can not be written to.

• wrapper.java.tmpdir.warn_silently (3.5.0)

  Controls how the Wrapper should notify the user that the Java temporary directory could not be written to.