System Properties

The following properties are used by Payara Server to configure special behavior settings:

Option Value Type Description Accepted Values Default

fish.payara.clientHttpsProtocol

String

Sets the TLS version to be used by the asadmin client. This is separate from the TLS version set for HTTPS communication on a listener.

TLSv1, TLSv1.1, TLSv1.2, TLSv1.3

TLSv1.2

fish.payara.classloading.delegate

Boolean

When set to false, libraries from applications, and <domain>/lib will override the library in <payara-installation>/glassfish/modules directory

true, false

true

fish.payara.shutdowngrace

Integer

After server shutdown is initiated the server waits this period of time to finish ongoing requests before terminating. Currently, new requests are still accepted during this grace period.

0 - Integer.MAX

0

fish.payara.permittedFormBasedAuthHttpMethods

String

A comma separated list of HTTP methods that are permitted to use for FORM based authentication (j_security_check). If not set all HTTP methods are permitted.

GET,HEAD,POST,PUT,DELETE,CONNECT,OPTIONS,TRACE,PATCH

null (undefined)

fish.payara.admin.command.jline.log.disable

Boolean

When set to true, JLine logging entries for invalid key bindings and other unwanted errors will be prevented - This is a property for the asadmin tool

true, false

false

fish.payara.SO_KEEPALIVE

String

Enables keep alive (SO_KEEPALIVE) on the sockets created by an IIOP listener. Can be set as a global system property, or as a property on a specific listener (with the latter taking precedence over the global setting if both are set). Replaces deprecated property fish.payara.SOKeepAlive.

true, false

false (undefined)

org.glassfish.grizzly.DEFAULT_MEMORY_MANAGER

String

If option (defined as JVM Option with -D or as System Property value) org.glassfish.grizzly.DEFAULT_MEMORY_MANAGER is not present in the server/instance config, we will override the Grizzly default and use the HeapMemoryManager class. To override this behaviour (so to use a different memory manager), you must specify this JVM option in the server/instance config with your desired setting.

org.glassfish.grizzly.memory.HeapMemoryManager, org.glassfish.grizzly.memory.PooledMemoryManager, org.glassfish.grizzly.memory.ByteBufferManager

org.glassfish.grizzly.memory.HeapMemoryManager

deployment.resource.validation

boolean

This option (defined as JVM Option with -D or as System Property value) defines if the resources are validated during deployment of the application. When active, the default value, all JNDI references are verified but those references can be provided by the application itself and thus not yet available at deployment time (for example the java:module/env/ based ones). By setting this option to false, validation is not performed and deployment will succeed. However, issues will occur at runtime of the application in case of errors in the references.

true, false

true

fish.payara.javax.servlet.jsp.disable-static-field-references

boolean

This option brings back the behaviour of evaluating EL in JSPs from GlassFish 3. When enabled, a static field reference won’t be evaluated.

true, false

false (undefined)

fish.payara.upgrade.repo.url

String

This option defines the Maven repository download URL for the upgrade-server command.

A URL pointing to the Payara Nexus repository to download from (expected to point to the fish/payara/distributions directory of the repository)

https://nexus.payara.fish/repository/payara-enterprise-downloadable-artifacts/fish/payara/distributions/

fish.payara.node.ssh.timeout

Integer

This option sets the SSH timeout in milliseconds for running commands on SSH nodes. This is a separate timeout to the asadmin or any command specific timeout, this is specifically for the SSH connection used for running certain commands that operate on the remote node itself (e.g. setup-ssh and start-instance). If set to an invalid value a warning will be logged and the default will be used.

1 - Integer.MAX

120000

fish.payara.tenantcontrol.blocking.disable

boolean

This option determines if a Payara instance should skip its standard checks for if it is available for a Hazelcast Tenantable object.

true, false

true (undefined)

hazelcast.cp-subsystem.auto-promote

boolean

When the Payara Server’s Data Grid/Hazelcast CP subsystem is enabled (more than 0 members configured), this option will enable or disable an auto-promote behaviour that will allow other server instances to join the Hazelcast CP subsystem when detected by the DAS.

The CP subsystem is automatically enabled on the Data Grid/Hazelcast when the hazelcast.cp-subsystem.cp-member-count system property is set an integer greater than zero.

true, false

true

hazelcast.auto-partition-group

boolean

Enables/disables Hazelcast group auto-partitioning behaviour in Payara Server’s Data Grid.

When auto-partitioning is turned on, instances that join the Data Grid will not follow the default partition group configuration strategy and instead will form individual partition groups. Read more about how partition groups work in the official Hazelcast Platform documentation.

This option is intended to make member partitioning work consistently for highly dynamic environments (like Kubernetes).

Use this option with care

true, false

false