Creating the admin Object
3 min read
3 min read
3 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 endpoints of the object adapter that hosts the admin object determine which clients can reach it; see Securing the admin Object.
Hosting the admin Object in Your Own Object Adapter
An application can host the admin object in one of its own object adapters instead of the Ice.Admin object adapter. Set Ice.Admin.Enabled to 1 and leave Ice.Admin.Endpoints unset, so that the communicator does not create the admin object during initialization. Then call createAdmincreateAdmincreateAdmincreateAdmincreateAdmin with this object adapter and the identity of the admin object, and activate the object adapter.
Because you create this object adapter, you can give it its own SSL configuration, separate from the configuration of the communicator.