1. JNDI System Properties

The following describes JNDI system properties.

  • java.naming.factory.initial (Required)

    Description

    InitialContext factory class name for the JNDI service provider.

    InitialContext is created through this factory class. JEUS InitialContext is created by setting this property to jeus.jndi.JNSContextFactory.

    Default

    jeus.jndi.JNSContextFactory

  • java.naming.factory.url.pkgs

    Description

    Option to enable JNDI look up in JEUS InitialContext using URL schema.

    Default

    jeus.jndi.jns.url

  • java.naming.provider.url

    Description

    DNS host name and the port of the server that provides JNDI service. Set this variable to the IP address of JEUS JNSServer. When making a JNDI request to the clustered MSs, the addresses of all clustered servers must be listed using a comma (,) as a delimiter.

    ex) yohan:9736, yohan1:9836

    Default

    127.0.0.1:9736

  • java.naming.security.principal

    Description

    User name authenticated by the JEUS Naming Server. If the user name is not set, "anonymous" is used.

    The user name must be defined in the JEUS Security Domain.

    Default

    anonymous

  • java.naming.security.credentials

    Description

    Password authenticated by the JEUS Naming Server.

    Default

    N/A

  • jeus.jndi.jns.resolution

    Description

    Interval at which JNSClient checks resources.

    Default

    30 * 1000 (Unit: ms)

  • jeus.jndi.jns.connecttimeout

    Description

    Timeout for JNSClient to connect to JNSServer.

    Connection is retried during the timeout period. When the time expires, the jeus.net.ConnectException is thrown.

    Default

    0 (infinite, may vary by OS) (Unit: ms)

  • jeus.jndi.jns.connectionduration

    Description

    Period in which the connection from JNSClient to JNSServer is maintained. If a connection is not used within the time period, the connection is automatically terminated.

    The default value is zero (the connection is maintained indefinitely).

    Default

    0 (Unit: ms)

  • jeus.jndi.local.tmout

    Description

    Period in which to receive a reply for a JNSClient request. If there is no response from the JNSServer, jeus.util.WaitTimeoutException is thrown.

    Default

    20 * 1000 (Unit: ms)

  • jeus.jndi.cluster.recheckto

    Description

    Interval at which whether the failed server was recovered is checked, when using the JEUSClusterContext.

    Default

    300 * 1000 (Unit: ms)

  • jeus.cluster.retry

    Description

    Specifies the number of reattempts to make when an exception occurs when establishing a cluster connection from a container or client to JEUS Manager.

    Default

    1

  • jeus.jndi.clusterlink.selection-policy

    Description

    Policy for determining the server from which an object is retrieved and for selecting the EJB engine when EJB 2.x is enabled. The setting in the properties file is overridden by the one in the hash table.

    Input options:

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

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

    • xid-hashing: The server is determined through xid hashing, ensuring that requests with the same xid are directed to and processed by the same server.

    Default

    locallinkPreference

  • jeus.jndi.enable.cache

    Description

    Option to enable cache in JNDI clients (JNSClient).

    • true: Cache is enabled. (Default)

    • false: Cache is disabled.

    Default

    true

  • jeus.jndi.jns.replicatebindings

    Description

    Option to share the bound object among the clustered MSs.

    • true: Object is shared. (Default)

    • false: Object is not shared

    Default

    true

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

    Default

    true

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

    Default

    false

  • jeus.jndi.compat

    Description

    JNDI compatibility setting. Option to provide JNDI services between a version earlier than JEUS 7 Fix#2 and JEUS 7 Fix#2 or later.

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

    • false: The JNDI compatibility support is disabled between a version earlier than JEUS 7 Fix#2 and JEUS 7 Fix#2 or later. (Default)

    Default

    false