Glacier Router Starter Properties

Glacier.Starter.AdapterId

Synopsis

Glacier.Starter.AdapterId=id

Description

Defines the value of the property adapter.AdapterId for the object adapter named Glacier.Starter.

Glacier.Starter.Endpoints

Synopsis

Glacier.Starter.Endpoints=endpoints

Description

Defines the endpoints of the Glacier router starter.

Glacier.Starter.PublishedEndpoints

Synopsis

Glacier.Starter.PublishedEndpoints=endpoints

Description

Defines the published endpoints of the Glacier router starter. Refer to the description of the object adapter property adapter.PublishedEndpoints for more information.

Glacier.Starter.ThreadPool.Size

Synopsis

Glacier.Starter.ThreadPool.Size=num

Description

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

Glacier.Starter.ThreadPool.SizeMax

Synopsis

Glacier.Starter.ThreadPool.SizeMax=num

Description

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

Glacier.Starter.ThreadPool.SizeWarn

Synopsis

Glacier.Starter.ThreadPool.SizeWarn=num

Description

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

Glacier.Starter.PermissionsVerifier

Synopsis

Glacier.Starter.PermissionsVerifier=proxy

Description

If set, the specified permissions verifier is used. If not set, a built-in crypt-based verifier is used.

Glacier.Starter.CryptPasswords

Synopsis

Glacier.Starter.CryptPasswords=file

Description

The pathname of the file that contains user-id / password pairs, with the passwords being encrypted by the crypt algorithm. The default pathname is "passwords". This file is only used for the built-in crypt-based password verifier, meaning that the property is ignored if Glacier.Starter.PasswordVerifier is set.

Glacier.Starter.RouterPath

Synopsis

Glacier.Starter.RouterPath=path

Description

Sets the path of the Glacier router executable to be started. The default is glacier.

Glacier.Starter.PropertiesOverride

Synopsis

Glacier.Starter.PropertiesOverride=overrides

Description

By default, the Glacier router starter starts new routers with the exact same property set as for the router starter. overrides can contain a list of properties for the router, which are used in addition to the router starter's properties, or which override the router starter's properties. The property definitions should be separated by white space.

For example, in many cases it is desirable to set the property Ice.ServerIdleTime for the router, but not for the router starter. For an idle time of 60 seconds, this can be done by setting Glacier.Starter.PropertiesOverride=Ice.ServerIdleTime=60.

Glacier.Starter.StartupTimeout

Synopsis

Glacier.Starter.StartupTimeout=num

Description

num is the number of seconds the Glacier router starter waits for the router to start up. If this timeout expires, a Glacier::CannotStartRouterException is returned to the caller. The default value is 10 seconds. Timeout values smaller than one second are silently changed to 1 second. (Unix only.)

Glacier.Starter.AddUserToAllowCategories

Synopsis

Glacier.Starter.AddUserToAllowCategories=num

Description

Control the addition of the user id authenticated by the Glacier router starter to the Glacier.Router.AllowCategories property upon router startup:

0Do not add user id. (default)
1Add user id.
2Add user id with prepended underscore.

Glacier.Starter.Trace

Synopsis

Glacier.Starter.Trace=num

Description

The router starter trace level:

0No router starter trace. (default)
1Trace router startup exceptions.
2Also trace each successful router startup.

Glacier.Starter.Certificate.Country

Synopsis

Glacier.Starter.Certificate.Country=country code

Description

This property specifies the country code portion of the Distinguished Name (DN) values that are placed into certificates generated by the Glacier Router Starter for client applications and the Glacier Router itself. Examples of valid values for this field are "US" for the United States and "CA" for Canada. The default value is "US".

Glacier.Starter.Certificate.StateProvince

Synopsis

Glacier.Starter.Certificate.StateProvince=state/province code

Description

This property specifies the state or province code portion of the Distinguished Name (DN) values that are placed into certificates generated by the Glacier Router Starter for client applications and the Glacier Router itself. Examples of valid values for this field are "CA" for California and "British Columbia" for British Columbia, Canada. The default value is "DC".

Glacier.Starter.Certificate.Locality

Synopsis

Glacier.Starter.Certificate.Locality=city or town name

Description

This property specifies the locality portion of the Distinguished Name (DN) values that are placed into certificates generated by the Glacier Router Starter for client applications and the Glacier Router itself. The locality is usually the name of the city or town. The default value is "Washington".

Glacier.Starter.Certificate.Organization

Synopsis

Glacier.Starter.Certificate.Organization=organization or company name

Description

This property specifies the organization portion of the Distinguished Name (DN) values that are placed into certificates generated by the Glacier Router Starter for client applications and the Glacier Router itself. The organization is usually the name of the company or organization to which the certificate has been granted. The default value is "Some Company Inc.".

Glacier.Starter.Certificate.OrganizationalUnit

Synopsis

Glacier.Starter.Certificate.OrganizationalUnit=department

Description

This property specifies the organizational unit portion of the Distinguished Name (DN) values are placed into certificates generated by the Glacier Router Starter for client applications and the Glacier Router itself. The organization unit is usually the name of the department within the company or organization structure to which the certificate has been granted. The default value is "Sales".

Glacier.Starter.Certificate.CommonName

Synopsis

Glacier.Starter.Certificate.CommonName=contact name

Description

This property specifies the common name portion of the Distinguished Name (DN) values that are placed into certificates generated by the Glacier Router Starter for client applications and the Glacier Router itself. The common name is usually the name of the contact (a person's name) within the company and department to which the certificate has been granted. The default value is "John Doe".

Glacier.Starter.Certificate.BitStrength

Synopsis

Glacier.Starter.Certificate.BitStrength=number of bits

Description

This property specifies the bit strength that is used in the generation of certificates by the Glacier Router Starter for client applications and the Glacier Router itself. This value is the modulus size of the RSA key.

Although modulus size is determined by the needs of the particular application, care should be taken not to specify a size that is too large, as certificate generation is an expensive operation. Sizes less than 512 bits are not supported, and sizes that exceed 2048 bits should be chosen with generation times in mind. The default value is 1024 bits.

Glacier.Starter.Certificate.SecondsValid

Synopsis

Glacier.Starter.Certificate.SecondsValid=seconds

Description

This property specifies the number of seconds that certificates generated by the Glacier Router Starter are valid before they expire. The default value of 1 day (86,400 seconds).

Glacier.Starter.Certificate.IssuedAdjust

Synopsis

Glacier.Starter.Certificate.IssuedAdjust=(+/-) seconds

Description

This property adjusts the issued timestamp on dynamically-generated certificates for the Glacier Router. The default value is 0, which sets the issued time based on the system time when the certificate is actually created. Positive values adjust the timestamp into the future, and negative values adjust the timestamp into the past by the number of seconds indicated. This adjustment is relative to server time.