Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "R-OSGi Properties"

 
(3 intermediate revisions by the same user not shown)
Line 113: Line 113:
 
<td>
 
<td>
 
Defines timeout used (ms) for ChannelEndpointImpl.TIMEOUT variable used in ChannelEndpointImpl.sendAndWait() method.
 
Defines timeout used (ms) for ChannelEndpointImpl.TIMEOUT variable used in ChannelEndpointImpl.sendAndWait() method.
 +
</td>
 +
</tr>
 +
<tr class="b"><td><code>
 +
ch.ethz.iks.r_osgi.remoteservice.timeout
 +
</code></td>
 +
<td>30000</td>
 +
 +
<td>
 +
Defines timeout (ms) used for remote service method calls.  May be overridden on a service-specific basis by using osgi.basic.timeout service property.
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 121: Line 130:
  
 
<td>
 
<td>
Whether to use the value of InetAddress.getLocalHost().getCanonicalHostName() as the default host value for dynamically created r_osgi provider ID.  If false, then 'localhost' is used as default.  This can be useful if your
+
Whether to use the value of InetAddress.getLocalHost().getCanonicalHostName() as the default host value for dynamically created r_osgi provider ID.  If false, then 'localhost' is used as default.  Setting this to false can be useful if your
 
network configuration results in getCanonicalHostName() taking a very long time to complete (> 10 seconds), due to absent or misconfigured nameserver.
 
network configuration results in getCanonicalHostName() taking a very long time to complete (> 10 seconds), due to absent or misconfigured nameserver.
 
</td>
 
</td>
 +
</tr>
 +
 +
<tr class="b"><td><code>ch.ethz.iks.r_osgi.topic.filter</code></td>
 +
<td>empty</td>
 +
 +
<td>By default, the ROSGi provider will attempt to distribute local Events, delivered via the OSGi EventAdmin service.  There are many events that are not serializable, however, (especially in Eclipse/RCP applications) and when ROSGi attempts to serialize these exceptions will be thrown and other communication may be interrupted.  With this topic.filter property, individual topic names may be prevented from being distributed.  For example:
 +
<pre>
 +
-Dch.ethz.iks.r_osgi.topic.filter=*
 +
</pre>
 +
will prevent any events from being distributed. 
 +
<pre>
 +
-Dch.ethz.iks.r_osgi.topic.filter=org/eclipse/e4/*,org/osgi/*
 +
</pre>
 +
will prevent events that begin with org/eclipse/e4/* and org/osgi/* from being distributed automatically.  See also <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=419327">bug 419327</a> for more information.
 +
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
</p>
 
</p>

Latest revision as of 14:20, 13 March 2018

Currently, R-OSGi supports the following properties:

Attribute Default Comment

ch.ethz.iks.r_osgi.debug.proxyGeneration

false

= disabled

Enable debug output for dynamic proxy generation.

ch.ethz.iks.r_osgi.debug.messages

false

= disabled

Enable debug output for R-OSGi messages (= network packets).

ch.ethz.iks.r_osgi.debug.internal

false

= disabled

Enable R-OSGi internal debug outputs.

ch.ethz.iks.r_osgi.service_discovery.slp.discovery_interval

20

Amout of time (in seconds) between two SLP service discovery attempts (only when jSLP and service_discovery.slp are installed). This also sets the upper time bound for discovery.

ch.ethz.iks.r_osgi.service_discovery.slp.defaultLifetime

90

Amout of time (in seconds) that a service registration in SLP remains alive. R-OSGi will reregister the service unless the service is unregistered with R-OSGi. This property sets the lifetime for SLP registrations and affects how long a registration remains stale if the R-OSGi service is shut down or if a SLP Directory Agent is used and the framework is shut down. Should be set to a reasonable value; too small values lead to increased resource consumptions for the reregistration thread. Too large values lead to stale service references, especially if a Directory Agent for is present. (For details about the role of a Directory Agent, see <a class="externalLink" href="http://www.openslp.org/doc/rfc/rfc2608.txt"> RFC 2608 </a>

. Please note, that service_discovery.slp does not require the presence of a Directory Agent.)

ch.ethz.iks.r_osgi.port 9278

The port on which R-OSGi operates when the (default) TCP-based protocol is used. Should not be changed unless R-OSGi is running in a closed environment where all peers use a non-default port.

ch.ethz.iks.r_osgi.registerDefaultChannel

true

Defines if R-OSGi should register the default transport channel support for the r-osgi protocol.

ch.ethz.iks.r_osgi.channelEndpointImpl.timeout

120000

Defines timeout used (ms) for ChannelEndpointImpl.TIMEOUT variable used in ChannelEndpointImpl.sendAndWait() method.

ch.ethz.iks.r_osgi.remoteservice.timeout

30000

Defines timeout (ms) used for remote service method calls. May be overridden on a service-specific basis by using osgi.basic.timeout service property.

org.eclipse.ecf.provider.r_osgi.useHostName

true

Whether to use the value of InetAddress.getLocalHost().getCanonicalHostName() as the default host value for dynamically created r_osgi provider ID. If false, then 'localhost' is used as default. Setting this to false can be useful if your network configuration results in getCanonicalHostName() taking a very long time to complete (> 10 seconds), due to absent or misconfigured nameserver.

ch.ethz.iks.r_osgi.topic.filter empty By default, the ROSGi provider will attempt to distribute local Events, delivered via the OSGi EventAdmin service. There are many events that are not serializable, however, (especially in Eclipse/RCP applications) and when ROSGi attempts to serialize these exceptions will be thrown and other communication may be interrupted. With this topic.filter property, individual topic names may be prevented from being distributed. For example:
-Dch.ethz.iks.r_osgi.topic.filter=*

will prevent any events from being distributed.

-Dch.ethz.iks.r_osgi.topic.filter=org/eclipse/e4/*,org/osgi/*

will prevent events that begin with org/eclipse/e4/* and org/osgi/* from being distributed automatically. See also <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=419327">bug 419327</a> for more information.

Back to the top