Table of Contents Previous Next
Logo
Properties : C.17 IceStorm Properties
Copyright © 2003-2009 ZeroC, Inc.

C.17 IceStorm Properties

All IceStorm properties use the IceStorm service name as their prefix. For example, suppose an IceBox configuration loads IceStorm as shown below:
IceBox.Service.DataFeed=IceStormService,...
IceStorm properties defined for this service must use DataFeed as the prefix, such as DataFeed.Discard.Interval=10.

service.Discard.Interval

Synopsis

service.Discard.Interval=num

Description

An IceStorm server detects when a subscriber to which it forwards events becomes non-functional and, at that point, stops delivery attempts to that subscriber for num seconds before trying to forward events to that subscriber again. The default value of this property is 60 seconds.

service.Election.ElectionTimeout

Synopsis

service.Election.ElectionTimeout=num

Description

This property is used by a replicated IceStorm deployment (see Section 45.7). It specifies the interval in seconds at which a coordinator attempts to form larger groups of replicas. If not defined, the default value is 10.

service.Election.MasterTimeout

Synopsis

service.Election.MasterTimeout=num

Description

This property is used by a replicated IceStorm deployment (see Section 45.7). It specifies the interval in seconds at which a slave checks the status of the coordinator. If not defined, the default value is 10.

service.Election.ResponseTimeout

Synopsis

service.Election.ResponseTimeout=num

Description

This property is used by a replicated IceStorm deployment (see Section 45.7). It specifies the interval in seconds that a replica waits for replies to an invitation to form a larger group. Lower priority replicas wait for intervals inversely proportional to the maximum priority:
ResponseTimeout + ResponseTimeout * (max - pri)
If not defined, the default value is 10.

service.Flush.Timeout

Synopsis

service.Flush.Timeout=num

Description

Defines the interval in milliseconds with which batch reliability events are sent to subscribers. The default is 1000ms. Settings of less than 100msec are silently adjusted to 100msec.

service.InstanceName

Synopsis

service.InstanceName=name

Description

Specifies an alternate identity category for all objects hosted by the IceStorm object adapters. If not specified, the default identity category is IceStorm.

service.Node.name

Synopsis

service.Node.name=value

Description

In a replicated deployment, IceStorm uses the adapter name service.Node for the replica node’s object adapter (see Section 45.7). Therefore, all the adapter properties detailed in Section C.4 can be used to configure this adapter.

service.NodeId

Synopsis

service.NodeId=value

Description

Specifies the node id of an IceStorm replica, where value is a non-negative integer. The node id is also used as the replica’s priority, such that a larger value assigns higher priority to the replica. As described in Section 45.7, the replica with the highest priority becomes the coordinator of its group. This property must be defined for each replica.

service.Nodes.id

Synopsis

service.Nodes.id=value

Description

This property is used for a manual deployment of HA IceStorm (see Section 45.12.3), in which each of the replicas must be explicitly configured with the proxies of all other replicas. The value is a proxy for the replica with the given node id. A replica’s object identity has the form instance-name/nodeid, such as DemoIceStorm/node2.

service.Publish.name

Synopsis

service.Publish.name=value

Description

IceStorm uses the adapter name service.Publish for the object adapter that processes incoming requests from publishers. Therefore, all the adapter properties detailed in Section C.4 can be used to configure this adapter.

service.ReplicatedPublishEndpoints

Synopsis

service.ReplicatedPublishEndpoints=value

Description

This property is used for a manual deployment of HA IceStorm (see Section 45.12.3). It specifies the set of endpoints returned for the publisher proxy returned from IceStorm::Topic::getPublisher.
If this property is not defined, the publisher proxy returned by a topic instance points directly at that replica and, should the replica become unavailable, publishers will not transparently failover to other replicas.

service.ReplicatedTopicManagerEndpoints

Synopsis

service.ReplicatedTopicManagerEndpoints=value

Description

This property is used for a manual deployment of HA IceStorm (see Section 45.12.3). It specifies the set of endpoints used in proxies that refer to a replicated topic. This set of endpoints should contain the endpoints of each IceStorm replica.
For example, the operation IceStorm::TopicManager::create returns a proxy that contains this set of endpoints.

service.Send.Timeout

Synopsis

service.Send.Timeout=num

Description

IceStorm applies a send timeout when it forwards events to subscribers. The value of this property determines how long IceStorm will wait for forwarding of an event to complete. If an event cannot be forwarded within num milliseconds, the subscriber is considered dead and its subscription is cancelled. The default value is 60 seconds. Setting this property to a negative value disables timeouts.

service.TopicManager.name

Synopsis

service.TopicManager.name=value

Description

IceStorm uses the adapter name service.TopicManager for the topic manager’s object adapter. Therefore, all the adapter properties detailed in Section C.4 can be used to configure this adapter.

service.Trace.Election

Synopsis

service.Trace.Election=num

Description

Trace activity related to elections:

service.Trace.Replication

Synopsis

service.Trace.Replication=num

Description

Trace activity related to replication:

service.Trace.Subscriber

Synopsis

service.Trace.Subscriber=num

Description

The subscriber trace level:
Like 1, but more verbose, including state transitions for a subscriber (such as going offline after a temporary network failure, and going online again after a successful retry, etc.).

service.Trace.Topic

Synopsis

service.Trace.Topic=num

Description

The topic trace level:

service.Trace.TopicManager

Synopsis

service.Trace.TopicManager=num

Description

The topic manager trace level:

service.Transient

Synopsis

service.Transient=num

Description

If num is a value greater than zero, IceStorm runs in a fully transient mode in which no database is required. Replication is not supported in this mode. If not defined, the default value is zero.

IceStormAdmin.TopicManager.Default

Synopsis

IceStormAdmin.TopicManager.Default=proxy

Description

Defines the proxy for the default IceStorm topic manager. This property is used by icegridadmin. IceStorm applications may choose to use this property for their configuration as well.

IceStormAdmin.TopicManager.name

Synopsis

IceStormAdmin.TopicManager.name=proxy

Description

Defines a proxy for an IceStorm topic manager for icegridadmin. Properties with this pattern are used by icestormadmin if multiple topic managers are in use, for example:
IceStormAdmin.TopicManager.A=A/TopicManager:tcp -h x -p 9995
IceStormAdmin.TopicManager.B=Foo/TopicManager:tcp -h x -p 9995
IceStormAdmin.TopicManager.C=Bar/TopicManager:tcp -h x -p 9987
This sets the proxies for three topic managers. Not that name need not match the instance name of the corresponding topic manager—name simply serves as tag. With these property settings, the icestormadmin commands that accept a topic can now specify a topic manager other than the default topic manager that is configured with IceStormAdmin.TopicManager.Default. For example:
current Foo
create myTopic
create Bar/myOtherTopic
This sets the current topic manager to the one with instance name Foo; the first create command then creates the topic within that topic manager, whereas the second create command uses the topic manager with instance name Bar.
Table of Contents Previous Next
Logo