Chapter 1. System Properties

Table of Contents

1.1. Overview
1.2. Server System Properties
1.3. Network System Properties
1.4. JNDI System Properties
1.5. Transaction System Properties
1.6. Web Engine Properties
1.6.1. Web Engine Level Properties
1.6.2. Virtual Host Level Properties
1.6.3. Web Application Level Properties
1.7. Session Server System Properties
1.8. EJB System Properties
1.8.1. EJB System Properties
1.8.2. JPA System Properties
1.8.3. RMI System Properties
1.9. Security System Properties
1.9.1. Standard Java SE & Java EE Security System Properties
1.9.2. JEUS Security System Properties
1.10. JEUS MQ System Properties
1.10.1. JEUS MQ Client
1.10.2. JEUS MQ Server

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>
        ...

Caution

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

    DescriptionLocation of JEUS installation files.
    DefaultJEUS 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

    DescriptionOption to output the class path of system Classloader.
    Defaultfalse
  • jeus.server.autorestart

    DescriptionOption 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.
    Defaulttrue
  • jeus.jdk.home

    DescriptionPath to JDK Home directory for javac and tools.jar files.
    DefaultIf not set, 'java.home' is used.
  • jeus.ssl.keystore

    DescriptionPath to the keystore file used by SSL.
    DefaultJEUS_HOME/domains/<domain-name>/config/keystore
  • jeus.ssl.keypass

    DescriptionSSL keystore password.
    Defaultjeuskeypass
  • jeus.ssl.truststore

    DescriptionFile path of the SSL truststore.
    DefaultJEUS_HOME/domains/<domain-name>/config/truststore
  • jeus.ssl.trustpass

    DescriptionSSL truststore password.
    Defaultjeustrustpass
  • 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.

    Defaultjeus
  • 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.

    Defaulttrue
  • 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.

    Default4096
  • 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.

    Default300000 (Unit: ms)
  • jeus.rmi.defaultPort

    DescriptionDefault RMI export port. This property also applies to all EJBs with an unspecified export-port.
    Default- base port + 7
  • jeus.rmi.jeusrmi.defaultPort

    DescriptionDefault 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

    DescriptionSSL keystore for CORBA CSIv2.
    DefaultValue of jeus.net.ssl.keystore.
  • jeus.interop.ssl.keypass

    DescriptionSSL keystore password for CORBA CSIv2.
    DefaultValue of jeus.net.ssl.keypass.
  • jeus.interop.ssl.truststore

    DescriptionSSL truststore for CORBA CSIv2.
    DefaultValue of jeus.net.ssl.truststore
  • jeus.interop.ssl.trustpass

    DescriptionSSL truststore password for CORBA CSIv2.
    DefaultValue of jeus.net.ssl.trustpass
  • jeus.jvm.version

    DescriptionJVM version used by JEUS.
    Defaulthotspot (uses '-server')
  • jeus.server.cpumonitor.enabled

    DescriptionOption to enable the monitoring function for measuring the host CPU usage.
    Defaultfalse
  • 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

    DescriptionOption to enable the monitoring function to measure the server memory usage.
    Defaultfalse
  • jeus.server.memorymonitor.interval

    DescriptionInterval for measuring the memory usage.
    Default2000 (Unit: ms)
  • jeus.server.memorymonitor.duration

    DescriptionMemory overflow duration. If memory overflow occurs during the specified time period, the server is terminated.
    Default60000 (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.

    • true: An MIB based OID is created when static OID is used.

    • false: When dynamic OID is used, an OID is dynamically created according to the object and added as a suffix to the static OID.

    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.

    • true: For a Short OID, an 8-digit ID is appended.

    • false: If not a Short OID, a 32-digit ID is appended.

    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

This chapter describes the network system properties.

  • jeus.server.checktmout

    DescriptionTimeout (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)

    DescriptionInitialContext 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.
    Defaultjeus.jndi.JNSContextFactory
  • java.naming.factory.url.pkgs

    Description Option to enable JNDI look up in JEUS InitialContext using URL schema.
    Defaultjeus.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

    Default127.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.

    Defaultanonymous
  • java.naming.security.credentials

    Description Password authenticated by the JEUS Naming Server.
    DefaultN/A
  • jeus.jndi.jns.resolution

    Description Interval at which JNSLocal checks resources.
    Default30 * 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.

    Default0 (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).

    Default0 (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.
    Default20 * 1000 (Unit: ms)
  • jeus.jndi.cluster.recheckto

    Description Interval at which whether the failed server was recovered is checked, when using the JEUSClusterContext.
    Default300 * 1000 (Unit: ms)
  • jeus.jndi.clusterlink.selection-policy

    Description

    Policy for determining from which server an object is retrieved.

    Input options:

    • LocallinkPreference: Objects are retrieved from a local managed server (MS).

    • RoundRobin: The first request is handled with an object from a randomly selected MS. Subsequent requests are handled with an object from an MS selected in a round robin fashion.

    • Random: One of the clustered servers is randomly selected.

    If not set, the default value may vary according to the jeus.jndi.clusterlink.prefer-local-node setting.

    DefaultlocallinkPreference
  • 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'.

    Defaulttrue
  • jeus.jndi.enable.cache

    Description

    Option to enable cache in JNDI clients (JNSClient).

    • true: Cache is enabled. (Default)

    • false: Cache is disabled.

    Defaulttrue
  • jeus.jndi.jns.replicatebindings

    Description

    Option to share the bound object among the clustered Managed Servers.

    • true: Object is shared. (Default)

    • false: Object is not shared

    Defaulttrue
  • jeus.jndi.jns.cachebindings

    Description

    Option to cache an object after it is bound to JNSServer.

    • true: Object is cached. (Default)

    • false: Object is not cached.

    Defaulttrue
  • jeus.jndi.jns.localbindings

    Description

    Object is bound only to the local JNSClient.

    • true: An object is bound only to the JEUS naming client. The bound object can be used only by clients that make JNDI requests.

    • false: An object is bound to the JEUS naming server. (Default)

    Defaultfalse
  • 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.

    • true: If the JNDI server is a version earlier than JEUS v7.0 Fix#2 and the JNDI client is JEUS v7.0 Fix#2 or later, this property must be set to "true" for JNDI compatibility.

    • false: No JNDI compatibility between a version earlier than JEUS v7.0 Fix#2 and JEUS v7.0 Fix#2 or later.

    Defaultfalse

This chapter describes transaction system properties.

  • jeus.tm.forcedReg

    Description

    Option to determine how a subcoordinator registers a transaction with the root coordinator.

    • true: Registers the transaction immediately when it is connected.

    • false: Registers the transaction only when there is RM.

    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.

    • true: Logs are not stored.

    • false: Logs are stored.

    Default false
  • jeus.tm.ignore.broken.log.file

    DescriptionWith 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)

System Properties for TM Client

Specifies system properties for client programs to use TM.

  • jeus.tm.not_use

    Description

    Input options:

    • true: For a client, this element is used when both JNDI is used and transactions are not used.

    • false: For a client, this element is used when JNDI and transactions are used.

    Default false
  • jeus.tm.version

    Description

    TM runtime version.

    • client: Uses a client TM.

    • server: Uses a server TM.

    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.

    • true: NIO

    • false: Blocking I/O

    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)

System Properties to Ensure Sub Compatibility

  • 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".

Note

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 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().

    • true: HttpServletResponse.sendRedirect() is used.

    • false: RequestDispatcher is used.

    Default false
  • jeus.servlet.filter.applyOnWelcomeFileRequest

    DescriptionOption 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().

    • true: HttpServletResponse.sendError() is executed.

    • false: ServletException is thrown.

    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

    Caution

    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

    Warning

    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

    Note

    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:

    • NotSupported

    • Supports

    • Required

    • RequiresNew

    • Mandatory

    • Never

    The following are the priorities.

    1. ejb-jar/trans-attribute

    2. jeus-ejb-dd/unspecified-container-transaction

    3. System properties

    Default
    • EJB 3.0 bean: Required (specifications based)

    • EJB 3.0 bean and earlier versions: Supported (for backward compatibility)

    • Timer Service method: Not Supported

  • 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.

    • true: <deleting-table> is used.

    • false: <deleting-table> is ignored.

    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 tables describe RMI system properties.

  • 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.
    Default1.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.

    Defaulttrue

When JEUS RMI Is Used

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 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

    Description SecurityInstaller implementation class name.
    Default jeus.security.impl.installer.JeusSecurityDomainInstaller
  • 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.

    • Absolute path: Reads the file in the path.

    • Relative path: Reads the file in following order: APP_HOME/WEB-INF/, APP_HOME/META-INF/, and APP_HOME/.

    Default 120000 (Unit: ms)