• wrapper.app.property.<n> property
• wrapper.app.property.<n>.java_version.min property
• wrapper.app.property.<n>.java_version.max property
• wrapper.app.property_file property
• wrapper.app.property_file.required property

Compatibility :	3.5.57
Editions :
Platforms :

List of application specific properties that are sent from the Wrapper to the JVM via the backend pipe or socket once the connection is established.

The user application will be launched after all properties have been received and set on the Java side. This ensures that all properties will be available when the application starts.

Using the wrapper.app.property.<n> properties is more secure than setting wrapper.java.additional.<n>, which expose them in plain text to process listing tools. For this reason, it is strongly recommended to use application properties for passwords or any sensitive data that your application may use.

To protect data stored in your configuration file, a best practice is to isolate the wrapper.app.property.<n> properties containing sensitive values in a separate "include file" and assign it with restrictive read permissions (e.g for admin or owner only).

In addition, to prevent passwords or sensitive data to be printed as plain text in the Wrapper log output, please use the %...|mask% syntax.

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

wrapper.app.property.1=mypassword=%secret|mask%

Compatibility :	3.5.57
Editions :
Platforms :

This property can be used to append the property with index 'n' only if the Java version is greater than or equal to the specified value.

The default value is '1.4' which is the oldest JVM version supported by the Wrapper. Any lower value is invalid and will cause the Wrapper to stop.

The value can be in the format '1.major[.minor[_revision]]' or 'major[.minor[.revision]]', regardless the version of Java. This is done to support both numbering schemes returned by 'java -version': prior to Java 9 the first format was used, while Java 9 and above use the second format.

The brackets indicate that the minor and revision components are optional. Leaving one or both unspecified means that these placeholders will accept any number.

wrapper.app.property.<n>.java_version.min=1.7

wrapper.app.property.<n>.java_version.min=8.0.40

Compatibility :	3.5.57
Editions :
Platforms :

This property can be used to append the property with index 'n' only if the Java version is lower than or equal to the specified value.

The default value is 'UNLIMITED'.

The value can be in the format '1.major[.minor[_revision]]' or 'major[.minor[.revision]]', regardless the version of Java. This is done to support both numbering schemes returned by 'java -version': prior to Java 9 the first format was used, while Java 9 and above use the second format.

The brackets indicate that the minor and revision components are optional. Leaving one or both unspecified means that these placeholders will accept any number.

wrapper.app.property.<n>.java_version.max=9.0.1

wrapper.app.property.<n>.java_version.max=9

Compatibility :	3.5.57
Editions :
Platforms :

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

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.
• Unlike for wrapper.java.additional_file and wrapper.app.parameter_file, this file can only contain one property per line.
• 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.

#encoding=UTF-8
# Some properties
prop1=value
prop2=value with spaces

Compatibility :	3.5.57
Editions :
Platforms :

Specifies if the property file is required or not. If it is required and not found, the Wrapper will stop without starting the JVM. If it is not required, the file will be ignored when not found.

The default value is TRUE.

wrapper.app.property_file.required=FALSE

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

  Set the parameters of your Java application.

• wrapper.app.parameter.<n>.stripquotes (3.5.17)

  Strip the quotes in the application parameters (Unix only).

• wrapper.app.parameter.default.stripquotes (3.5.17)

  Strips the quotes for all "app.parameter" properties (Unix only).

• wrapper.app.parameter_file (3.5.17)

  Specifies the path of the file containing the application parameters.

• wrapper.app.parameter_file.required (3.5.17)

  Specifies if the parameter file is required or not.

• wrapper.app.parameter_file.stripquotes (3.5.17)

  Strips the quotes in the application parameters listed in the parameter file.

• wrapper.app.property.<n> (3.5.57)

  Configure application specific properties to be sent via pipe or socket.

• wrapper.app.property.<n>.java_version.min (3.5.57) ( Std/Pro )

  Append application property with index 'n' only if the Java version is greater than or equal to the specified value.

• wrapper.app.property.<n>.java_version.max (3.5.57) ( Std/Pro )

  Append application property with index 'n' only if the Java version is lower than or equal to the specified value.

• wrapper.app.property_file (3.5.57)

  Specifies the path of the file containing the application properties.

• wrapper.app.property_file.required (3.5.57)

  Specifies if the property file is required or not.

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

  Configure additional parameters to pass to the JVM.

• wrapper.java.additional.<n>.java_version.max (3.5.36) ( Std/Pro )

  Append option with index 'n' only if the Java version is lower than or equal to the specified value.

• wrapper.java.additional.<n>.java_version.min (3.5.36) ( Std/Pro )

  Append option with index 'n' only if the Java version is greater than or equal to the specified value.

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

  Strip the quotes in the JVM parameters (Unix only).

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

  Strips the quotes for all "java.additional" properties (Unix only).

• wrapper.java.additional_file (3.5.16)

  Sets the path to a file containing JVM parameters.

• wrapper.java.additional_file.required (3.5.36)

  Specifies if the Java additional file is required or not.

• wrapper.java.additional_file.stripquotes (3.5.16)

  Strips the quotes in the JVM parameters listed in the "additional file" (Unix only).

• wrapper.java.mainclass (1.0.0)

  Sets the class holding the main method called when the Wrapper starts the JVM.

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

  Specifies if the Wrapper should exit when the Java temporary directory cannot be written to.

• wrapper.java.tmpdir.warn_silently (3.5.0)

  Specifies whether a message should be logged at the DEBUG or WARN log level when the Java temporary directory could not be written to.