Table of Contents Previous Next
Logo
Properties : D.5 Ice Administrative Properties
Copyright © 2003-2010 ZeroC, Inc.

D.5 Ice Administrative Properties

Ice.Admin.name

Synopsis

Ice.Admin.name=value

Description

The Ice run time creates an internal object adapter named Ice.Admin if Ice.Admin.Endpoints is defined and one of the following are true:
• Ice.Admin.InstanceName is defined
• Ice.Admin.ServerId and Ice.Default.Locator are defined
The purpose of this object adapter is to host an Ice object whose facets provide administrative capabilities to remote clients. All of the adapter properties detailed in Section D.4 can be used to configure the Ice.Admin object adapter.
Note that enabling the Ice.Admin object adapter is a security risk because a hostile client could use the administrative object to shut down the process. As a result, the endpoints for this object adapter should be carefully defined so that only trusted clients are allowed to use it.
See Section 32.18 for more information on the administrative object.

Ice.Admin.DelayCreation

Synopsis

Ice.Admin.DelayCreation=num

Description

If num is a value greater than zero, the Ice run time delays the creation of the administrative object adapter until getAdmin is invoked on the communicator. If not specified, the default value is zero, meaning the object adapter is created immediately after all plug‑ins are initialized. See Section 32.18.2 for more infor­mation on the administrative object adapter.

Ice.Admin.Facets

Synopsis

Ice.Admin.Facets=name [name ...]

Description

Specifies the facets enabled by the administrative object. See Section 32.18.6 for a discussion of the facets that the administrative object enables by default. Facet names are delimited by commas or white space. A facet name that contains white space must be enclosed in single or double quotes. If not specified, all facets are enabled.

Ice.Admin.InstanceName

Synopsis

Ice.Admin.InstanceName=name

Description

Specifies an identity category for the administrative object (see Section 32.18). If defined, the identity of the object becomes name/admin. If not specified, the default identity category is a UUID.

Ice.Admin.ServerId

Synopsis

Ice.Admin.ServerId=id

Description

Specifies an identifier that uniquely identifies the process when the Ice.Admin object adapter registers with the locator registry. See Section 38.22 for more information.

Table of Contents Previous Next
Logo