---
title: "Creating the admin Object"
url: https://docs.zeroc.com/ice/3.8/administration/administrative-facility/creating-the-admin-object
language: java
docs_index: https://docs.zeroc.com/llms.txt
---

> For an index of every page, see [llms.txt](https://docs.zeroc.com/llms.txt).

# Creating the admin Object

Programming language: Java. Other languages: [C++](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/creating-the-admin-object/cpp.md), [C#](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/creating-the-admin-object/csharp.md), [MATLAB](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/creating-the-admin-object/matlab.md), [PHP](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/creating-the-admin-object/php.md), [Python](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/creating-the-admin-object/python.md), [Ruby](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/creating-the-admin-object/ruby.md), [Swift](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/creating-the-admin-object/swift.md).

The administrative facility is disabled by default. To enable it, you must set the property [Ice.Admin.Enabled](https://docs.zeroc.com/ice/3.8/property-reference/ice-admin-properties/java.md#ice.admin.enabled) to `1`, or leave [Ice.Admin.Enabled](https://docs.zeroc.com/ice/3.8/property-reference/ice-admin-properties/java.md#ice.admin.enabled) unset and specify endpoints for the `Ice.Admin` administrative object adapter using the property [Ice.Admin.Endpoints](https://docs.zeroc.com/ice/3.8/property-reference/ice-admin-properties/java.md). When [Ice.Admin.Enabled](https://docs.zeroc.com/ice/3.8/property-reference/ice-admin-properties/java.md#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](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/filtering-administrative-facets/java.md) in the built-in `Ice.Admin` object adapter, when:

- The administrative facility is enabled,
- The [Ice.Admin.Endpoints](https://docs.zeroc.com/ice/3.8/property-reference/ice-admin-properties/java.md) property specifies endpoints for the Ice.Admin object adapter, and
- The [Ice.Admin.DelayCreation](https://docs.zeroc.com/ice/3.8/property-reference/ice-admin-properties/java.md#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](https://docs.zeroc.com/ice/3.8/property-reference/ice-admin-properties/java.md#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](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/process-facet/java.md) 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 [Communicator](https://code.zeroc.com/ice/3.8/api/java/com.zeroc.ice/com/zeroc/Ice/Communicator.html).

The endpoints of the object adapter that hosts the admin object determine which clients can reach it; see [Securing the admin Object](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/security-considerations-for-administrative-facets/java.md).

## 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 [`createAdmin`](https://code.zeroc.com/ice/3.8/api/java/com.zeroc.ice/com/zeroc/Ice/Communicator.html#createAdmin(com.zeroc.Ice.ObjectAdapter,com.zeroc.Ice.Identity)) 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](https://docs.zeroc.com/ice/3.8/runtime/ssl-transport/java.md), separate from the configuration of the communicator.

## See Also

- [Ice.Admin.\*](https://docs.zeroc.com/ice/3.8/property-reference/ice-admin-properties/java.md)
- [IceGrid and the Administrative Facility](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-and-the-administrative-facility.md)
- [Securing the admin Object](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/security-considerations-for-administrative-facets/java.md)
- [Using the admin Object](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/using-the-admin-object/java.md)
