Creating the admin Object
2 min read
2 min read
2 min read
2 min read
2 min read
2 min read
2 min read
2 min read
The administrative facility is disabled by default. To enable it, you must set the property Ice.Admin.Enabled to 1, or leave Ice.Admin.Enabled unset and specify endpoints for the Ice.Admin administrative object adapter using the property Ice.Admin.Endpoints. When Ice.Admin.Enabled is set to 0, the administrative facility is disabled, and Ice.Admin.Endpoints is ignored.
Ice creates the admin object during communicator initialization, and hosts all its enabled facets in the built-in Ice.Admin object adapter, when:
- The administrative facility is enabled,
- The Ice.Admin.Endpoints property specifies endpoints for the Ice.Admin object adapter, and
- The Ice.Admin.DelayCreation property is not set, or is set to 0.
Ice gives this object the identity instance-name/admin, where instance-name is the value of the Ice.Admin.InstanceName property. If Ice.Admin.InstanceName is not set or empty, Ice generates a UUID for instance-name.
An application that needs to add or replace administrative facets before the admin object exposes them, such as the Process facet, sets Ice.Admin.DelayCreation to 1, with Ice.Admin.Endpoints set as above: the communicator then creates the admin object when the application calls getAdmin on the CommunicatorCommunicatorCommunicatorCommunicatorCommunicator.
The administrative facility introduces additional security considerations, therefore the endpoints for the object adapter where the admin object's facets are hosted must be chosen with caution.