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) |
|||
Line 22: | Line 22: | ||
! Default value | ! Default value | ||
|- | |- | ||
− | | ecf.discovery.hazelcast.configURL | + | | System property: '''ecf.discovery.hazelcast.configURL''' |
− | | Xml config file to config Discovery Hazelcast group. In addition to normal URLs such as http://host.com/path/to/hazelcast.xml, or https://securehost.com/path/to/myhazelcast.xml, this supports a 'bundle' protocol to reference Hazelcast config files from within other bundles. For example: '''-Decf.discovery.hazelcast.configURL=bundle:my.org.bundle.symbolic.id/path/to/hc-config-file.xml'''. If | + | | Xml config file to config Discovery Hazelcast group. In addition to normal URLs such as http://host.com/path/to/hazelcast.xml, or https://securehost.com/path/to/myhazelcast.xml, this supports a 'bundle' protocol to reference Hazelcast config files from within other bundles. For example: '''-Decf.discovery.hazelcast.configURL=bundle:my.org.bundle.symbolic.id/path/to/hc-config-file.xml'''. If given as the value of this system property, the bundle '''my.org.bundle.symbolic.id''' (latest version) will be consulted at discovery start time and the contents within that bundle of an entry with the path '''/path/to/hc-config-file.xml''' will be read and used as for the remote service discovery config. |
| String | | String | ||
− | | None - If not specified, uses | + | | None - If not specified, uses '''/hc-discovery-config.xml''' file inside of bundle '''org.eclipse.ecf.discovery.provider.hazelcast'''. [https://github.com/ECF/HazelcastProvider/blob/master/bundles/org.eclipse.ecf.discovery.provider.hazelcast/hc-discovery-config.xml This config] uses Hazelcast multicast group: '''224.2.2.5''' and port: '''54327'''. See [https://github.com/ECF/HazelcastProvider/blob/master/bundles/org.eclipse.ecf.discovery.provider.hazelcast/hc-discovery-config.xml here] for entire default config. |
|- | |- | ||
| ecf.discovery.hazelcast.enabled | | ecf.discovery.hazelcast.enabled |
Revision as of 23:50, 14 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 system properties. Here is a table of the Hazelcast Discovery Provider configuration system property properties and their default values:
Property Name | Description | Type | Default value |
---|---|---|---|
System property: ecf.discovery.hazelcast.configURL | Xml config file to config Discovery Hazelcast group. In addition to normal URLs such as http://host.com/path/to/hazelcast.xml, or https://securehost.com/path/to/myhazelcast.xml, this supports a 'bundle' protocol to reference Hazelcast config files from within other bundles. For example: -Decf.discovery.hazelcast.configURL=bundle:my.org.bundle.symbolic.id/path/to/hc-config-file.xml. If given as the value of this system property, the bundle my.org.bundle.symbolic.id (latest version) will be consulted at discovery start time and the contents within that bundle of an entry with the path /path/to/hc-config-file.xml will be read and used as for the remote service discovery config. | String | None - If not specified, uses /hc-discovery-config.xml file inside of bundle org.eclipse.ecf.discovery.provider.hazelcast. This config uses Hazelcast multicast group: 224.2.2.5 and port: 54327. See here for entire default config. |
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 also defined in the source code in the org.eclipse.ecf.provider.internal.jms.hazelcast.Activator class available at githhub here.