---
title: "Ice.Admin.*"
url: https://docs.zeroc.com/ice/3.8/property-reference/ice-admin-properties
language: swift
docs_index: https://docs.zeroc.com/llms.txt
---

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

# Ice.Admin.\*

Programming language: Swift. Other languages: [C++](https://docs.zeroc.com/ice/3.8/property-reference/ice-admin-properties/cpp.md), [C#](https://docs.zeroc.com/ice/3.8/property-reference/ice-admin-properties/csharp.md), [Java](https://docs.zeroc.com/ice/3.8/property-reference/ice-admin-properties/java.md), [JavaScript](https://docs.zeroc.com/ice/3.8/property-reference/ice-admin-properties/js.md), [MATLAB](https://docs.zeroc.com/ice/3.8/property-reference/ice-admin-properties/matlab.md), [PHP](https://docs.zeroc.com/ice/3.8/property-reference/ice-admin-properties/php.md), [Python](https://docs.zeroc.com/ice/3.8/property-reference/ice-admin-properties/python.md), [Ruby](https://docs.zeroc.com/ice/3.8/property-reference/ice-admin-properties/ruby.md).

## Ice.Admin.*AdapterProperty*

`Ice.Admin.AdapterProperty=value`

The Ice runtime creates and activates an [administrative object adapter](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/creating-the-admin-object/swift.md) named `Ice.Admin` if the [Administrative Facility](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/swift.md) is enabled, [Ice.Admin.Endpoints](https://docs.zeroc.com/ice/3.8/property-reference/object-adapter-properties/swift.md#adapter.endpoints) is defined and one of the following is true:

- [Ice.Admin.DelayCreation](#ice.admin.delaycreation) is not enabled
- [Ice.Admin.DelayCreation](#ice.admin.delaycreation) is enabled and the application calls `getAdmin` on the communicator after communicator initialization
- the application calls [`createAdmin`](https://code.zeroc.com/ice/3.8/api/swift/documentation/ice/communicator/createadmin(adminadapter:adminid:)) on the communicator with a null `adminAdapter` parameter

This object adapter is created to host the [admin object](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/admin-object/swift.md).

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](https://docs.zeroc.com/ice/3.8/runtime/dispatch/object-adapter-endpoints/swift.md) for this object adapter should be carefully defined so that only trusted clients are allowed to use it.

## Ice.Admin.DelayCreation

`Ice.Admin.DelayCreation=num`

If `num` is a value greater than `0`, the Ice runtime delays the creation of the `Ice.Admin` [administrative object adapter](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/creating-the-admin-object/swift.md) until `getAdmin` is invoked on the communicator. If not specified, the default value is `0`, meaning the `Ice.Admin` object adapter is created immediately after all plug-ins are initialized, provided [Ice.Admin.Endpoints](#ice.admin.adapterproperty) is defined.

## Ice.Admin.Enabled

`Ice.Admin.Enabled=num`

`1` enables the [Administrative Facility](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/swift.md) and `0` disables it. When this property is unset, the facility is enabled if and only if [Ice.Admin.Endpoints](#ice.admin.adapterproperty) is non-empty.

## Ice.Admin.Facets

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

Specifies the facets enabled by the [administrative object](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/admin-object/swift.md), allowing you to [filter](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/filtering-administrative-facets/swift.md) 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. While the Ice runtime creates only the built-in facets (such as Process and Properties) that are enabled, you can create administrative facets without checking the value of this property. Ice ensures that only enabled administrative facets are available to clients.

## Ice.Admin.InstanceName

`Ice.Admin.InstanceName=name`

Specifies an identity category for the [administrative object](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/swift.md), when this object is created during communicator initialization or by a call to `getAdmin` on the communicator. If defined, the identity of the object becomes `name/admin`. If not specified, the default identity category is a UUID.

## Ice.Admin.Logger.KeepLogs

`Ice.Admin.Logger.KeepLogs=num`

The [Logger admin facet](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/logger-facet/swift.md), when enabled, caches up the *num* most recent log messages with a type other than `Ice::TraceMessage`. When *num* is `0` or less than `0`, the Logger facet does not cache any of these log messages. The default value for *num* is `100`.

## Ice.Admin.Logger.KeepTraces

`Ice.Admin.Logger.KeepTraces=num`

The [Logger admin facet](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/logger-facet/swift.md), when enabled, caches up the *num* most recent log messages with type `Ice::TraceMessage`. When *num* is `0` or less than `0`, the Logger facet does not cache any of these trace messages. The default value for *num* is `100`.

## Ice.Admin.Logger.Properties

`Ice.Admin.Logger.Properties=propertyList`

Specifies additional properties for the communicator that the [Logger admin facet](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/logger-facet/swift.md) uses to send log messages to remote loggers. The Logger facet creates this communicator when it attaches its first remote logger.

Ice copies properties with the prefixes `Ice.Default.Locator` and `IceSSL.` from the application's communicator to the Logger facet's communicator, then applies the properties in *propertyList*. These additional properties override copied values.

Ice reads *propertyList* as a [list of strings](https://docs.zeroc.com/ice/3.8/runtime/properties-and-configuration/properties-class/swift.md), each using the syntax `PropertyName=PropertyValue`. For example, this property enables protocol tracing on the Logger facet's communicator:

```config
Ice.Admin.Logger.Properties=Ice.Trace.Protocol=1
```

The Logger facet's communicator writes its log messages to the local logger only, so the Logger facet does not forward them to remote loggers.

## Ice.Admin.ServerId

`Ice.Admin.ServerId=id`

Specifies an identifier that uniquely identifies the process when the Ice runtime [registers the Process facet of its admin object with the locator registry](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-and-the-administrative-facility.md).
