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.
Difference between revisions of "Hazelcast-Based Discovery Provider"
(→Hazelcast Discovery Provider Configuration Properties) |
(→Hazelcast Discovery Provider Configuration Properties) |
||
| Line 23: | Line 23: | ||
| '''ecf.discovery.hazelcast.configURL''' | | '''ecf.discovery.hazelcast.configURL''' | ||
| File to use for Hazelcast group configuration for remote service discovery. In addition to normal URLs such as http://host.com/path/to/hazelcast.xml, or https://securehost.com/path/to/myhazelcast.xml, this property supports a values with a 'bundle' protocol to allow references Hazelcast config files from within other bundles within a given framework. <br> | | File to use for Hazelcast group configuration for remote service discovery. In addition to normal URLs such as http://host.com/path/to/hazelcast.xml, or https://securehost.com/path/to/myhazelcast.xml, this property supports a values with a 'bundle' protocol to allow references Hazelcast config files from within other bundles within a given framework. <br> | ||
| − | For example: '''-Decf.discovery.hazelcast.configURL=bundle:my.org.bundle.symbolic.name/path/to/hc-config-file.xml'''. If given as the value of this property, at discovery start time, the bundle '''my.org.bundle.symbolic.name''' ( | + | For example: '''-Decf.discovery.hazelcast.configURL=bundle:my.org.bundle.symbolic.name/path/to/hc-config-file.xml'''. If given as the value of this property, at discovery start time, the bundle '''my.org.bundle.symbolic.name''' (highest version if multiple versions are present) will be consulted and the contents of an entry with the path '''/path/to/hc-config-file.xml''' within the bundle will be read and used as for the Hazelcast discovery config. <br> |
NOTE: For discovery to work, each node must use the same Hazelcast discovery config. | NOTE: For discovery to work, each node must use the same Hazelcast discovery config. | ||
| String | | String | ||
Revision as of 00:09, 15 October 2019
A new ECF discovery provider has been created (September 15, 2019), based upon the Hazelcast communications library. See the Hazelcast website for technical specifics about Hazelcast and configuration and API documentation.
Getting Hazelcast Discovery Provider
The Hazelcast ECF Discovery provider repository is here.
A binary build of the Hazelcast Discovery Provider and Hazelcast Distribution Provider are available here.
Karaf Install
A Karaf features file karaf-features.xml (with both Distribution and Discovery features) is available in karaf-features.xml.
Hazelcast Discovery Provider Configuration Properties
The ECF Hazelcast Discovery Provider is configured via two system properties.
| System Property Name | Description | Type | Default value |
|---|---|---|---|
| ecf.discovery.hazelcast.configURL | File to use for Hazelcast group configuration for remote service discovery. In addition to normal URLs such as http://host.com/path/to/hazelcast.xml, or https://securehost.com/path/to/myhazelcast.xml, this property supports a values with a 'bundle' protocol to allow references Hazelcast config files from within other bundles within a given framework. For example: -Decf.discovery.hazelcast.configURL=bundle:my.org.bundle.symbolic.name/path/to/hc-config-file.xml. If given as the value of this property, at discovery start time, the bundle my.org.bundle.symbolic.name (highest version if multiple versions are present) will be consulted and the contents of an entry with the path /path/to/hc-config-file.xml within the bundle will be read and used as for the Hazelcast discovery config. |
String | Uses file with URL: bundle:org.eclipse.ecf.discovery.provider.hazelcast/hc-discovery-config.xml as default discovery config. This config uses Hazelcast multicast group: 224.2.2.5 and port: 54327. See here for contents of the entire default config. Note that the in any config, a replicated map named 'default' must be present and configured for the discovery provider to function. |
| ecf.discovery.hazelcast.enabled | Flag to enable/disable Hazelcast Discovery via bundle org.eclipse.ecf.discovery.provider.hazelcast. True/enabled by default. Setting system property to anything other than 'true' will disable the ECF Hazelcast Discovery provider. | Boolean | true |
Note that these values and defaults are defined in the source code for org.eclipse.ecf.discovery.provider.hazelcast.Activator class available at githhub here.