1. EJB System Properties

The following describes EJB system properties.

1.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.corba.WorkerThreadInactivityTO

    Description

    Inactive timeout of corba WorkerThread.

    Default

    120000 ms

  • jeus.corba.minWorkerThreads

    Description

    Minimum number of threads in the corba WorkerThreadPool.

    Default

    10

  • jeus.corba.maxWorkerThreads

    Description

    Maximum number of threads created in the corba WorkerThreadPool.

    Default

    1000

  • jeus.corba.iiop.tcpConnectTO

    Description

    Connect timeout of a connection created during the CORBA IIOP communication. The cumulative waiting time settings consist of four integers (unit: ms) separated by colons, indicating the initial waiting time (until reattempt after connection failure), maximum accumulated waiting time, waiting time increment, and maximum single waiting time, respectively.

    Default

    1000:5000:20:2500

  • jeus.corba.iiop.tcpReadTO

    Description

    Read timeout of a connection created during the CORBA IIOP communication. The cumulative waiting time settings consist of four integers (unit: ms) separated by colons, indicating the initial waiting time (until reattempt after connection failure), maximum accumulated waiting time, waiting time increment, and maximum single waiting time, respectively.

    Default

    1000:5000:20:2500

  • jeus.corba.useMetaOperation

    Description

    Option to execute meta operations existing in the CORBA/IIOP specification. These meta operations are executed to resolve differences in EJB method parameter class files between the client and the server.

    Default

    true

  • jeus.corba.clientORBPort

    Description

    ORB port to use in a standalone client. In the case of a meta operation being executed due to differences in EJB method parameter class files between the client and the server, the server will send the request to this designated port. If the default value of 0 is set, a random port will be used.

    Default

    0

  • jeus.ejb.csi.defaultUser

    Description

    Default user for using COBRA CSIv2.

  • jeus.ejb.notreload

    Description

    List of web modules excluded from Reload when an EJB, which uses a shared classloader, is deployed, undeployed, or redeployed.

    The format is as follows:

    context_name1;context_name2

  • jeus.corba.props

    Description

    Properties of ORB used by EJB.

    key=value[,key=value]*

  • jeus.ejb.cluster.useip

    Description

    Option to choose an IP address or a host name as the address used to connect to the server when an EJB uses an Active Stub. Use the IP specified in jeus.net.localip.

    If this option is set to true, classftp also uses the IP address as its address.

    Default

    false

  • jeus.ejb.all.disconnect

    Description

    Disconnection timeout applied to all bean types (Unit: ms).

    If set to -1, the disconnect function is not used.

    [Deprecated] This property can be specified using @StatefulTimeout or <stateful-timeout> of ejb-jar.xml in EJB 3.1 spec.

    Default

    3600000 (Unit: ms)

  • jeus.ejb.entity.disconnect

    Description

    Disconnect timeout to be applied to entity beans (Unit: ms).

    This overrides the properties of jeus.ejb.all.disconnect.

    If set to -1, the disconnect function is not used.

  • jeus.ejb.stateful.disconnect

    Description

    Disconnect timeout to be applied to stateful session beans (Unit: ms).

    This overrides the properties of jeus.ejb.all.disconnect.

    If set to -1, the disconnect function is not used.

    [Deprecated] This property can be specified using @StatefulTimeout or <stateful-timeout> of ejb-jar.xml in EJB 3.1 spec.

  • jeus.ejb.all.passivate

    Description

    Inactivation timeout applied to all bean types (Unit: ms).

    If set to -1, the disconnect function is not used.

    Default

    300000 (Unit: ms)

  • jeus.ejb.entity.passivate

    Description

    Passivation timeout applied to entity beans (Unit: ms).

    This overrides the properties of jeus.ejb.all.passivate.

    If set to -1, the disconnect function is not used.

  • jeus.ejb.stateful.passivate

    Description

    Passivation timeout (ms) applied to Stateful Session Beans (Unit: ms).

    This overrides the properties of jeus.ejb.all.passivate.

    If set to -1, the disconnect function is not used.

  • jeus.ejb.exportPort

    Description

    Default export port used in EJB.

    The EJB with an export port of 0 in the jeus-ejb-dd.xml uses this property.

    If set to 0, the EJB uses the default port provided by RMI.

    Default

    Managed Server base port + 7

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

    Creates a DDL file for creating a table to store EJB Timer Handle.

    This is only for internal use. The file name is createDDL.jdbc, and it is placed in the JEUS execution directory.

    Default

    false

  • jeus.ejb.generate-no-interface-view-files

    Description

    Creates class files of the EJB Local business interface, which is no-interface-view.

    The class files are created under the '_generated_' directory.

    Default

    false

  • jeus.ejb.cluster.selection-policy

    Description

    Policy that defines how to choose among EJB cluster members. (Only available for EJB 3 stateless beans. For details, refer to EJB Clustering in JEUS EJB Guide.

    Input options:

    • locallinkPreference: Selects an EJB member running on the same MS.

    • roundrobin: Arbitrarily selects an EJB member initially and then selects the next available server.

    • random: Arbitrarily selects a cluster server.

    Default

    locallinkPreference

  • jeus.ejb.iiop.usm

    Description

    Option to apply the Servant Manager provided by JEUS when using IIOP EJB.

    When applying the Servant Manager, it intervenes before and after processing the IIOP request and changes the TCCL properly.

    If the class is properly packaged in the application, but the class cannot be found during the process of deserializing parameters when making an IIOP request, you can try this option.

    When applying the option, the IIOP stub code generated by JEUS changes, so when precompiling an EJB to be distributed to a server to which this option is applied, this option must also be applied to the appcompiler.

    Default

    false

1.2. JPA System Properties

The following describes JPA system properties.

  • jeus.persistence.defaultProvider

    Description

    Default Java Persistence API provider class name.

1.3. RMI system properties

The following tables describe RMI system properties.

In the following descriptions, [client] indicates a client that makes a RMI call. [server] must be specified in the applications EJB is deployed. For more information about RMI configurations and options, refer to the following.

  • 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] Host name used by a client to access the server.

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

    Description

    [client/server] Fully qualified name of the RMISocketFactory class used by JEUS. The specified class is used in EJB and all RMI communication.

    Clients must use the same RMISocketFactory to communicate. This class must provide a no-argument constructor, which can be located in JEUS_HOME/lib/application.

    Default

    jeus.ejb.util.EJBRMISocketFactory

  • jeus.ejb.operationTimeout

    Description

    [client] Maximum wait time for remote call responses (SoTimeout).

    JEUS overwrites the sun.rmi.transport.tcp.responseTimeout value.

    Default

    5 * 60 * 1000

  • sun.rmi.transport.connectionTimeout

    Description

    [client] Maximum idle time of the client RMI connection (KeepAliveTimeout).

    Default

    15 * 1000

  • sun.rmi.transport.tcp.readTimeout

    Description

    [server] Maximum wait time for the server to read a client request (SoTimeout).

    This property must be greater than the jeus.ejb.operationTimeout property (sun.rmi.transport.tcp.responseTimeout) value, which is the SoTimeOut property of the client.

    Default

    2 * 60 * 60 * 1000

  • sun.rmi.transport.tcp.maxConnectionThreads

    Description

    [server] Maximum number of threads used to process connection requests on the server.

    <thread-max> is a JEUS-related setting specified in jeus-ejb-dd.xml for each bean. <thread-max> is the number of threads that can be assigned for each bean. The value specified in <thread-max> overrides the maxConnectionThreads value.

    For example, there are two beans: EJB A and EJB B. If <thread-max> is set to the default value of 100, even if maxConnectionThreads is set to Integer.MAX_VALUE, the number of threads is limited to 200.

    Default

    Integer.MAX_VALUE

  • sun.rmi.transport.tcp.threadKeepAliveTime

    Description

    [server] Maximum wait time for a thread to receive the next request after processing a request (in idle state). (KeepAliveTimeout).

    Default

    1*60*1000

  • jeus.ejb.compiler.rmic.fork

    Description

    [server] Option to fork an RMIC compiler process when creating IIOP classes.

    Default

    false

  • jeus.ejb.compiler.rmic.verbose

    Description

    [server] Option to keep verbose logs when creating IIOP classes.

    Default

    false

  • jeus.ejb.compiler.rmic.vcompat

    Description

    Option to use the RMI 1.1, 1.2 compatible protocol when compiling IIOP.

    Default

    false

  • jeus.ejb.compiler.rmic.enable

    Description

    Option to create the IIOP Stub file. In general, the IIOP Stub file is not required.

    Default

    false

  • jeus.ejb.compiler.class.version

    Description

    [server] Option to configure the source and target versions when compiling a new EJB class.

    Default

    1.4

  • jeus.ejb.compiler.use-java-compiler-api

    Description

    Uses Java Compiler API, which is provided in JDK 6.

    This is used by default. To directly compile SUN internal classes, which are a part of the lib/tools.jar file in JDK, set this value to false.

    This option can be used when compatibility problems occur due to a difference of compiled classes.

    Default

    true