Utility Properties

Please Note: Unless otherwise stated, any output from these properties is sent to System.out.

Discovery Properties

net.jini.discovery.debug
If set to any value, this property indicates that debugging information related to the execution of the Jini discovery protocols should be printed to System.err. This property can be set on the JVM* of any entity that employs one or more of the following discovery utilities:

net.jini.discovery.LookupDiscovery
net.jini.discovery.LookupLocatorDiscovery
net.jini.discovery.LookupDiscoveryManager

net.jini.discovery.timeout
When a client or service uses the unicast request protocol to communicate with a particular lookup service, the socket connection used by the protocol will time out after N milliseconds, where N is defined by this property. The default value is 60,000 milliseconds (1 minute). This property can be set on the JVM of any entity that employs one or more of the following discovery utilities:

net.jini.discovery.LookupDiscovery
net.jini.discovery.LookupLocatorDiscovery
net.jini.discovery.LookupDiscoveryManager

net.jini.discovery.interface
When this property is set to either a host name or IP address, the network interface corresponding to the given name or address will be used in the multicast discovery process. When not set, the network interface used is typically the default interface as determined by the underlying operating system. This property can be set on the JVM of any entity that employs one or more of the following discovery utilities to participate in the multicast discovery protocol:

net.jini.discovery.LookupDiscovery
net.jini.discovery.LookupDiscoveryManager

Note that this property can also be set on the JVM in which the Reggie implementation of the lookup service runs. The value of this property controls the network interface the Reggie implementation uses when participating in the multicast discovery protocol as both an entity that is discovered by other entities (a lookup service), and as an entity that discovers other lookup services.

net.jini.discovery.announce
A Jini lookup service will send out multicast packets announcing its existence every N milliseconds. The value of this property can be used to control how often the Reggie implementation of the lookup service sends out multicast announcements and, for entities that discover lookup services, it can be used to control how often multicast announcements from previously discovered lookup services are examined for "liveness". Thus, this property can be set on the JVM in which the Reggie implementation of the lookup service runs, and it also can be set on the JVM of any entity that participates in the multicast discovery protocol through the use of one or more of the following discovery utilities:

net.jini.discovery.LookupDiscovery
net.jini.discovery.LookupDiscoveryManager

Currently, the default value of this property is 120,000 milliseconds (two minutes).

net.jini.discovery.mtu
If set, this property must be an integer between 512 and the maximum MTU allowed by your system. The value of this property specifies the maximum permissible size of multicast request and announcement packets. The default value is 512. This property can be set on the JVM of any entity that employs one or more of the following discovery utilities to participate in the multicast discovery protocol, as well as the Reggie implementation of the lookup service:

net.jini.discovery.LookupDiscovery
net.jini.discovery.LookupDiscoveryManager

net.jini.discovery.ttl
If set, this property must be an integer between 1 and 255. This property specifies the time-to-live parameter used by both the multicast announcement and multicast request protocol implementations. The default value is 15. This property can be set on the JVM of any entity that employs one or more of the following discovery utilities to participate in the multicast discovery protocol, as well as the Reggie implementation of the lookup service:

net.jini.discovery.LookupDiscovery
net.jini.discovery.LookupDiscoveryManager

Join Properties

com.sun.jini.join.debug
If set to any value, this property indicates that debugging information related to the execution of the Jini join protocols should be printed to System.err. This property can be set on the JVM of any entity that employs the following join utility:

net.jini.lookup.JoinManager

Service Discovery Properties

com.sun.jini.sdm.debug
If set to any value, this property indicates that debugging information related to exceptional conditions that occur during service discovery processing will be printed to System.err. This property should be useful in diagnosing common service discovery problems related to a bad listener codebase and/or a non-existent or poorly defined proxy equals method; as well as other problems where exceptions are "swallowed".
This property can be set on the JVM of any entity that employs the following service discovery utility, net.jini.lookup.ServiceDiscoveryManager

com.sun.jini.sdm.discardWait
This property can be used to affect the behavior of the mechanism that handles "the service discard problem" described in the Jini Service Discovery Utilities Specification. This property allows each entity that uses the service discovery manager to define how long (in milliseconds) to wait for verification from the lookup service(s) that a discarded service is actually down before committing or un-committing a requested service discard. The current implementation of the service discovery manager defaults to waiting 10 minutes (twice the maximum lease duration granted by the reggie implementation of the lookup service).