This page describes the properties supported by the IceDiscovery plug-in.

On this page:

IceDiscovery.Address

Synopsis

IceDiscovery.Address=addr

Description

Specifies the multicast IP address to use for sending or receiving multicast discovery queries. If not defined, the default value depends on other property settings:

• If Ice.PreferIPv6Address is enabled or Ice.IPv4 is disabled, IceDiscovery uses the IPv6 address ff15::1
• Otherwise IceDiscovery uses 239.255.0.1


This property is used to compose the value of IceDiscovery.Lookup and IceDiscovery.Multicast.Endpoints.

IceDiscovery.DomainId

Synopsis

IceDiscovery.DomainId=id

Description

Specifies the domain ID used to locate objects and object adapters. The IceDiscovery plug-in only responds to requests from clients with the same domain ID and ignores requests from clients with a different domain ID. If not defined, the default domain ID is an empty string.

IceDiscovery.Interface

Synopsis

IceDiscovery.Interface=intf

Description

Specifies the IP address of the interface to use for sending or receiving multicast discovery queries. If not defined, the discovery will use all the network interfaces available on the system to send and receive UDP multicast datagrams. This property is used to compose the value of IceDiscovery.Lookup, IceDiscovery.Reply.Enpoints and IceDiscovery.Multicast.Endpoints.

IceDiscovery.Lookup

Synopsis

IceDiscovery.Lookup=endpoints

Description

Specifies the multicast endpoints that a client uses to send multicast discovery queries. If not defined, the endpoint is composed as follows:

udp -h addr -p port [--interface intf]

where addr is the value of IceDiscovery.Address, port is the value of IceDiscovery.Port, and intf is the value of IceDiscovery.Interface. If multiple endpoints are defined, the  queries will be sent on each endpoint.

 

IceDiscovery.Multicast.AdapterProperty

Synopsis

IceDiscovery.Multicast.AdapterProperty=value

Description

IceDiscovery creates an object adapter named IceDiscovery.Multicast for receiving discovery queries from clients. If not otherwise defined by IceDiscovery.Multicast.Endpoints, the endpoint for this object adapter is composed as follows:

udp -h addr -p port [--interface intf]

where addr is the value of IceDiscovery.Address, port is the value of IceDiscovery.Port, and intf is the value of IceDiscovery.Interface.

You don't normally need to set other properties for this object adapter.

IceDiscovery.LatencyMultiplier

Synopsis

IceDiscovery.LatencyMultiplier=num

Description

Specifies the multiplier to apply to the latency of the first discovery request-reply for replica groups. When IceDiscovery receives a reply for a discovery request and this reply indicates that the adapter identifier is a replica group, it waits for an additional time interval for other responses from replicated servers. This time interval is based on the latency of the first request-reply and the latency multiplier. For example, if the first reply is received after 15 milliseconds and the multiplier is set to 4, IceDiscovery will wait for an additional 60 milliseconds for replies from other servers. If not defined, the default is 1.

IceDiscovery.Port

Synopsis

IceDiscovery.Port=port

Description

Specifies the multicast port to use for sending or receiving multicast requests. If not set, the default value is 4061.

IceDiscovery.Reply.AdapterProperty

Synopsis

IceDiscovery.Reply.AdapterProperty=value

Description

IceDiscovery creates an object adapter named IceDiscovery.Reply for receiving replies to multicast requests. If not otherwise defined by IceDiscovery.Reply.Endpoints, the endpoint for this object adapter is composed as follows:

udp [-h intf]

where intf is the value of IceDiscovery.Interface. A fixed port is not necessary for this endpoint.

You don't normally need to set other properties for this object adapter.

IceDiscovery.RetryCount

Synopsis

IceDiscovery.RetryCount=num

Description

Specifies the maximum number of times that the plug-in will retry sending UDP multicast requests before giving up. The IceDiscovery.Timeout property determines how long the plug-in waits for a reply before trying again. If not defined, the default retry count is 3.

IceDiscovery.Timeout

Synopsis

IceDiscovery.Timeout=num

Description

Specifies the time interval in milliseconds to wait for replies to UDP multicast requests. If no server replies during this time interval, the client will retry the request the number of times specified by IceDiscovery.RetryCount. If not defined, the default timeout is 300.