Glacier Router Properties

Glacier.Router.AdapterId, Glacier.Router.Client.AdapterId, Glacier.Router.Server.AdapterId

Synopsis

Glacier.Router.AdapterId=id
Glacier.Router.Client.AdapterId=id
Glacier.Router.Server.AdapterId=id

Description

Defines the value of the property adapter.AdapterId for the object adapters named Glacier.Router, Glacier.Router.Client and Glacier.Router.Server.

Glacier.Router.Endpoints, Glacier.Router.Client.Endpoints, Glacier.Router.Server.Endpoints

Synopsis

Glacier.Router.Endpoints=endpoints
Glacier.Router.Client.Endpoints=endpoints
Glacier.Router.Server.Endpoints=endpoints

Description

Defines the endpoints of the Glacier router control interface, the client interface, and the server interface. The router endpoints and the client endpoints must be accessible to Glacier clients from which the router forwards requests, and to which the router sends callbacks. The server endpoints must be accessible to Glacier servers to which the router forwards requests, and from which the router accepts callbacks for the client.

Glacier.Router.PublishedEndpoints, Glacier.Router.Client.PublishedEndpoints, Glacier.Router.Server.PublishedEndpoints

Synopsis

Glacier.Router.PublishedEndpoints=endpoints
Glacier.Router.Client.PublishedEndpoints=endpoints
Glacier.Router.Server.PublishedEndpoints=endpoints

Description

Defines the published endpoints of the Glacier router control interface, the client interface, and the server interface. The router endpoints and the client endpoints must be accessible to Glacier clients from which the router forwards requests, and to which the router sends callbacks. The server endpoints must be accessible to Glacier servers to which the router forwards requests, and from which the router accepts callbacks for the client. Refer to the description of the object adapter property adapter.PublishedEndpoints for more information.

Glacier.Router.Identity

Synopsis

Glacier.Router.Identity=identity

Description

The identity of the router control interface. If not specified, the default value router is used.

Glacier.Router.PrintProxyOnFd

Synopsis

Glacier.Router.PrintProxyOnFd=fd

Description

If set, print the stringified router proxy on the filedescriptor fd, and close this filedescriptor. (Unix only.)

Note

This operation is intended to be used by the Glacier router starter only. It should not be set manually.

Glacier.Router.Trace.Client

Synopsis

Glacier.Router.Trace.Client=num

Description

The client interface trace level:

0No client interface trace. (default)
1Trace exceptions during request forwarding from the client to the server.
2Also trace detailed forward routing information from the client to the server.

Glacier.Router.Trace.Server

Synopsis

Glacier.Router.Trace.Server=num

Description

The server interface trace level:

0No server interface trace. (default)
1Trace exceptions during callbacks from the server back to the client.
2Also trace detailed reverse routing information for callbacks from the server to the client.

Glacier.Router.Trace.RoutingTable

Synopsis

Glacier.Router.Trace.RoutingTable=num

Description

The routing table trace level:

0No routing table trace. (default)
1Trace additions to the Glacier routing table.

Glacier.Router.Trace.Throttle

Synopsis

Glacier.Router.Trace.Throttle=num

Description

The request throttle trace level:

0No request throttle tracing. (default)
1Trace throttled requests.

Glacier.Router.Client.ForwardContext, Glacier.Router.Server.ForwardContext

Synopsis

Glacier.Router.Client.ForwardContext=num
Glacier.Router.Server.ForwardContext=num

Description

If num is set to a value larger than zero, the context parameter is forwarded unmodified as received from the client or server, respectively. Otherwise an empty context is forwarded. Default is no context forwarding.

Glacier.Router.Client.SleepTime, Glacier.Router.Server.SleepTime

Synopsis

Glacier.Router.Client.SleepTime=num
Glacier.Router.Server.SleepTime=num

Description

num is the sleep time (delay) in milliseconds after a request or message batch has been forwarded. The default value is zero, meaning no delay. Setting these values avoids message flooding. This is useful to avoid denial-of-service attacks, or to allow a minimum time for collecting messages for batching.

Glacier.Router.Client.Throttle.Twoways, Glacier.Router.Server.Throttle.Twoways

Synopsis

Glacier.Router.Client.Throttle.Twoways=num
Glacier.Router.Server.Throttle.Twoways=num

Description

num is the maximum number of twoway requests that the router forwards simultaneously. The default is zero, meaning no limit. Enabling twoway message throttling is useful to prevent a router from consuming too many resources of backend services.

Glacier.Router.SessionManager

Synopsis

Glacier.Router.SessionManager=proxy

Description

A stringified proxy to a session manager. If not specified, it is not possible to use the Router::createSession() method.

Glacier.Router.UserId

Synopsis

Glacier.Router.UserId=name

Description

The authenticated user id. This is usually passed from the Glacier router starter. The user id is used as an argument to Router::createSession().

Glacier.Router.AllowCategories

Synopsis

Glacier.Router.AllowCategories=list

Description

A white space separated list of categories. If this property is set, then requests are only permitted to Ice objects with an identity that matches one of the categories from this list.

Glacier.Router.AcceptCert

Synopsis

Glacier.Router.AcceptCert=base64 encoded certificate string

Description

A base64 encoded certificate (which can be obtained by calling certToBase64() on an existing IceSSL::RSAKeyPair). The Glacier Router uses this certificate, when in SSL mode, to restrict those clients that may connect to it. Only clients that use this certificate may connect; others are rejected.

Glacier.Router.ThreadPool.Size

Synopsis

Glacier.Router.ThreadPool.Size=num

Description

Defines the value of the property adapter.ThreadPool.Size for the object adapter named Glacier.Router.

Glacier.Router.ThreadPool.SizeMax

Synopsis

Glacier.Router.ThreadPool.SizeMax=num

Description

Defines the value of the property adapter.ThreadPool.SizeMax for the object adapter named Glacier.Router.

Glacier.Router.ThreadPool.SizeWarn

Synopsis

Glacier.Router.ThreadPool.SizeWarn=num

Description

Defines the value of the property adapter.ThreadPool.SizeWarn for the object adapter named Glacier.Router.

Glacier.Router.Client.ThreadPool.Size

Synopsis

Glacier.Router.Client.ThreadPool.Size=num

Description

Defines the value of the property adapter.ThreadPool.Size for the object adapter named Glacier.Router.Client.

Glacier.Router.Client.ThreadPool.SizeMax

Synopsis

Glacier.Router.Client.ThreadPool.SizeMax=num

Description

Defines the value of the property adapter.ThreadPool.SizeMax for the object adapter named Glacier.Router.Client.

Glacier.Router.Client.ThreadPool.SizeWarn

Synopsis

Glacier.Router.Client.ThreadPool.SizeWarn=num

Description

Defines the value of the property adapter.ThreadPool.SizeWarn for the object adapter named Glacier.Router.Client.

Glacier.Router.Server.ThreadPool.Size

Synopsis

Glacier.Router.Server.ThreadPool.Size=num

Description

Defines the value of the property adapter.ThreadPool.Size for the object adapter named Glacier.Router.Server.

Glacier.Router.Server.ThreadPool.SizeMax

Synopsis

Glacier.Router.Server.ThreadPool.SizeMax=num

Description

Defines the value of the property adapter.ThreadPool.SizeMax for the object adapter named Glacier.Router.Server.

Glacier.Router.Server.ThreadPool.SizeWarn

Synopsis

Glacier.Router.Server.ThreadPool.SizeWarn=num

Description

Defines the value of the property adapter.ThreadPool.SizeWarn for the object adapter named Glacier.Router.Server.