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

C.14 IceStorm Properties

IceStorm.Discard.Interval=num

Synopsis

IceStorm.Discard.Interval=num

Description

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

IceStorm.Flush.Timeout

Synopsis

IceStorm.Flush.Timeout=num

Description

Defines the interval in milliseconds with which batch reliability events are sent to subscribers. The default is 1000ms. The minimum value of this property is 100ms.

IceStorm.InstanceName

Synopsis

IceStorm.InstanceName=name

Description

Specifies an alternate identity category for the IceStorm topic manager object. If defined, the identity of the object becomes name/TopicManager. If not specified, the default identity category is IceStorm.

IceStorm.Publish.name

Synopsis

IceStorm.Publish.name=value

Description

IceStorm uses the adapter name IceStorm.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.

IceStorm.Send.Timeout

Synopsis

IceStorm.Send.Timeout=num
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.
Note that for twoway subscribers, IceStorm uses AMI calls to forward events to subscribers. Timeouts for AMI invocations are enforced by the communicator’s connection monitor thread, therefore you may also need to set the Ice.MonitorConnections property to achieve the desired timeout behavior.

IceStorm.SubscriberPool.Size

Synopsis

IceStorm.SubscriberPool.Size=num
To forward events to subscribers, IceStorm maintains a thread pool. This property controls the minimum number of threads in this subscriber pool. The default value is 1.

IceStorm.SubscriberPool.SizeMax

Synopsis

IceStorm.SubscriberPool.SizeMax=num

Description

The subscriber thread pool can grow dynamically up to a maximum of num threads. The default value is the value of IceStorm.SubscriberPool.Size. If num is set to a value greater than IceStorm.SubscriberPool.Size, the actual number of threads in the pool fluctuates between the minimum and maximum value (but drops back to IceStorm.SubscriberPool.Size if the additional threads are no longer needed). The default value is 0, meaning no limit on the maximum number of threads.

IceStorm.SubscriberPool.SizeWarn

Synopsis

IceStorm.SubscriberPool.SizeWarn=num
If the number of threads in the subscriber pool exceeds num, IceStorm logs a warning. The default value of this property is 80% of the number of threads specified by IceStorm.SubscriberPool.SizeMax.

IceStorm.SubscriberPool.Timeout

Synopsis

IceStorm.SubscriberPool.Timeout=msec
If the delivery of an event to a subscriber exceeds num milliseconds, IceStorm adds an additional thread to the subscriber thread pool (provided that IceStorm.SubscriberPool.SizeMax is not exceeded). The default value is 1000msec. Settings of less than 50msec are silently adjusted to 50msec.

IceStorm.TopicManager.name

Synopsis

IceStorm.TopicManager.name=value

Description

IceStorm uses the adapter name IceStorm.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.

IceStorm.Trace.Flush

Synopsis

IceStorm.Trace.Flush=num

Description

Trace information on the thread that flushes batch reliability events to subscribers:

IceStorm.Trace.Subscriber

Synopsis

IceStorm.Trace.Subscriber=num

Description

The subscriber trace level:

IceStorm.Trace.SubscriberPool

Synopsis

IceStorm.Trace.Subscriber=num

Description

Controls tracing of the subscriber thread pool:

IceStorm.Trace.Topic

Synopsis

IceStorm.Trace.Topic=num

Description

The topic trace level:

IceStorm.Trace.TopicManager

Synopsis

IceStorm.Trace.TopicManager=num

Description

The topic manager trace level:

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