Table of Contents
System properties are configured with the -D option for the JVM. Since JEUS uses Launch JVM to start the server JVM, system properties must be set in each server configuration of domain.xml.
The following is an example of a system property configuration.
<domain>
<servers>
<server>
<name>server1</name>
<jvm-config>
<jvm-option>-Xmx512m -XX:MaxPermSize=250m</jvm-option>
</jvm-config>
...
1. The properties set in the domain admin server or server script are only applicable when using Launch JVM.
2. System properties must be carefully set because they affect the overall operation of JEUS and all applications. It is recommended to use the XML settings instead of the system properties.
This chapter describes the server system properties.
jeus.home
| Description | Location of JEUS installation files. |
| Default | JEUS installation directory. |
jeus.launcher.log.home
| Description | Location of JEUS Launcher logs. If not set, logs are created under the JEUS_SERVER_HOME/logs folder. |
| Default | null |
jeus.boot.printclasspath
| Description | Option to output the class path of system Classloader. |
| Default | false |
jeus.server.autorestart
| Description | Option to automatically restart MS if SCF detects a failure. However, if a Java node manager is used, SCF is not used for failure detection. In this case, the setting of the automatic restart option of the node manager is used. |
| Default | true |
jeus.jdk.home
| Description | Path to JDK Home directory for javac and tools.jar files. |
| Default | If not set, 'java.home' is used. |
jeus.properties.replicate
| Description | Prefix of system properties sent to the Launcher at server startup. The 'server/jvm-config/jvm-option' value overrides this value. |
| Default | jeus |
jeus.server.check-interrupted-status
| Description | Option to generate an exception when a thread executing EJB or JDBC operation in JEUS receives an interrupt signal. The exception generated by an interrupted thread must be processed by the user application. |
| Default | true |
jeus.threadpool.queuesize
| Description | Internal queue size of thread pools used in JEUS. Thread pools are generally used in JEUS modules. If the number of threads is insufficient to handle system load, tasks are accumulated in the queue up to the maximum queue size. The 'server/system-thread-pool/queue-size' value in domain.xml overrides this value. |
| Default | 4096 |
jeus.threadpool.keepalive
| Description | Keep-alive time for inactive threads. If the thread pool contains more than the minimum number of threads, inactive threads are automatically removed from the thread pool after the specified time period. The 'server/system-thread-pool/keep-alive-time' value in domain.xml overrides this value. |
| Default | 300000 (Unit: ms) |
jeus.rmi.defaultPort
| Description | Default RMI export port. This property also applies to all EJBs with an unspecified export-port. |
| Default | - base port + 7 |
jeus.rmi.jeusrmi.defaultPort
| Description | Default RMI export port provided by JEUS. |
| Default | - base port + 11 |
jeus.vm.bits
| Description | JVM bit number. If 64 is set to run a 64-bit JVM, '-d64' is appended. IBM does not require '-d64'. |
jeus.interop.ssl.keystore
| Description | SSL keystore for CORBA CSIv2. |
| Default | Value of jeus.net.ssl.keystore. |
jeus.interop.ssl.keypass
| Description | SSL keystore password for CORBA CSIv2. |
| Default | Value of jeus.net.ssl.keypass. |
jeus.interop.ssl.truststore
| Description | SSL truststore for CORBA CSIv2. |
| Default | Value of jeus.net.ssl.truststore |
jeus.interop.ssl.trustpass
| Description | SSL truststore password for CORBA CSIv2. |
| Default | Value of jeus.net.ssl.trustpass |
jeus.jvm.version
| Description | JVM version used by JEUS. |
| Default | hotspot (uses '-server') |
jeus.server.cpumonitor.enabled
| Description | Option to enable the monitoring function for measuring the host CPU usage. |
| Default | false |
jeus.server.cpumonitor.interval
| Description | Interval for measuring the CPU usage when monitoring the host CPU usage. |
| Default | 60000 (Unit: ms) |
jeus.server.process.cpumonitor.enabled
| Description | Option to enable the monitoring function for measuring the process CPU usage. A thread dump is generated during monitoring. |
| Default | false |
jeus.server.process.cpumonitor.interval
| Description | Interval for measuring the CPU usage when monitoring the process CPU usage. |
| Default | 2000 (Unit: ms) |
jeus.server.cpumonitor.ratio
| Description | CPU overflow ratio when monitoring the process CPU usage. Use a floating point number. Assuming the maximum CPU usage is 100, this is the percent of the maximum regarded as overflow. |
| Default | 0.8 |
jeus.server.enable.restart.in.memory.shortage
| Description | Option to restart the server when there is a memory overflow. |
| Default | true |
jeus.server.memorymonitor.enabled
| Description | Option to enable the monitoring function to measure the server memory usage. |
| Default | false |
jeus.server.memorymonitor.interval
| Description | Interval for measuring the memory usage. |
| Default | 2000 (Unit: ms) |
jeus.server.memorymonitor.duration
| Description | Memory overflow duration. If memory overflow occurs during the specified time period, the server is terminated. |
| Default | 60000 (Unit: ms) |
jeus.server.memorymonitor.ratio
| Description | Memory overflow ratio when monitoring the memory usage. Use a floating number. Assuming the maximum memory usage is 100, this is the percent of the maximum regarded as memory overflow. |
| Default | 0.8 |
jeus.server.maxdowntime
| Description | Maximum time (ms) to wait for an engine container to shut down when the Manager shuts down the engine container or the engine container shuts itself down. If the engine container has not shut down when this time expires, it is forcibly shut down. |
| Default | 0 (Unit: ms) |
jeus.server.configfile.backup.size
| Description | Number of backup domain.xml files saved during a dynamic update. |
| Default | 50 |
jeus.print-system-properties
| Description | Option to output the configured system properties. |
| Default | false |
jeus.management.snmp.dynamic
| Description | Option to create dynamic OID when using the SNMP server. When using the SNMP server, OID can be used either statically or dynamically.
|
| Default | true |
jeus.management.snmp.dynamic.shortoid
| Description | Length of dynamic OID. Sets the number of digits for the OID component appended to the MIB based OID.
|
| Default | false |
jeus.domainadminserver.deploy.socket
| Description | Maximum number of socket connections for deployment. Applications can be deployed from DAS to Managed Servers(MSs) in parallel by using multiple connections to reduce the boot time. DAS is simultaneously connected to multiple MSs. When the maximum number of connections in DAS is reached and there are application deployment requests from other MSs, the MS uses only one connection to receive the applications in order. |
| Default | 100 |
jeus.managedserver.deploy.socket
| Description | Maximum number of boot time deploy connections used when applications are deployed in parallel to an MS from DAS. Note, if too many connections are configured for an MS, other MSs can be affected because the number of connections to DAS is limited. When application deployment is complete, the connection is released and the number of available connections in DAS increments. Even if the specified number is big, the actual number of connections is automatically reduced to the number of applications. |
| Default | 5 |
jeus.logging.useAsync
| Description | For more information about properties, refer to JEUS Server Guide. "8.1. Overview". |
| Default | true |
jeus.access.logging.skip.when.busy
| Description | Option to apply when jeus.logging.useAsync is "true". For more information about properties, refer to JEUS Server Guide. "8.1. Overview". |
| Default | false |
jeus.jmx.ping.period
| Description | Interval of ping used when checking connection status in JMX connection. |
| Default | 15000 (Unit: ms) |
jeus.jmx.ping.timeout
| Description | Timeout of ping used when checking connection status in JMX connection. If a response is not received within the timeout after sending a ping, then it is determined that there is a connection error and generates an IOException. |
| Default | 15000 (Unit: ms) |
For more information about jeus.server.memorymonitor.enabled, jeus.server.memorymonitor.ratio, jeus.server.memorymonitor.interval, jeus.server.memorymonitor.duration, jeus.server.enable.restart.in.memory.shortage properties, refer to JEUS Server Guide. "3.4.2. Memory Usage Control".
This chapter describes the network system properties.
jeus.server.checktmout
| Description | Timeout (ms) for RMI Connection or JMX Connector that manages JEUS. |
| Default | 60 * 1000 (Unit: ms) |
jeus.net.crosswait
| Description | Timeout (ms) for a process, whose connection request has already been rejected, to wait for a cross connection to be established after the other server has issued a connection request. |
| Default | 10000 (Unit: ms) |
jeus.net.timewait
| Description | Timeout (ms) for sending the CLOSE message. If specified time is too short, an IOException can be triggered even after a successful execution. |
| Default | 10000 (Unit: ms) |
jeus.net.tcpbuffer
| Description | TCP buffer size of the JEUS operating environment. Since this value is used as the read buffer size of JEUS servers, it must be accurate in order to guarantee the best I/O performance. |
| Default | 8*1024 (Unit: byte) |
jeus.net.recvbuffer
| Description | TCP receive buffer size of the JEUS server environment. |
jeus.net.sendbuffer
| Description | TCP send buffer size of the JEUS client environment. |
jeus.net.busywrite
| Description | Number of attempts to execute non-blocking writes without using the selector. Except for when the receiver doesn't execute reads, this improves performance because select() is not called during the specified number of attempts. |
| Default | 2 |
jeus.net.msg.max
| Description | Maximum size of a single message that can be transmitted using the JEUS protocol. If the message size exceeds the maximum size, an Exception occurs on the receiving end and the connection is lost. |
| Default | 5 * 1000 * 1000 (Unit: byte) |
jeus.net.ping.enable
| Description | Option to use the bi-directional ping function. |
| Default | false |
jeus.net.ping.timeout
| Description | Timeout for the reply of a ping message. |
| Default | 60*1000 (Unit: ms) |
jeus.net.ping.period
| Description | Interval for sending a ping message. If this value is set to 0, ping is not sent to the other node to check whether it is alive. |
| Default | 10*60*1000 (Unit: ms) |
jeus.net.nio.select.limit
| Description | Option to replace the current object with a new Selector object if the number of consecutive failures of the select() call exceeds the limit during non-blocking writes. |
| Default | 5 |
jeus.net.nio.write.limit
| Description | Total message size allowed to accumulate in the write queue until the write threads running in non-blocking mode are blocked. If the queue size exceeds the specified limit, write threads are blocked. |
| Default | 10* 1024 (Unit: byte) |
jeus.net.nio.write.restart
| Description | Total message size accumulated in the write queue when write threads, running in non-blocking mode, are restarted. If the write queue size becomes smaller than the specified byte after a write event, all blocked write threads are restarted. |
| Default | 3*1024 (Unit: byte) |
jeus.net.nio.write.repeat.count
| Description | Number of write attempts allowed for a single message. This is useful when a message in a socket is so large that the selector thread cannot write messages in other sockets. Note, if this option is enabled and all the messages in the socket are large, the response time can increase. |
| Default | -1(infinite) |
jeus.net.reuseAddress
| Description | SO_REUSEADDR of the server socket. |
| Default | false |
jeus.ssl.enabledProtocols
| Description | SSL protocol versions to be used for SSL authentication. Protocol versions are delimited by a comma (,). |
| Default | null |
jeus.net.client.use-ssl
| Description | Option (for a client that connects to JEUS) to use SSL. Other configurations must be set with separate system properties. |
| Default | false |
jeus.net.client.ssl-properties-file
| Description | Properties file that contains configurations to be used for a client that connects to JEUS. |
| Default | null |
jeus.ssl.keystore or javax.net.ssl.keyStore
| Description | Keystore path to be used for SSL authentication. |
jeus.ssl.keypass or javax.net.ssl.keyStorePassword
| Description | Password of the Keystore to be used for SSL authentication. |
jeus.ssl.keystorepass
| Description | Key password of the Keystore to be used for SSL authentication. |
jeus.ssl.truststore or javax.net.ssl.TrustStore
| Description | Path of the Truststore to be used for SSL authentication. |
jeus.ssl.trustpass or javax.net.ssl.TrustStorePassword
| Description | Password of the Truststore to be used for SSL authentication. |
This chapter describes JNDI system properties.
java.naming.factory.initial (Required)
| Description | InitialContext factory class name for the JNDI service provider. InitialContext is created through this factory class. JEUS InitialContext is created by setting this property to jeus.jndi.JNSContextFactory. |
| Default | jeus.jndi.JNSContextFactory |
java.naming.factory.url.pkgs
| Description | Option to enable JNDI look up in JEUS InitialContext using URL schema. |
| Default | jeus.jndi.jns.url |
java.naming.provider.url
| Description | DNS host name and the port of the server that provides JNDI service. Set this variable to the IP address of JEUS JNSServer. When making a JNDI request to the clustered MSs, the addresses of all clustered servers must be listed using a comma (,) as a delimiter. ex) yohan:9736, yohan1:9836 |
| Default | 127.0.0.1:9736 |
java.naming.security.principal
| Description | User name authenticated by the JEUS Naming Server. If the user name is not set, "anonymous" is used. The user name must be defined in the JEUS Security Domain. |
| Default | anonymous |
java.naming.security.credentials
| Description | Password authenticated by the JEUS Naming Server. |
| Default | N/A |
jeus.jndi.jns.resolution
| Description | Interval at which JNSLocal checks resources. |
| Default | 30 * 1000 (Unit: ms) |
jeus.jndi.jns.connecttimeout
| Description | Timeout for JNSLocal to connect to JNSServer. Connection is retried during the timeout period. When the time expires, the jeus.net.ConnectException is thrown. |
| Default | 0 (infinite, may vary by OS) (Unit: ms) |
jeus.jndi.jns.connectionduration
| Description | Period in which the connection from JNSLocal to JNSServer is maintained. If a connection is not used within the time period, the connection is automatically terminated. The default value is zero (the connection is maintained indefinitely). |
| Default | 0 (Unit: ms) |
jeus.jndi.local.tmout
| Description | Period in which to receive a reply for a JNSClient request. If there is no response from the JNSServer, jeus.util.WaitTimeoutException is thrown. |
| Default | 20 * 1000 (Unit: ms) |
jeus.jndi.cluster.recheckto
| Description | Interval at which whether the failed server was recovered is checked, when using the JEUSClusterContext. |
| Default | 300 * 1000 (Unit: ms) |
jeus.jndi.clusterlink.selection-policy
| Description | Policy for determining the server from which an object is retrieved and for selecting the EJB engine when EJB 2.x is enabled. The setting in the properties file is overridden by the one in the hash table. Input options:
|
| Default | locallinkPreference |
jeus.jndi.enable.cache
| Description | Option to enable cache in JNDI clients (JNSClient).
|
| Default | true |
jeus.jndi.jns.replicatebindings
| Description | Option to share the bound object among the clustered MSs.
|
| Default | true |
jeus.jndi.jns.cachebindings
| Description | Option to cache an object after it is bound to JNSServer.
|
| Default | true |
jeus.jndi.jns.localbindings
| Description | Object is bound only to the local JNSClient.
|
| Default | false |
jeus.jndi.compat
| Description | JNDI compatibility setting. Option to provide JNDI services between a version earlier than JEUS 7 Fix#2 and JEUS 7 Fix#2 or later.
|
| Default | false |
This chapter describes transaction system properties.
jeus.tm.forcedReg
| Description | Option to determine how a sub-coordinator registers a transaction with the root coordinator.
|
| Default | true |
jeus.tm.checkReg
| Description | Option to check whether a subcoordinator successfully registered with the root coordinator. |
| Default | true |
jeus.tm.disableJoin
| Description | Option to join the resources from the same RM. |
| Default | false |
jeus.tm.noLogging
| Description | Option to store transaction information to be used by the transaction manager for recovery.
|
| Default | false |
jeus.tm.ignore.broken.log.file
| Description | With this option set to true, if the TM log file is broken and makes recovery impossible, JEUS detects the broken file and deletes the entire file. If recovery is attempted while the file broken, boot fails, which makes recovery unnecessary due to the broken file. Use this option when booting must be successful. |
| Default | false |
jeus.tm.removeIncompleteTx
| Description | Option to delete an XA resource from the recovery list after recovery is completed. To recover manually, set the value to false. |
| Default | false |
jeus.tm.recoveryTrial
| Description | Number of retries to recover the failed recovery resources. Recovery retries operate as a background job. |
| Default | 30 |
jeus.tm.recoveryInterval
| Description | Interval at which recovery of failed resources are attempted. |
| Default | 120000 (Unit: ms) |
jeus.tm.destroy-timeout
| Description | When a transaction timeout is reached and a commit or rollback command is not received, transaction manager keeps the resource. Period in which to enable a cleanup job for the transaction. If timeout occurs, the destroy command is internally executed. Terminating executions are internally enabled for the transaction. |
| Default | 1800000 (Unit: ms) |
jeus.tm.destroy-timeout-check-interval
| Description | Interval at which the destroy timeout process is checked. Operation of jeus.tm.destroy-timeout is checked at the specified interval. |
| Default | 1800000 (Unit: ms) |
jeus.tm.ots.recoveryInterval
| Description | Interval at which OTS recovery is retried when the coordinator is not ready (msec). |
| Default | 10000 (Unit: ms) |
jeus.tm.ots.decisionTO
| Description | Period in which to commit or rollback a transaction after the transaction is distributed and prepared for OTS. |
| Default | 60000 (Unit: ms) |
jeus.tm.net.address-mapping-properties
| Description | File that contains the mappings of IP addresses to JEUS TM. For more information, refer to JEUS Server Guide. "7.7. Transaction Communication Problem between Servers with Different IP Bands". |
| Default | Location of the file must be specified to use this function. |
jeus.tm.profile.classes
| Description | ProfileListener classes to be used for TM Profile. For more information about profiles, refer to JEUS Server Guide. "7.6. Transaction Profile Function". |
| Default | None |
Specifies system properties for client programs to use TM.
jeus.tm.not_use
| Description | Input options:
|
| Default | false |
jeus.tm.version
| Description | TM runtime version.
|
| Default | client |
jeus.tm.port
| Description | TCP/IP port number to be used by the JEUS transaction manager. |
jeus.tm.usenio
| Description | Option to determine the I/O method between transaction managers.
|
| Default | true |
jeus.tm.tmMin
| Description | Minimum size of the thread pool to be used by transactions. |
| Default | 2 |
jeus.tm.tmMax
| Description | Maximum size of the thread pool used by transactions. |
| Default | 30 |
jeus.tm.activeto
| Description | Period in which to commit or roll back after the transaction starts. If timeout occurs, the transaction is rolled back forcibly. |
| Default | 600000 (Unit: ms) |
jeus.tm.prepareto
| Description | Period in which the root coordinator receives a Preparation Completed signal from a subcoordinator. If timeout occurs, the transaction is rolled back forcibly. |
| Default | 120000 (Unit: ms) |
jeus.tm.preparedto
| Description | Period in which a subcoordinator waits for a decision after sending a Preparation Completed signal to the root coordinator. If timeout occurs, the subcoordinator continuously sends a Waiting for Decision signal to the root coordinator. |
| Default | 60000 (Unit: ms) |
jeus.tm.committo
| Description | Period in which the root coordinator receives a response from a subcoordinator after sending a commit signal to the subcoordinator. If timeout occurs, the transaction is marked as an unresolved transaction. |
| Default | 240000 (Unit: ms) |
jeus.tm.recoveryto
| Description | Period in which the root coordinator receives recovery information from a subcoordinator. If timeout occurs, the transaction is not processed. |
| Default | 120000 (Unit: ms) |
jeus.tm.incomplete.to
| Description | Period in which to save unresolved transactions. |
| Default | 86400000 (Unit: ms) |
jeus.tm.propagation.recalculated-timeout
| Description | Recalculated time period sent when transmitting a transaction to another container. It is calculated by subtracting the time period consumed before the transaction is actually transmitted from the active timeout period. This function is available in JEUS 6 Fix#9. Set this option to "false" for backward compatibility. |
| Default | false |
All properties provided by Web engines apply not only to the JVM system but also to virtual hosts and web applications. For more information, refer to JEUS Web Engine Guide. "5.4. Configuring Virtual Hosts", JEUS Web Engine Guide. "5.4. Configuring Virtual Hosts", and JEUS Web Engine Guide. "3.3.1. jeus-web-dd.xml Configurations".
It is recommended to configure web engine properties at the virtual host or Web application level rather than at the JVM system or web engine level.
This section describes the properties set at the web engine level, which can be set in domain.xml. The values set in these properties override those of jeus-web-dd.xml.
jeus.servlet.prevent-forcibly-threadlocal-memoryleak
| Description | If a web application uses the ThreadLocal variable and does not release it, a memory leak can occur. In this case, a web engine can forcibly reset the ThreadLocal variable when the web application is reloaded, redeployed, or undeployed to prevent a memory leak. Note, if this option is used, the ThreadLocal variable, which is set by another application, is also reset. |
| Default | false |
jeus.servlet.webadmin.suspendCmd.tmout
| Description | Period in which to receive the SUSPEND signal from WebtoB and go into the SUSPEND WAIT state after sending the SUSPEND signal to WebtoB. |
| Default | 120000L |
jeus.servlet.request.enableDns
| Description | Option to receive a host name through DNS when invoking ServletRequest.getRemoteHost(). |
| Default | true |
jeus.servlet.loader.jspcount
| Description | Number of JSPs to simultaneously load in a web engine. |
| Default | 0 |
jeus.servlet.useCaseInsensitiveFileSystem
| Description | In an environment where a case-sensitive OS is used along with a case-insensitive file server (e.g., Linux OS and Windows file server), the request address becomes case-insensitive, which causes an abnormal operation. To avoid this problem, use this property, which guarantees case-sensitive operations. With this property, the following properties that are supported only in Windows can be used:
|
| Default | false |
The following is an option that must be set only with a JVM system property.
org.glassfish.web.rfc2109_cookie_names_enforced
| Description | IllegalArgumentException occurs when a character not allowed in RFC2109 is entered in a cookie name. This is defined in javax.servlet.http.Cookie, but wasn't properly processed in API implementation up to JEUS 6. |
| Default | true |
Properties can be set in a virtual host. These properties override the values in jeus-web-dd.xml.
Currently, the properties for this level are under development.
This section describes the web application level properties, which can be set in jeus-web-dd.xml. These properties can be used as web engine or virtual host level properties.
jeus.application.login.key
| Description | Sets the attribute key to be used for login when using Jeus Login Manager. |
| Default | JEUS_LOGIN_KEY |
The following is a list of properties that apply to each servlet or JSP engine.
jeus.servlet.response.cookie.version0Style
| Description | Option to use version0-style cookie headers. |
| Default | false |
jeus.servlet.welcomefile.sendRedirect
| Description | Option to send welcome files through HttpServletResponse.sendRedirect().
|
| Default | false |
jeus.servlet.filter.applyOnWelcomeFileRequest
| Description | Option to apply filters when processing the welcome file for the Context root request. |
| Default | true |
jeus.servlet.response.header.serverInfo
| Description | Option to include JEUS version information in headers. |
| Default | false |
jeus.servlet.keep-original-request-on-forward
| Description | Like Tomcat, does not change information, such as Request URI and path, which are set in Original Request. |
| Default | false |
jeus.servlet.keep-original-query-string-on-forward
| Description | Option to preserve the existing string in the Request object or to overwrite it with the query string when forwarding. |
| Default | false |
jeus.servlet.keep-original-query-string-on-include
| Description | Option to preserve the existing string in the Request object or to overwrite it with the query string when including. |
| Default | false |
jeus.servlet.out.ensureContentOrder
| Description | Option to maintain the content order when using response.getOutputStream(), response.getWriter(), and JspWriter(jsp out) together. They shouldn't be used together, but instead used as one. |
| Default | false |
jeus.servlet.classloader.allowServletAPI
| Description | Option to load the servlet API classes. |
| Default | false |
jeus.servlet.response.useRequestHttpVersion
| Description | Option to set the HTTP version of the HTTP response header to the HTTP client version. This setting replaces the previous jeus.servlet.response.force-response-10 setting. |
| Default | false |
jeus.servlet.context.attribute.serialize
| Description | Option to serialize ServletContext attributes when reloading Context Auto. |
| Default | false |
jeus.servlet.resource.ignore-filename-case
| Description | Option to use upper case and lower case letters for resource file names of ResourceServlet. This is applicable only in Windows or when jeus.servlet.useCaseInsensitiveFileSystem is true. |
| Default | false |
jeus.servlet.response.header.encoding
| Description | Sets the encoding to be used in response headers. |
| Default | null |
jeus.servlet.scan-servlet-container-initializers
| Description | Option to use ServletContainerInitializer, which was added in Servlet 3.0. In order to conform to the servlet standard, the scan job is executed by default, but the deployment time can increase. |
| Default | true |
jeus.servlet.sortWebinfLibraries
| Description | Option for sorting when loading jar files included in WEB-INF/lib .
|
| Default | null |
jeus.servlet.useMetadataCompleteDeploy
| Description | From Java EE 5 onward, when a web application is deployed, it is made so that the annotations defined in Java EE search defined classes. It may take a long time to deploy since the class files included in WEB-INF/lib must be searched, in addition to the class files in WEB-INF/classes. To not search class files, users must change the metadata-complete configuration of web.xml to "true". The metadata-complete configuration can be set to "true" by adding jeus-web-dd.xml instead of modifying web.xml included in the application. |
| Default | false |
jeus.servlet.jsp.allowOnlyStandardizedMethod
| Description | Allows the following 8 HTTP methods for JSP or resource requests: GET, HEAD, POST, OPTIONS, PUT, DELETE, TRACE, and CONNECT. |
| Default | false |
The following is a list of properties that apply only to JSP engines.
jeus.servlet.jsp.reload
| Description | Option to support JSP reloading. |
| Default | true |
jeus.servlet.jsp.precompile
| Description | Option to support the JSP precompile function (a function that only compiles when calling JSP according to the precompile request parameters.) |
| Default | true |
jeus.servlet.jsp.print.null.as.emptystring
| Description | Option to use empty strings when displaying null. |
| Default | false |
jeus.servlet.jsp.jspwriter.null
| Description | Character string that replaces a null. |
| Default | null |
jeus.servlet.jsp.compile.retrycount
| Description | Number of recompilation attempts allowed after a new servlet fails to load. |
| Default | 2 |
jeus.servlet.jsp.compile.delay
| Description | Period JSP compilation is delayed when uploading via FTP. |
| Default | 0L (Unit: ms) |
jeus.servlet.jsp.helpReloadNativeLibrariesByCallingSystemGC
| Description | Handles the JVMs whose native libraries are not properly cleaned while JSPs are being reloaded. The native libraries are cleaned up when garbage collection (GC) is performed on the JSP class loader, so JEUS can only call System.gc() and cannot guarantee 100% GC. Therefore, a reload can fail if System.loadLibrary() is used within the JSP. |
| Default | false |
This property value calls System.gc() and System.runFinalization(), which can degrade performance. It is not recommended to modify JSPs that use native libraries while operating the system. Instead, it is recommended to create a web application that uses the native library and dispatches it to the application. The web application, however, must not perform the Context Auto Reload or redeploy.
jeus.servlet.jsp.ignore-filename-case
| Description | Option to use upper case and lower case letters for the JSP file name. This is applicable only in Windows or when jeus.servlet.useCaseInsensitiveFileSystem is true. |
| Default | false |
jeus.servlet.jsp.assure-utf8-file-encoding-detection
| Description | Treats JSP file encodings as UTP-8 even if Jasper does not recognizes it as UTP-8. |
| Default | false |
It is recommended to define the pageEncoding tag included JSP files.
JEUS conforms to servlet and JSP standards by default. However, API operations can change due to a standard interpretation error, incorrect implementation of requirements, unclear descriptions, and inconsistent descriptions in the standard documents and the API documents.
jeus.servlet.jsp.modern
| Description | Option to use JSP engine, which is compatible with JEUS 4. Only the JSP 1.2 version is supported. The JSP engine is deprecated, so its use is not recommended. This property will be removed from the next fix or version. |
| Default | true |
jeus.servlet.request.url.allowNonStandardPercentCharacterUsage
| Description | Allows use of a single '%' in a URL. According to RFC 2396, 2.4.3. Excluded US-ASCII Characters, a single '%' is a reserved word for URL escape, so it must be used in a defined format. Therefore, clients have to send it as '%25'. |
| Default | false |
jeus.servlet.request.6CompatibleSetCharacterEncoding
| Description | The ServletRequest.setCharacterEncoding() encoding set must only apply to Request Body. In JEUS 6, a bug was found that allows the use of the encoding when reading Request Headers such as Query String and Cookie. Use this option when supporting applications written based on the JEUS 6 bug to avoid modifications to the application. |
| Default | false |
jeus.servlet.response.defaultContentType
| Description | Default value of Content-Type response headers. If this value is not NULL, response headers are set in the following cases: when calling ServletResponse.setCharacterEncoding() or ServletResponse.setLocale() and servlet did not call ServletResponse.setContentType() explicitly. However, this operation does not conform to the servlet standard for Content-Type response headers. |
| Default | null |
According to servlet standards, Content-Type Header cannot be included in response headers unless servlet explicitly calls ServletResponse.setContentType(). Also, when calling ServletResponse.getContentType(), null must be returned. Although these items are defined in Servlet 2.3, JEUS does not follow these rules.
For JEUS 7 Fix#1 and later, the default value is changed to null to conform to the standard. If null is not returned, change the value of this property.
jeus.servlet.response.applyContentLanguageProperlyWithSetLocaleAPI
| Description | When ServletResponse.setLocale() is called after ServletResponse.getWriter() is called, Content-Language response headers must be set. Character encoding is not changed. If Content-Language is specified incorrectly and must be invalidated, set this option to false. |
| Default | true |
jeus.servlet.response.6CompatibleForcedEncoding
| Description | Forces the priority of <response-encoding><forced>, which is being applied, to follow JEUS 6 operation rules. Generally, a forced option has the highest priority. This property has a higher priority than the JSP file page tag contentType or the HTTP response encoding set through the application API. |
| Default | false |
jeus.servlet.response.6CompatibleSetCharacterEncoding
| Description | The encoding set by ServletResponse.setCharacterEncoding() must have a lower priority than forced options. JEUS 6 and previous versions, however, do not comply with this rule and ignore forced settings. To use any applications implemented based on JEUS 6 operation rules, set this option to true. Although this property name is similar to that of the request version, the properties operate very differently. |
| Default | false |
jeus.servlet.session.invalidateBySetMaxInactiveIntervalZero
| Description | It provides compatibility between "0" and invalidate. HttpSession.setMaxInactiveInterval( int timeout ) indicates a session that does not delete values under "0" according to the specification. However, because the description of the property in the previous specification was unclear, some users used "0" as invalidate. The JEUS property is provided for compatibility for these users. |
| Default | false |
jeus.servlet.engine.disableRequestFinishCheck
| Description | A request object is valid only within a service method of a servlet or the doFilter method of a filter. If a request object that has already been handled is used, IllegalStateException occurs, according to the specification. However, since JEUS 7 and previous versions do not check whether a request object has been completed, applications that use a completed request object run normally. This property is used for compatibility between users who use applications that use a completed request object. |
| Default | false |
jeus.servlet.ignoreWebComponentFailureWhenDeploying
| Description | Even if an exception occurs in the init(), Filter.init(), and ServletContextListener of the servlet registered through load-on-startup during deploy, deployment does not fail. |
| Default | false |
This chapter describes session server system properties.
The properties are configured in <properties> under the <session-cluster> section.
jeus.sessionmanager.receive.backup.despite.no.deploy
| Description | In DOMAIN_WIDE mode, even if an application is not deployed, a dummy application is deployed so that its backup can be received from a remote. |
| Default | false |
jeus.sessionmanager.cluster.stable.waiting.sec
| Description | Length of time during which the deployment of an application is delayed to finish processing a cluster event. |
| Default | 0 (Unit: second) |
jeus.sessiomanager.dumpbackup.max
| Description | Count unit for dumpbackup. If the server to be backed up restarts, dumpbackup is performed. In this case, if the server has too many sessions, divide the sessions into uniform units of size and then perform backup. If this property is set in Session Cluster, it will be applied to all clusters. If it is set in Session Cluster Config, it will be applied only to a corresponding cluster. |
| Default | 100 |
This chapter describes EJB system properties.
The following describes EJB system properties.
jeus.ejb.transaction.attribute.default
| Description | Attribute used when the transaction attribute is not set in the Container-Managed Transaction Bean method. Input options:
The following are the priorities.
|
| Default |
|
jeus.ejb.sharedcolumn.modify
| Description | Determines whether a transaction can modify both cmp and cmr fields that share columns in CMP Entity Bean. |
| Default | false |
jeus.ejb.checkTable
| Description | Option to ensure the database has tables of columns for deploying CMP Entity Bean. |
| Default | false |
jeus.ejb.enable.configDeleteOption
| Description | Option to allow DB tables to be deleted when undeploying CMP Entity Bean.
|
| Default | false |
jeus.ejb.csi.trusthosts
| Description | Trust host for using COBRA CSIv2. |
jeus.client.interop
| Description | Option to use COBRA interoperability for a client JVM. |
| Default | false |
jeus.ejb.csi.defaultUser
| Description | Default user for using COBRA CSIv2. |
jeus.ejb.notreload
| Description | List of web modules excluded from Reload when an EJB, which uses a shared classloader, is deployed, undeployed, or redeployed. The format is as follows: context_name1;context_name2 |
jeus.corba.props
| Description | Properties of ORB used by EJB. key=value[,key=value]* |
jeus.ejb.cluster.useip
| Description | Option to choose an IP address or a host name as the address used to connect to the server when an EJB uses an Active Stub. Use the IP specified in jeus.net.localip. If this option is set to true, classftp also uses the IP address as its address. |
| Default | false |
jeus.ejb.all.disconnect
| Description | Disconnection timeout applied to all bean types (Unit: ms). If set to -1, the disconnect function is not used. [Deprecated] This property can be specified using @StatefulTimeout or <stateful-timeout> of ejb-jar.xml in EJB 3.1 spec. |
| Default | 3600000 (Unit: ms) |
jeus.ejb.entity.disconnect
| Description | Disconnect timeout to be applied to entity beans (Unit: ms). This overrides the properties of jeus.ejb.all.disconnect. If set to -1, the disconnect function is not used. |
jeus.ejb.stateful.disconnect
| Description | Disconnect timeout to be applied to stateful session beans (Unit: ms). This overrides the properties of jeus.ejb.all.disconnect. If set to -1, the disconnect function is not used. [Deprecated] This property can be specified using @StatefulTimeout or <stateful-timeout> of ejb-jar.xml in EJB 3.1 spec. |
jeus.ejb.all.passivate
| Description | Inactivation timeout applied to all bean types (Unit: ms). If set to -1, the disconnect function is not used. |
| Default | 300000 (Unit: ms) |
jeus.ejb.entity.passivate
| Description | Passivation timeout applied to entity beans (Unit: ms). This overrides the properties of jeus.ejb.all.passivate. If set to -1, the disconnect function is not used. |
jeus.ejb.stateful.passivate
| Description | Passivation timeout (ms) applied to Stateful Session Beans (Unit: ms). This overrides the properties of jeus.ejb.all.passivate. If set to -1, the disconnect function is not used. |
jeus.ejb.exportPort
| Description | Default export port used in EJB. The EJB with an export port of 0 in the jeus-ejb-dd.xml uses this property. If set to 0, the EJB uses the default port provided by RMI. |
| Default | Managed Server base port + 7 |
jeus.ejb.jeusrmi.exportPort
| Description | Sets the default export port of EJB, which uses JEUS RMI. If this value is set, the EJB with an export port of 0 in jeus-ejb-dd.xml uses this value. |
| Default | Managed Server base port + 11 |
jeus.ejb.entity.lock-wait-timeout
| Description | Period in which to wait for a lock when the same entity is used. It applies to SINGLE or EXCLUSIVE (Unit: ms). |
| Default | 0 (Infinite) |
jeus.ejb.timer.generate-table-ddl
| Description | Create a DDL file for creating a table to store EJB Timer Handle. This is only for internal use. The file name is createDDL.jdbc, and it is placed in the JEUS execution directory. |
| Default | false |
jeus.ejb.generate-no-interface-view-files
| Description | Creates class files of the EJB Local business interface, which is no-interface-view. The class files are created under the '_generated_' directory. |
| Default | false |
jeus.ejb.cluster.selection-policy
| Description | Policy that defines how to choose among EJB cluster members. (Only available for EJB 3 stateless beans. For details, refer to JEUS EJB Guide. "Chapter 6. EJB Clustering".) Input options:
|
| Default | locallinkPreference |
The following describes the JPA system properties.
jeus.persistence.defaultProvider
| Description | Default Java Persistence API provider class name. |
The following tables describe RMI system properties.
In the following descriptions, [client] indicates a client that makes a RMI call. [server] must be specified in the applications EJB is deployed. For more information about RMI configurations and options, refer to
http://docs.oracle.com/javase/7/docs/technotes/guides/rmi/javarmiproperties.html
http://docs.oracle.com/javase/7/docs/technotes/guides/rmi/sunrmiproperties.html
java.rmi.server.codebase
| Description | [server] Codebase used in class annotation when RMI must be sent to classes other than the EJB Bean class. |
java.rmi.server.hostname
| Description | [server] Host name used by a client to access the server. This property has a lower priority than java.rmi.server.useLocalHostName. |
| Default | ip |
jeus.ejb.rmi.jeus
| Description | [server] Option to use JEUS RMI. RMI properties can be applied to each bean individually using jeus-ejb-dd.xml/jeus-bean/jeus-rmi. This option is used to apply RMI settings to all EJBs. The settings in the DD file override this property. |
| Default | false |
jeus.ejb.rmi.socketfactory
| Description | [client/server] Fully qualified name of the RMISocketFactory class used by JEUS. The specified class is used in EJB and all RMI communication. Clients must use the same RMISocketFactory to communicate. This class must provide a no-argument constructor, which can be located in JEUS_HOME/lib/application. |
| Default | jeus.ejb.util.EJBRMISocketFactory |
jeus.ejb.operationTimeout
| Description | [client] Maximum wait time for remote call responses (SoTimeout). JEUS overwrites the sun.rmi.transport.tcp.responseTimeout value. |
| Default | 5 * 60 * 1000 |
sun.rmi.transport.connectionTimeout
| Description | [client] Maximum idle time of the client RMI connection (KeepAliveTimeout). |
| Default | 15 * 1000 |
sun.rmi.transport.tcp.readTimeout
| Description | [server] Maximum wait time for the server to read a client request (SoTimeout). This property must be greater than the jeus.ejb.operationTimeout property (sun.rmi.transport.tcp.responseTimeout) value, which is the SoTimeOut property of the client. |
| Default | 2 * 60 * 60 * 1000 |
sun.rmi.transport.tcp.maxConnectionThreads
| Description | [server] Maximum number of threads used to process connection requests on the server. <thread-max> is a JEUS-related setting specified in jeus-ejb-dd.xml for each bean. <thread-max> is the number of threads that can be assigned for each bean. The value specified in <thread-max> overrides the maxConnectionThreads value. For example, there are two beans: EJB A and EJB B. If <thread-max> is set to the default value of 100, even if maxConnectionThreads is set to Integer.MAX_VALUE, the number of threads is limited to 200. |
| Default | Integer.MAX_VALUE |
sun.rmi.transport.tcp.threadKeepAliveTime
| Description | [server] Maximum wait time for a thread to receive the next request after processing a request (in idle state). (KeepAliveTimeout). |
| Default | 1*60*1000 |
jeus.ejb.compiler.rmic.fork
| Description | [server] Option to fork an RMIC compiler process when creating IIOP classes. |
| Default | false |
jeus.ejb.compiler.rmic.verbose
| Description | [server] Option to keep verbose logs when creating IIOP classes. |
| Default | false |
jeus.ejb.compiler.rmic.vcompat
| Description | Option to use the RMI 1.1, 1.2 compatible protocol when compiling IIOP. |
| Default | false |
jeus.ejb.compiler.rmic.enable
| Description | Option to create the IIOP Stub file. In general, the IIOP Stub file is not required. |
| Default | false |
jeus.ejb.compiler.class.version
| Description | [server] Option to configure the source and target versions when compiling a new EJB class. |
| Default | 1.4 |
jeus.ejb.compiler.use-java-compiler-api
| Description | Uses Java Compiler API, which is provided in JDK 6. This is used by default. To directly compile Sun internal classes, which are a part of the lib/tools.jar file in JDK, set this value to false. This option can be used when compatibility problems occur due to a difference of compiled classes. |
| Default | true |
The following tables describe JEUS RMI system properties.
jeus.rmi.jeusnet
| Description | Option to use JEUS network layer in RMI communication. |
| Default | false |
jeus.rmi.io.type
| Description | I/O type used when JEUS network layer is used. Option to enable blocking or non-blocking communication (blocking/non-blocking). |
| Default | blocking |
jeus.rmi.blocking
| Description | Blocking type used when blocking communication of JEUS Network Layer is used. Option to use a socket or socketChannel (socket/channel). |
| Default | socket |
jeus.rmi.blocking.client.num
| Description | Number of clients when JEUS network layer blocking communication is used. This property applies to the number of thread pools. |
| Default | 50 |
jeus.rmi.channel.buffer.size
| Description | Buffer size when a channel is used. The buffer size can be optimized if the maximum message size is set to the buffer size. |
| Default | The value specified in jeus.net.tcpbuffer. |
jeus.rmi.response.tmout
| Description | Time to wait for a response after RMI sends a request (ms). |
| Default | 600*1000 (Unit: ms) |
jeus.rmi.client.enableProcessPool
| Description | Determines whether client applications deal with messages separately from Read Threads. |
| Default | false |
jeus.rmi.server.enableProcessPool
| Description | Determines whether the server deals with messages separately from Read Threads. |
| Default | false |
jeus.rmi.client.threadPool
| Description | Process Pool size when the enableClientProcessPool property is set to true. |
| Default | 50 |
jeus.rmi.server.threadPool
| Description | Process Pool size when the enableServerProcessPool property is set to true. |
| Default | 50 |
jeus.rmi.usebaseport
| Description | Base port of the Managed Server, which is used as the RMI default port (except for JEUS RMI). |
| Default | false |
This chapter describes security system properties.
The following is a list of Standard Java SE & Java EE security system properties.
java.security.manager
| Description | Option to use the J2SE SecurityManager to improve the security of the JEUS server through code protection. The use of this property can hurt JEUS server performance. By default, SecurityManager is not used by JEUS. |
jeus.security.enable.default.manager
| Description | Prevents the JEUS JVM process from shutting down when System.exit method is called. If -Djeus.security.enable.default.manager=true is set, the JEUS Security Manager extension of Java Security Manager, not JDK, is applied. The JEUS JVM process does not shut down when System.exit method is called from the application program. |
| Default | false |
java.security.policy
| Description | Path to the J2SE policy file used by SecurityManager. |
| Default | JAVA_HOME/lib/security/java.security |
javax.security.jacc.policy.provider
| Description | JACC Policy implementation class name. |
| Default | jeus.security.impl.jacc.JACCPolicyWrapper |
javax.security.jacc.PolicyConfigurationFactory.provider
| Description | JACC PolicyConfigurationFactory implementation class name. |
| Default | jeus.security.impl.jacc.JACCPolicyConfigurationFactoryImpl |
The following is a list of JEUS security system properties.
jeus.security.enable
| Description | Option to install the security server when starting JEUS. |
| Default | true |
jeus.security.default.configDir
| Description | Configuration root directory used by the security system. |
| Default | JEUS_HOME/domains/<domain-name>/config/security |
jeus.security.default.domainName
| Description | Default domain name. |
| Default | SYSTEM_DOMAIN |
jeus.security.installer.classname
jeus.security.jacc.principalRoleMapper
| Description | Name of the class that implements jeus.security.impl.aznrep.JACCPrincipalRoleMapper. This class handles principal-role mapping for the JACC Provider. |
| Default | jeus.security.impl.jacc.JACCDefaultPrincipalRoleMapper |
jeus.net.ssl.security
| Description | Option to use SSL in security communication. |
| Default | false |
jeus.security.keypath
| Description | Location of the security.key file. |
| Default | Configured internally in JEUS. |
jeus.security.master
| Description | Master password. |
| Default | It is recommended that the master password be inputted into a prompt. |
jeus.net.logListenPort
| Description | Option to generate logs for ports when creating a server socket. jeus.security.enable.default.manager=true must be set to enable this option. |
| Default | true |
jeus.net.logConnectInfo
| Description | Option to create logs for the host and port when accessing a socket. jeus.security.enable.default.manager=true must be set to enable this option. |
| Default | false |
jeus.net.logListenStack
| Description | Option to create logs for Thread Stack Trace when creating a server socket. jeus.security.enable.default.manager=true must be set to enable this option. |
| Default | false |
jeus.net.logConnectStack
| Description | Option to create logs for Thread Stack Trace when accessing a socket. jeus.security.enable.default.manager=true must be set to enable this option. |
| Default | false |
jeus.security.keylength
| Description | Key length used for an encryption algorithm such as AES, DES, DESede, SEED, and Blowfish. If the length is set to 256, a 256-bit key is used for an entire system. |
| Default | 256 |
This chapter describes JEUS MQ system properties.
The following is a list of JEUS MQ client system properties.
jeus.jms.client.default-redelivery-limit
| Description | Default value of JMS_JEUS_RedeliveryLimit. Number of redelivery attempts a message can make before an error message is sent to the sender. |
| Default | 3 |
jeus.jms.file.blocksize
| Description | Block size used when sending a file using
FileMessage
(byte). |
| Default | 4096 (Unit: byte) |
jeus.jms.client.connect.timeout
| Description | Period in which the ConnectionFactory.createConnection() method can receive a response from the server. |
| Default | 5000 (Unit: ms) |
jeus.jms.client.workdir
| Description | Directory in which of files received from the server that uses FileMessage are stored. For Java EE clients, this setting is ignored and the path JEUS_HOME/logs/jms/BROKER_NAME\client\ is used. |
| Default | USER_HOME\jeusmq_client_work\ |
jeus.jms.client.maxThread
| Description | Thread pool size used by the JEUS MQ client library. This property is required for the client library to process multiple jobs, such as sending and receiving messages, simultaneously. One thread pool is generated for each connection to the server. |
| Default | 100 |
jeus.jms.client.optimizedProduce
| Description | Option to receive an acknowledgement from the server to improve the performance of message transmissions. If set to true, acknowledgements are not received from the server when receiving a message, even if the approval mode of session is not set to JeusSession.NONE_ACKNOWLEDGE. However, when receiving FileMessage, an acknowledgement is received regardless of this setting. |
| Default | false |
jeus.jms.client.use-single-server-entry
| Description | Determines whether physical connections are shared or not. One ConnectionFactory obtains one physical connection. |
| Default | true |
jeus.jms.client.single-server-entry.shutdown-delay
| Description | Time a shutdown is delayed so a connection can be reused when shared physical connections are no longer used. |
| Default | 600000 (Unit: ms) |
jeus.jms.client.use-pooled-connection-factory
| Description | Option to enable pooling to use previously used client facilities. |
| Default | true |
jeus.jms.client.pooled-connection.check-period
| Description | Period in which to check for the removal of client facilities, for which pooling has been enabled, but are no longer used. |
| Default | 60000 (Unit: ms) |
jeus.jms.client.pooled-connection.unused-timeout
| Description | Period to remove unused client facilities, for which pooling has been enabled. |
| Default | 120000 (Unit: ms) |
jeus.jms.client.send-by-lpq-only
| Description | Options to use the LPQ service to send all messages to improve message reliability. |
| Default | false |
jeus.jms.client.lpq-configuration-path
| Description | LPQ service configuration file path.
|
| Default | 120000 (Unit : ms) |
The following describes JEUS MQ server system properties.
jeus.jms.file.blocksize
| Description | Block size used when sending a file using FileMessage to a client. |
| Default | 4096 (Unit: byte) |
jeus.jms.server.deleteFileMessage
| Description | Option to delete the file from the server after sending FileMessage. |
| Default | true |
jeus.jms.server.discard-stored-on-start
| Description | Option to delete all existing data in the database storage when the JEUS MQ server is started. |
| Default | false |
jeus.jms.server.rowFetchSize
| Description | Number of records to be retrieved at one time when sending a query message to DB storage. |
| Default | 1000 |
jeus.jms.server.create-facility-mbeans
| Description | Option to create MBeans for client facilities including Connection, Session, Message Producer, and Consumer. |
| Default | false |