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
1.11. GMS System Properties

1.1. Overview

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.

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

    DescriptionLocation of JEUS Launcher logs. If not set, logs are created under the JEUS_SERVER_HOME/logs folder.
    Defaultnull
  • 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

    DescriptionInterval for measuring the CPU usage when monitoring the host CPU usage.
    Default60000 (Unit: ms)
  • jeus.server.process.cpumonitor.enabled

    DescriptionOption to enable the monitoring function for measuring the process CPU usage. A thread dump is generated during monitoring.
    Defaultfalse
  • jeus.server.process.cpumonitor.interval

    DescriptionInterval for measuring the CPU usage when monitoring the process CPU usage.
    Default2000 (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.

    Default0.8
  • jeus.server.enable.restart.in.memory.shortage

    Description

    Option to restart the server when there is a memory overflow.

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

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

    Default0 (Unit: ms)
  • jeus.server.configfile.backup.size

    Description

    Number of backup domain.xml files saved during a dynamic update.

    Default50
  • jeus.print-system-properties

    DescriptionOption to output the configured system properties.
    Defaultfalse
  • 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.

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

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

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

    Default5
  • jeus.access.logging.skip.when.busy

    Description

    Option to apply when jeus.logging.useAsync is "true". For more information about properties, refer to JEUS Server Guide. "8.1. Overview".

    Defaultfalse
  • jeus.jmx.ping.period

    Description

    Interval of ping used when checking connection status in JMX connection.

    Default15000 (Unit: ms)
  • jeus.jmx.ping.timeout

    Description

    Timeout of ping used when checking connection status in JMX connection.

    If a response is not received within the timeout after sending a ping, then it is determined that there is a connection error and generates an IOException.

    Default 15000 (Unit: ms)

Note

For more information about jeus.server.memorymonitor.enabled, jeus.server.memorymonitor.ratio, jeus.server.memorymonitor.interval, jeus.server.memorymonitor.duration, jeus.server.enable.restart.in.memory.shortage properties, refer to JEUS Server Guide. "3.4.2. Memory Usage Control".

1.3. Network System Properties

This chapter describes the network system properties.

  • jeus.server.checktmout

    DescriptionTimeout (ms) for RMI Connection or JMX Connector that manages JEUS.
    Default60 * 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.

    Default10000 (Unit: ms)
  • jeus.net.timewait

    DescriptionTimeout (ms) for sending the CLOSE message. If specified time is too short, an IOException can be triggered even after a successful execution.
    Default10000 (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.

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

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

    Default5 * 1000 * 1000 (Unit: byte)
  • jeus.net.ping.enable

    DescriptionOption to use the bi-directional ping function.
    Defaultfalse
  • jeus.net.ping.timeout

    DescriptionTimeout for the reply of a ping message.
    Default60*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.

    Default10*60*1000 (Unit: ms)
  • jeus.net.nio.select.limit

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

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

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

    DescriptionSO_REUSEADDR of the server socket.
    Defaultfalse
  • jeus.net.ssl.protocolVersions

    DescriptionSSL protocol versions to be supported in the SSL engine in JEUS. Each protocol versions are sorted and listed.
    Defaultnull
  • jeus.net.client.use-ssl

    DescriptionOption (for a client that connects to JEUS) to use SSL. Other configurations must be set with separate system properties.
    Defaultfalse
  • jeus.net.client.ssl-properties-file

    Description Properties file that contains configurations to be used for a client that connects to JEUS.
    Defaultnull
  • jeus.ssl.keystore or javax.net.ssl.keyStore

    DescriptionKey Store path to be used in SSL.
    Default JEUS_HOME/domains/<domain-name>/config
  • jeus.ssl.keypass or javax.net.ssl.keyStorePassword

    Description Password of the Key Store to be used in SSL.
    Default jeuskeypass
  • jeus.ssl.keystorepass

    Description Key password of the Key Store to be used in SSL.
    Default jeuskeypass
  • jeus.ssl.truststore or javax.net.ssl.TrustStore

    DescriptionPath of the Trust Store to be used in SSL.
    DefaultJEUS_HOME/domains/<domain-name>/config
  • jeus.ssl.trustpass or javax.net.ssl.TrustStorePassword

    Description Password of the Trust Store to be used in SSL.
    Defaultjeustrustpass

1.4. JNDI System Properties

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

1.5. Transaction System Properties

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

    Description Period in which to save unresolved transactions.
    Default 86400000 (Unit: ms)

  • jeus.tm.propagation.recalculated-timeout

    Description

    Recalculated time period sent when transmitting a transaction to another container. It is calculated by subtracting the time period consumed before the transaction is actually transmitted from the active timeout period.

    This function is available in JEUS v6.0 Fix#9. Set to "false" for backward compatibility.

    Default false

1.6. Web Engine Properties

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", andJEUS 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.

1.6.1. Web Engine Level Properties

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

    DescriptionIf 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.
    Defaultfalse
  • jeus.servlet.webadmin.suspendCmd.tmout

    DescriptionPeriod in which to receive the SUSPEND signal from WebtoB and go into the SUSPEND WAIT state after sending the SUSPEND signal to WebtoB.
    Default120000L
  • jeus.servlet.request.enableDns

    DescriptionOption to receive a host name through DNS when invoking ServletRequest.getRemoteHost().
    Defaulttrue
  • jeus.servlet.loader.jspcount

    DescriptionNumber of JSPs to simultaneously load for each virtual host.
    Default0

The following is an option that must be set only with a JVM system property.

  • org.glassfish.web.rfc2109_cookie_names_enforced

    Description IllegalArgumentException occurs when a character not allowed in RFC2109 is entered in a cookie name. This is defined in javax.servlet.http.Cookie, but wasn't properly processed in API impleementation up to JEUS 6.
    Default true

1.6.2. Virtual Host Level Properties

Properties can be set in a virtual host. These properties override the values in jeus-web-dd.xml.

Note

Currently, the properties for this level are under development.

1.6.3. Web Application Level Properties

This section describes the web application level properties, which can be set in jeus-web-dd.xml. These properties can be used as web engine or virtual host level properties.

  • jeus.application.login.key

    DescriptionSets the attribute key to be used for login when using Jeus Login Manager.
    Default JEUS_LOGIN_KEY

1.6.3.1. JSP or Servlet Engine Properties

The following is a list of properties that apply to each servlet or JSP engine.

  • jeus.servlet.response.cookie.version0Style

    DescriptionOption to use version0-style cookie headers.
    Defaultfalse
  • jeus.servlet.welcomefile.sendRedirect

    Description

    Option to send welcome files through HttpServletResponse.sendRedirect().

    • true: HttpServletResponse.sendRedirect() is used.

    • false: RequestDispatcher.foward() is used.

    Defaultfalse
  • jeus.servlet.filter.applyOnWelcomeFileRequest

    DescriptionOption to apply filters when processing the welcome file for the Context root request.
    Defaulttrue
  • jeus.servlet.response.header.serverInfo

    DescriptionOption to include JEUS version information in headers.
    Defaultfalse
  • jeus.servlet.keep-original-request-on-forward

    DescriptionLike Tomcat, does not change information, such as Request URI and path, which are set in Original Request.
    Defaultfalse
  • jeus.servlet.keep-original-query-string-on-forward

    DescriptionOption to preserve the existing string in the Request object or to overwrite it with the query string when forwarding.
    Defaultfalse
  • jeus.servlet.keep-original-query-string-on-include

    DescriptionOption to preserve the existing string in the Request object or to overwrite it with the query string when including.
    Defaultfalse
  • jeus.servlet.out.ensureContentOrder

    DescriptionOption to maintain the content order when using response.getOutputStream(), response.getWriter(), and JspWriter(jsp out) together. They shouldn't be used together, but instead used as one.
    Defaultfalse
  • jeus.servlet.classloader.allowServletAPI

    DescriptionOption to load the servlet API classes.
    Defaultfalse
  • jeus.servlet.response.useRequestHttpVersion

    DescriptionOption 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.
    Defaultfalse
  • jeus.servlet.context.attribute.serialize

    DescriptionOption to serialize ServletContext attributes when reloading Context Auto.
    Defaultfalse
  • 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.

    Defaultfalse
  • jeus.servlet.response.header.encoding

    Description

    Sets the encoding to be used in response headers.

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

    Defaulttrue
  • jeus.servlet.sortWebinfLibraries

    Description

    Option for sorting when loading jar files included in WEB-INF/lib .

    • name_asc: Name in ascending order.

    • name_dsc: Name in descending order.

    • time_asc: LMF of a file in ascending order.

    • time_dsc: LMF of a file in descending order.

    Default null
  • jeus.servlet.useMetadataCompleteDeploy

    DescriptionFrom Java EE 5 onward, when a web application is deployed, it is made so that the annotations defined in Java EE search defined classes. It may take a long time to deploy since the class files included in WEB-INF/lib must be searched, in addition to the class files in WEB-INF/classes. To not search class files, users must change the metadata-complete configuration of web.xml to "true". The metadata-complete configuration can be set to "true" by adding jeus-web-dd.xml instead of modifying web.xml included in the application.
    Default false
  • jeus.servlet.ignoreWebComponentFailureWhenDeploying

    DescriptionEven if an exception occurs in the init(), Filter.init(), and ServletContextListener of the servlet registered through load-on-startup during deploy, deployment does not fail.
    Default false

1.6.3.2. JSP Engine Properties

The following is a list of properties that apply only to JSP engines.

  • jeus.servlet.jsp.reload

    DescriptionOption to support JSP reloading.
    Defaulttrue
  • jeus.servlet.jsp.precompile

    DescriptionOption to support the JSP precompile function (a function that only compiles when calling JSP according to the precompile request parameters.)
    Defaulttrue
  • jeus.servlet.jsp.print.null.as.emptystring

    DescriptionOption to use empty strings when displaying null.
    Defaultfalse
  • jeus.servlet.jsp.jspwriter.null

    Description Character string that replaces a null
    Defaultnull
  • jeus.servlet.jsp.compile.retrycount

    DescriptionNumber of recompilation attempts allowed after a new servlet fails to load.
    Default2
  • jeus.servlet.jsp.compile.delay

    DescriptionPeriod JSP compilation is delayed when uploading via FTP.
    Default0L (Unit: ms)
  • jeus.servlet.jsp.helpReloadNativeLibrariesByCallingSystemGC

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

    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.

    Defaultfalse
  • jeus.servlet.jsp.assure-utf8-file-encoding-detection

    DescriptionTreats JSP file encodings as UTP-8 even if Jasper does not recognizes it as UTP-8.
    Defaultfalse

    Warning

    It is recommended to define the pageEncoding tag included JSP files.

1.6.3.3. Properties for Compatibility

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.

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

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

    Defaultfalse
  • jeus.servlet.response.defaultContentType

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

    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

    DescriptionWhen 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.
    Defaulttrue
  • jeus.servlet.response.6CompatibleForcedEncoding

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

    Defaultfalse
  • jeus.servlet.session.invalidateBySetMaxInactiveIntervalZero

    Description In the case of HttpSession.setMaxInactiveInterval( int timeout ), it refers to a session that does not delete values under "0" according to the specification. However, since the previous specification was described unclearly, there were users who used "0" as invalidate. This property is provided to provide compatibility for these users.
    Defaultfalse

1.7. Session Server System Properties

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.

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

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

    Defaultfalse
  • jeus.sessionmanager.failback.allow

    Description

    Option for a restarting server to recover sessions from the server it was backed up in.

    By default, recovery is not performed on a backup, but backup is supported during sequential patching in order to prevent session loss. For more information, refer to "Session Management Guide".

    Default false
  • jeus.sessionmanager.prevent.migration

    DescriptionOption for not performing a migration when a session server maintains a session from another server. When sending simultaneous requests for the same session through iframe, prevents sessions from being lost. However, updates are continuously performed for functional reasons, which results in performance degradation.
    Default false

1.8. EJB System Properties

This chapter describes EJB system properties.

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

1.8.2. JPA System Properties

The following describes the JPA system properties.

  • jeus.persistence.defaultProvider

    Description Default Java Persistence API provider class name.

1.8.3. RMI System Properties

The following tables describe RMI system properties.

Note

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

1.9. Security System Properties

This chapter describes security system properties.

1.9.1. Standard Java SE & Java EE 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

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

1.10. JEUS MQ System Properties

This chapter describes JEUS MQ system properties.

1.10.1. JEUS MQ Client

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)

1.10.2. JEUS MQ Server

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

1.11. GMS System Properties

This chapter describes GMS system properties.

  • jeus.gms.pool.min

    DescriptionMinimum number of thread pools used in GMS.
    Default0
  • jeus.gms.pool.max

    Description Maximum number of thread pools used in GMS.
    Default 20
  • jeus.gms.pool.queue

    DescriptionNumber of work queues of a thread pool used in GMS.
    Default 4096
  • jeus.gms.ping.timeout

    Description Ping timeout in which GMS will use for TCP connection between servers.
    Default 30000 (unit: ms)