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 GMS detects a failure. However, if a Java node manager is used, GMS is not used for failure detection. In this case, the auto restart setting 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.ssl.keystore
Description | Path to the keystore file used by SSL. |
Default | JEUS_HOME/domains/<domain-name>/config/keystore |
jeus.ssl.keypass
Description | SSL keystore password. |
Default | jeuskeypass |
jeus.ssl.truststore
Description | File path of the SSL truststore. |
Default | JEUS_HOME/domains/<domain-name>/config/truststore |
jeus.ssl.trustpass
Description | SSL truststore password. |
Default | jeustrustpass |
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. |
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 |
For more information about jeus.server.memorymonitor.enabled, jeus.server.memorymonitor.ratio, jeus.server.memorymonitor.interval, jeus.server.memorymonitor.duration, and 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 |
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 from which server an object is retrieved. Input options:
If not set, the default value may vary according to the jeus.jndi.clusterlink.prefer-local-node setting. |
Default | locallinkPreference |
jeus.jndi.clusterlink.prefer-local-node
Description | Option to use an object on the local node first when looking up an object bound to a clustered Managed Server(MS). The jeus.jndi.clusterlink.selection-policy value overrides this setting if it is set to a value other than 'locallinkPreference'. |
Default | true |
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 Managed Servers.
|
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 v7.0 Fix#2 and a JEUS v7.0 Fix#2 or later.
|
Default | false |
This chapter describes transaction system properties.
jeus.tm.forcedReg
Description | Option to determine how a subcoordinator 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.uncompletedto
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 v6.0 Fix#9. Set 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", JEUS Web Engine Guide. "3.3.1. jeus-web-dd.xml Configurations".
TmaxSoft recommends applying 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.url-blocking-properties
Description | Absolute path to the property file that describes URL patterns to avoid. |
Default | %DOMAIN_HOME%/config/servlet/urlblocking.properties |
jeus.servlet.loader.jspcount
Description | Number of JSPs to simultaneously load for each virtual host. |
Default | 0 |
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.
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.webcontainer.j2ee.compatible.forward
Description | Option to use HttpServletResponse.sendError() when 404 FileNotFoundException is encountered in RequestDispatcher.doForward().
|
Default | true |
jeus.servlet.out.ensureContentOrder
Description | Option to preserve the user-specified output order. |
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.processsendfile
Description | Option to enable the sendfile function for ResourceServlet. |
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. |
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 |
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 | false |
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.jspParam.urlEncode
Description | Option to encode URL parameters. |
Default | true |
jeus.servlet.jsp.helpReloadNativeLibrariesByCallingSystemGC
Description | Handles the JVMs whose native libraries are not properly cleaned while reloading JSPs. The native libraries are cleaned up when GC (Garbage Collection) is performed on the JSP class loader, so JEUS can only call System.gc() and cannot guarantee 100% GC. Therefore, 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. TmaxSoft recommends not modifying JSPs that use native libraries while operating the system. The recommended method is to create a web application that uses the native library and dispatches it to the application. The web application, however, must not 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. |
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, standard document errors, such as unclear descriptions, and unmatched description between standard documents and the API document.
jeus.servlet.jsp.modern
Description | Option to use JSP engine, which is compatible with JEUS 4. Only JSP 1.2 version is supported. The JSP engine is deprecated, so its use is not recommended. |
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.
In JEUS v7.0 Fix#1 and later, the default value was changed to null to conform to the standard. If applications operate based on the previous option, change this property value appropriately.
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 change 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 |
This chapter describes session server system properties.
jeus.sessionserver.backupqueue.max
Description | Maximum number of Backup Queue entries allowed. If the network is instable, backup fails continuously and accumulates in the Backup Queue. Based on this value, responses are no longer sent for Flow Control. |
Default | 40 |
jeus.sessionserver.backupunit
Description | The unit of sessions in which Backup Thread performs backup, and the size of sessions to be entered into the Backup Queue. When sessions reach this value, a backup is not automatically triggered. Backup is performed as a batch job when load is heavy. In normal operation, one session operates and Backup Thread backs up the session. |
Default | 10 |
jeus.sessionserver.dumpbackup.max
Description | The 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. |
Default | 100 |
jeus.session.exclude.das.in.cluster
Description | Exclude DAS from clusters. To use DAS as a manager, exclude DAS from session clusters. This option applies to all http-session-config, session-cluster, and cluster. |
Default | false |
jeus.sessionserver.ignore.flowcontrol
Description | Configure a distributed session server to run services even when the server is not backed up. Distributed session servers can share sessions and respond to errors only when backup is performed by the backup server. Set this option when running basic services is more important than keeping sessions. |
Default | false |
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. Format: 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 |
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/6/docs/technotes/guides/rmi/javarmiproperties.html
http://docs.oracle.com/javase/6/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.useLocalHostName
Description | [server] Accesses the server using the host name instead of the server IP. |
Default | false |
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 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 a 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 |
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.deleteTablesOnStart
Description | Option to delete all existing tables in the database storage when starting JEUS MQ server. |
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 |