Definition
MPING (=Multicast PING) uses IP multicast to discover the initial membership. It can be used with all transports, but usually this is used in combination with TCP. TCP usually requires TCPPING, which has to list all group members explicitly, but MPING doesn't have this requirement. The typical use case for this is when we want TCP as transport, but multicasting for discovery so we don't have to define a static list of initial hosts in TCPPING
Configuration Example
Configuration example for MPING.
<MPING timeout="3000" num_initial_members="3" ></MPING>
Configuration Parameters
| Name | Description |
|---|---|
| bind_addr | Bind address for multicast socket |
| bind_interface_str | The interface (NIC) which should be used by this transport |
| break_on_coord_rsp | Return from the discovery phase as soon as we have 1 coordinator response |
| discovery_timeout | Time (in ms) to wait for our own discovery message to be received. 0 means don't wait. If the discovery message is not received within discovery_timeout ms, a warning will be logged |
| id | Give the protocol a different ID if needed so we can have multiple instances of it in the same stack |
| ip_ttl | Time to live for discovery packets. Default is 8 |
| level | Sets the logger level (see javadocs) |
| mcast_addr | |
| mcast_port | Multicast port for discovery packets. Default is 7555 |
| name | Give the protocol a different name if needed so we can have multiple instances of it in the same stack |
| num_initial_members | Minimum number of initial members to get a response from. Default is 2 |
| num_initial_srv_members | Minimum number of server responses (PingData.isServer()=true). If this value is greater than 0, we'll ignore num_initial_members |
| num_ping_requests | Number of discovery requests to be sent distributed over timeout. Default is 2 |
| receive_interfaces | List of interfaces to receive multicasts on |
| receive_on_all_interfaces | If true, the transport should use all available interfaces to receive multicast messages. Default is false |
| return_entire_cache | Whether or not to return the entire logical-physical address cache mappings on a discovery request, or not. Default is false, except for TCPPING |
| send_interfaces | List of interfaces to send multicasts on |
| send_on_all_interfaces | Whether send messages are sent on all interfaces. Default is false |
| stats | Determines whether to collect statistics (and expose them via JMX). Default is true |
| timeout | Timeout to wait for the initial members. Default is 3000 msec |
See also Protocol Configuration Common Parameters.
Comments