---
title: "IceGrid.*"
url: https://docs.zeroc.com/ice/3.8/property-reference/icegrid-properties
docs_index: https://docs.zeroc.com/llms.txt
---

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

# IceGrid.\*

## IceGrid.InstanceName

`IceGrid.InstanceName=name`

Specifies an alternate identity category for the [well-known IceGrid objects](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-server-reference/well-known-registry-objects.md). If defined, the IceGrid objects use `name` as their identity category, for example:

`name/AdminSessionManager` `name/AdminSessionManager-replica` `name/AdminSSLSessionManager` `name/AdminSSLSessionManager-replica` `name/NullPermissionsVerifier` `name/NullSSLPermissionsVerifier` `name/Locator` `name/Query` `name/Registry` `name/Registry-replica` `name/RegistryUserAccountMapper` `name/RegistryUserAccountMapper-replica` `name/SessionManager` `name/SSLSessionManager`

If this property is not set, the category (`name`) is computed as follows:

- if `IceLocatorDiscovery.InstanceName` is defined, use its value; otherwise
- if a default locator is set on the communicator (typically via `Ice.Default.Locator`), use the category of the locator proxy; otherwise
- use `IceGrid`

For example, in the configuration of an IceGrid node, you don’t need to set `IceGrid.InstanceName` since you already specify it indirectly with `Ice.Default.Locator`.

## IceGrid.Node.*AdapterProperty*

`IceGrid.Node.AdapterProperty=value`

An IceGrid node uses the adapter name `IceGrid.Node` for the object adapter that the registry contacts to communicate with the node. The node requires [IceGrid.Node.Endpoints](https://docs.zeroc.com/ice/3.8/property-reference/object-adapter-properties.md#adapter.endpoints) to start.

## IceGrid.Node.AllowEndpointsOverride

`IceGrid.Node.AllowEndpointsOverride=num`

When this property is set to `1`, an IceGrid node lets a server managed by the node replace the endpoints an object adapter has already registered, even while the server is active. A server needs this permission to call `setPublishedEndpoints` on such an object adapter. The default value is `0`.

## IceGrid.Node.AllowRunningServersAsRoot

`IceGrid.Node.AllowRunningServersAsRoot=num`

When this property is set to `1`, an IceGrid node permits servers started by the node to run with super-user privileges. Do not set it unless the node uses a secure endpoint; otherwise, clients can start arbitrary processes with super-user privileges on the node's machine.

The default value is `0`.

## IceGrid.Node.CollocateRegistry

`IceGrid.Node.CollocateRegistry=num`

If `num` is set to a value larger than `0`, the [node](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-server-reference/icegridnode.md) collocates the IceGrid registry.

The collocated registry is configured with the same properties as the standalone IceGrid registry.

## IceGrid.Node.Data

`IceGrid.Node.Data=path`

Defines the path of the IceGrid node [data directory](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-server-reference/icegridnode.md). This property must be defined for each node, and the directory must already exist. The node creates a `servers` subdirectory in this directory if it does not already exist; `servers` contains the configuration files and data directory of each [deployed server](https://docs.zeroc.com/ice/3.8/services/icegrid/using-icegrid-deployment.md).

## IceGrid.Node.DisableOnFailure

`IceGrid.Node.DisableOnFailure=num`

The node considers a server to have terminated improperly if it has a non-zero exit code or if it exits due to one of the signals `SIGABRT`, `SIGBUS`, `SIGILL`, `SIGFPE`, or `SIGSEGV`. The node marks such a server as disabled if `num` is a non-zero value; a [disabled server](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-troubleshooting.md) cannot be activated on demand. For values of `num` greater than `0`, the server is disabled for `num` seconds. If `num` is a negative value, the server is disabled indefinitely, or until it is explicitly enabled or started via an administrative action. The default value is `0`, meaning the node does not disable servers in this situation.

## IceGrid.Node.Name

`IceGrid.Node.Name=name`

Defines the `name` of the IceGrid node. Each node in an IceGrid deployment must have a unique name. This property must be defined for each node.

## IceGrid.Node.Output

`IceGrid.Node.Output=path`

Defines the path of the IceGrid node output directory. If set, the node redirects the `stdout` of each server it starts to `path/server-id.out` and its `stderr` to `path/server-id.err`, where `server-id` is the server's ID. A server whose own configuration sets [Ice.StdOut](https://docs.zeroc.com/ice/3.8/property-reference/ice-properties.md) or [Ice.StdErr](https://docs.zeroc.com/ice/3.8/property-reference/ice-properties.md) keeps that setting. With [IceGrid.Node.RedirectErrToOut](#icegrid.node.redirecterrtoout) set, `stderr` goes to the `.out` file too. If this property is not set, the servers share the `stdout` and `stderr` of the node's process.

## IceGrid.Node.PrintServersReady

`IceGrid.Node.PrintServersReady=token`

The IceGrid node prints "`token` ready" on standard output after all the servers managed by the node are ready. This is useful for scripts that wish to wait until all servers have been started and are ready for use.

## IceGrid.Node.ProcessorSocketCount

`IceGrid.Node.ProcessorSocketCount=num`

This property sets the number of processor sockets. This value is reported by the [icegridadmin](https://docs.zeroc.com/ice/3.8/services/icegrid/icegridadmin-command-line-tool.md) `node sockets` command. On Windows Vista (or later), Windows Server 2008 (or later), and Linux systems, the number of processor sockets is set automatically by the Ice runtime. On other systems, the runtime cannot obtain the socket count from the operating system; you can use this property to set the number of processor sockets manually on such systems.

## IceGrid.Node.PropertiesOverride

`IceGrid.Node.PropertiesOverride=overrides`

Defines a list of properties that override the properties defined in server deployment descriptors. For example, in some cases it is desirable to set the property [Ice.Default.Host](https://docs.zeroc.com/ice/3.8/property-reference/ice-default-properties.md) for servers, but not in server deployment descriptors. The property definitions must be separated by white space.

## IceGrid.Node.RedirectErrToOut

`IceGrid.Node.RedirectErrToOut=num`

If `num` is set to a value larger than `0`, the node redirects the `stderr` of each server it starts to the server's `.out` file instead of its `.err` file. This property takes effect only when [IceGrid.Node.Output](#icegrid.node.output) is set.

## IceGrid.Node.Trace.Activator

`IceGrid.Node.Trace.Activator=num`

The activator trace level:

| Value | Description |
| --- | --- |
| `0` | No activator trace (default). |
| `1` | Trace process activation, termination. |
| `2` | Like `1`, but more verbose: includes process signaling, the activation parameters of each spawned server (path, working directory, uid/gid, arguments, and environment variables), and more diagnostic messages. Note: environment variables and arguments may carry secrets (passwords, tokens, certificate passphrases) injected via your deployment — treat the trace output as sensitive. |

## IceGrid.Node.Trace.Adapter

`IceGrid.Node.Trace.Adapter=num`

The object adapter trace level:

| Value | Description |
| --- | --- |
| `0`, `1` | No object adapter trace. The default value is `0`. |
| `2` | Trace object adapter activation, deactivation, and activation failures. |
| `3` | Like `2`, plus requests waiting for the activation of an object adapter. |

## IceGrid.Node.Trace.Admin

`IceGrid.Node.Trace.Admin=num`

Set the trace level for the routing of operations to Ice.Admin objects through this node.

| Value | Description |
| --- | --- |
| `0` | No admin trace (default). |
| `1` | Trace routing of operations to Ice.Admin objects |

## IceGrid.Node.Trace.Replica

`IceGrid.Node.Trace.Replica=num`

The replica trace level:

| Value | Description |
| --- | --- |
| `0` | No replica trace (default). |
| `1` | Trace session lifecycle between nodes and replicas. |
| `2` | Like `1`, but more verbose, including session establishment attempts and failures. |
| `3` | Like `2`, but more verbose, including keep alive messages sent to the replica. |

## IceGrid.Node.Trace.Server

`IceGrid.Node.Trace.Server=num`

Sets the node's trace level for server configuration updates and state changes:

| Value | Description |
| --- | --- |
| `0` | No server trace (default). |
| `1` | Trace completed server configuration and runtime property updates. |
| `2` | Like `1`, plus runtime property update attempts for individual servers and services, activation timeouts, and changes to the Active, Inactive, and Destroyed states. Changes from Loading to Inactive require level `3`. |
| `3` | Like `2`, plus all other server state changes, including Loading and WaitForActivation. |

## IceGrid.Node.UserAccountMapper

`IceGrid.Node.UserAccountMapper=proxy`

Specifies the proxy of an object that implements the [`IceGrid::UserAccountMapper`](https://code.zeroc.com/ice/3.8/api/slice/interfaceIceGrid_1_1UserAccountMapper.html) interface. The node uses this object to map a server's user string to the operating system account under which it runs the server; see [Activating Servers with Specific User IDs](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-server-activation.md#activating-servers-with-specific-user-ids). The node can run a server under an account other than its own only when it runs as root on Linux or macOS. When this property is set, the node ignores `IceGrid.Node.UserAccounts`.

As a proxy property, you can configure additional [aspects of the proxy](https://docs.zeroc.com/ice/3.8/property-reference/proxy-properties.md) using properties.

## IceGrid.Node.UserAccounts

`IceGrid.Node.UserAccounts=file`

Specifies the file name of an IceGrid node user account map file. The node uses this file to map a server's user string to the operating system account under which the node runs the server; see [Activating Servers with Specific User IDs](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-server-activation.md#activating-servers-with-specific-user-ids). Each line of the file contains an account name, white space, and a user string; the user string is the rest of the line and may contain spaces. A `#` starts a comment that runs to the end of the line. The node can run a server under an account other than its own only when it runs as root on Linux or macOS. The node ignores this property when `IceGrid.Node.UserAccountMapper` is set.

## IceGrid.Node.WaitTime

`IceGrid.Node.WaitTime=num`

Defines the interval in seconds that IceGrid waits for [server activation and deactivation](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-server-activation.md).

A server activated by the node completes its activation when its object adapters with server lifetime have registered their endpoints and, when its administrative facility is enabled, the server has registered its `Process` facet. If the server does not complete its activation within this interval, the registry answers the locate requests waiting for this server without its endpoints: a client resolving a replica group receives the endpoints of the replicas that did activate, and a client resolving one of the server's object adapters receives no endpoints.

If a server is being gracefully deactivated and IceGrid does not detect the server deactivation during this time interval, IceGrid kills the server.

A server descriptor's `activation-timeout` and `deactivation-timeout` attributes, when set to a non-zero value, override this property for that server.

The default value is 60 seconds.

## IceGrid.Registry.AdminCryptPasswords

`IceGrid.Registry.AdminCryptPasswords=file`

Specifies the file name of an IceGrid registry [password file for administrative clients](https://docs.zeroc.com/ice/3.8/services/icegrid/resource-allocation-using-icegrid-sessions.md). The file uses the format described in [IceGrid.Registry.CryptPasswords](#icegrid.registry.cryptpasswords). This property is ignored if [IceGrid.Registry.AdminPermissionsVerifier](#icegrid.registry.adminpermissionsverifier) is defined. When neither property is defined, the registry rejects administrative sessions created with a user name and password.

## IceGrid.Registry.AdminPermissionsVerifier

`IceGrid.Registry.AdminPermissionsVerifier=proxy`

Specifies the proxy of an object that implements the `Glacier2::PermissionsVerifier` interface for [controlling access to IceGrid administrative sessions](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-administrative-sessions.md). The IceGrid registry invokes this proxy to validate each new administrative session created by a client with the `IceGrid::Registry` interface.

As a proxy property, you can configure additional [aspects of the proxy](https://docs.zeroc.com/ice/3.8/property-reference/proxy-properties.md) using properties.

## IceGrid.Registry.AdminSessionFilters

`IceGrid.Registry.AdminSessionFilters=num`

When a client creates an administrative session through a [Glacier2](https://docs.zeroc.com/ice/3.8/services/glacier2.md) router, using the [IceGrid session manager](https://docs.zeroc.com/ice/3.8/services/icegrid/glacier2-integration-with-icegrid.md), this property controls whether IceGrid restricts the objects the client can reach through the router. If `num` is set to a value larger than `0`, IceGrid configures [Glacier2's filters](https://docs.zeroc.com/ice/3.8/services/glacier2/securing-a-glacier2-router.md) for the session to allow only the `IceGrid::AdminSession` object, the `IceGrid::Admin` object that is returned by the `getAdmin` operation, the `IceGrid::Query` object, and the server admin objects returned by `IceGrid::Admin::getServerAdmin`. If `num` is set to `0`, IceGrid configures no filters, and access to objects is controlled solely by Glacier2's configuration.

The default value is `0`.

## IceGrid.Registry.AdminSessionManager.*AdapterProperty*

`IceGrid.Registry.AdminSessionManager.AdapterProperty=value`

The IceGrid registry uses the adapter name `IceGrid.Registry.AdminSessionManager` for the object adapter that processes incoming requests from [IceGrid administrative sessions](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-administrative-sessions.md).

The registry creates this adapter only when [IceGrid.Registry.AdminSessionManager.Endpoints](https://docs.zeroc.com/ice/3.8/property-reference/object-adapter-properties.md#adapter.endpoints) is set. These endpoints should only be accessible to Glacier2 routers used to create IceGrid administrative sessions.

## IceGrid.Registry.AdminSSLPermissionsVerifier

`IceGrid.Registry.AdminSSLPermissionsVerifier=proxy`

Specifies the proxy of an object that implements the `Glacier2::SSLPermissionsVerifier` interface for [controlling access to IceGrid administrative sessions](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-administrative-sessions.md). The IceGrid registry invokes this proxy to validate each new administrative session created by a client from a secure connection with the `IceGrid::Registry` interface.

As a proxy property, you can configure additional [aspects of the proxy](https://docs.zeroc.com/ice/3.8/property-reference/proxy-properties.md) using the properties.

## IceGrid.Registry.Client.*AdapterProperty*

`IceGrid.Registry.Client.AdapterProperty=value`

IceGrid uses the adapter name `IceGrid.Registry.Client` for the object adapter that processes incoming requests from clients.

The registry requires [IceGrid.Registry.Client.Endpoints](https://docs.zeroc.com/ice/3.8/property-reference/object-adapter-properties.md#adapter.endpoints) to start. [IANA](https://www.iana.org/assignments/service-names-port-numbers) has assigned the port numbers `4061` (TCP) and `4062` (SSL) to the registry.

## IceGrid.Registry.CryptPasswords

`IceGrid.Registry.CryptPasswords=file`

Specifies the file name of an IceGrid registry [password file](https://docs.zeroc.com/ice/3.8/services/icegrid/resource-allocation-using-icegrid-sessions.md). Each non-blank line of the file contains a user name and a password hash, separated by white space. The supported hash formats depend on the platform; see [Writing a Password File](https://docs.zeroc.com/ice/3.8/services/glacier2/getting-started-with-glacier2.md#writing-a-password-file).

This property is ignored if [IceGrid.Registry.PermissionsVerifier](#icegrid.registry.permissionsverifier) is defined. When neither property is defined, the registry rejects sessions created with a user name and password.

## IceGrid.Registry.DefaultTemplates

`IceGrid.Registry.DefaultTemplates=path`

Defines the path name of an XML file containing default [template descriptors](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-templates.md). A sample file named `config/templates.xml` that contains convenient server templates for Ice services is provided in the Ice distribution.

When this property is not set, the registry has no default templates.

## IceGrid.Registry.Discovery.*AdapterProperty*

`IceGrid.Registry.Discovery.AdapterProperty=value`

The IceGrid registry creates an object adapter named `IceGrid.Registry.Discovery` for receiving [multicast discovery queries](https://docs.zeroc.com/ice/3.8/plugins/icelocatordiscovery.md) from clients. When [IceGrid.Registry.Discovery.Endpoints](https://docs.zeroc.com/ice/3.8/property-reference/object-adapter-properties.md#adapter.endpoints) is not set, the registry sets it to:

`udp -h "addr" -p port [--interface "intf"]`

where `addr` is the value of `IceGrid.Registry.Discovery.Address`, `port` is the value of `IceGrid.Registry.Discovery.Port`, and `intf` is the value of `IceGrid.Registry.Discovery.Interface`.

## IceGrid.Registry.Discovery.Address

`IceGrid.Registry.Discovery.Address=addr`

Specifies the multicast IP address to use for receiving multicast discovery queries. The default value is `239.255.0.1`; it is `ff15::1` when [Ice.IPv4](https://docs.zeroc.com/ice/3.8/property-reference/ice-properties.md) is disabled or [Ice.PreferIPv6Address](https://docs.zeroc.com/ice/3.8/property-reference/ice-properties.md) is enabled. This property is used to compose the endpoint of the IceGrid.Registry.Discovery object adapter.

## IceGrid.Registry.Discovery.Enabled

`IceGrid.Registry.Discovery.Enabled=num`

If `num` is a value larger than `0`, the registry creates the IceGrid.Registry.Discovery object adapter and listens for [multicast discovery queries](https://docs.zeroc.com/ice/3.8/plugins/icelocatordiscovery.md). If not defined, the default value is `1`. Set this property to `0` to disable multicast discovery.

## IceGrid.Registry.Discovery.Interface

`IceGrid.Registry.Discovery.Interface=intf`

Specifies the IP address of the interface to use for receiving multicast discovery queries. If not defined, the operating system will select a default interface to send and receive the UDP multicast datagrams. This property is used to compose the endpoint of the IceGrid.Registry.Discovery object adapter.

## IceGrid.Registry.Discovery.Port

`IceGrid.Registry.Discovery.Port=port`

Specifies the multicast port to use for receiving multicast discovery queries. If not set, the default value is `4061`. This property is used to compose the endpoint of the IceGrid.Registry.Discovery object adapter.

## IceGrid.Registry.DynamicRegistration

`IceGrid.Registry.DynamicRegistration=num`

If `num` is set to a value larger than `0`, the locator registry does not require Ice servers to preregister object adapters and replica groups, but rather creates them automatically if they do not exist. If this property is not defined, or `num` is set to `0`, an attempt to register an unknown object adapter or replica group causes adapter activation to fail with `Ice.NotRegisteredException`. An object adapter registers itself when the [*adapter*.AdapterId](https://docs.zeroc.com/ice/3.8/property-reference/object-adapter-properties.md) property is defined. The [*adapter*.ReplicaGroupId](https://docs.zeroc.com/ice/3.8/property-reference/object-adapter-properties.md) property identifies the replica group. An adapter registered with dynamic registration can only be a member of a replica group also registered with dynamic registration. Trying to dynamically register an adapter with a replica group registered with the [deployment facility](https://docs.zeroc.com/ice/3.8/services/icegrid/using-icegrid-deployment.md) will fail with `Ice.NotRegisteredException`.

## IceGrid.Registry.Internal.*AdapterProperty*

`IceGrid.Registry.Internal.AdapterProperty=value`

The IceGrid registry uses the adapter name `IceGrid.Registry.Internal` for the object adapter that processes incoming requests from nodes and slave replicas.

The registry requires [IceGrid.Registry.Internal.Endpoints](https://docs.zeroc.com/ice/3.8/property-reference/object-adapter-properties.md#adapter.endpoints) to start.

## IceGrid.Registry.LMDB.MapSize

`IceGrid.Registry.LMDB.MapSize=num`

Specifies the map size for the IceGrid [LMDB](http://www.lmdb.tech/doc/) database environment. The value is specified in megabytes. If not set, IceGrid uses a system-dependent default: 10 MB on Windows, and 100 MB on other platforms.

## IceGrid.Registry.LMDB.Path

`IceGrid.Registry.LMDB.Path=path`

Specifies the path of the directory where the IceGrid registry keeps its [persistent data](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-server-reference/icegrid-persistent-data.md), stored in an [LMDB](http://www.lmdb.tech/doc/) database environment: the deployed applications, and the well-known objects and object adapter endpoints registered at run time. This property must be defined, and the directory specified in `path` must exist: the IceGrid registry does not create this directory.

## IceGrid.Registry.NodeSessionTimeout

`IceGrid.Registry.NodeSessionTimeout=num`

Each IceGrid node establishes a session with the registry that must be refreshed periodically. If a node does not refresh its session within `num` seconds, the node's session is destroyed and the servers deployed on that node become unavailable to new clients. If not specified, the default value is 30 seconds.

A value of `0` disables the expiration of node sessions; any other value must be at least `10`.

## IceGrid.Registry.PermissionsVerifier

`IceGrid.Registry.PermissionsVerifier=proxy`

Specifies the proxy of an object that implements the `Glacier2::PermissionsVerifier` interface for [controlling access to IceGrid sessions](https://docs.zeroc.com/ice/3.8/services/icegrid/resource-allocation-using-icegrid-sessions.md). The IceGrid registry invokes this proxy to validate each new client session created by a client with the `IceGrid::Registry` interface.

As a proxy property, you can configure additional [aspects of the proxy](https://docs.zeroc.com/ice/3.8/property-reference/proxy-properties.md) using properties.

## IceGrid.Registry.ReplicaName

`IceGrid.Registry.ReplicaName=name`

Specifies the name of a [registry replica](https://docs.zeroc.com/ice/3.8/services/icegrid/registry-replication.md). If not defined, the default value is `Master`, which is the name reserved for the master replica. Each registry replica must have a unique name.

## IceGrid.Registry.ReplicaSessionTimeout

`IceGrid.Registry.ReplicaSessionTimeout=num`

Each IceGrid [registry replica](https://docs.zeroc.com/ice/3.8/services/icegrid/registry-replication.md) establishes a session with the master registry that must be refreshed periodically. If a replica does not refresh its session within `num` seconds, the replica's session is destroyed and the replica no longer receives replication information from the master registry. If not specified, the default value is 30 seconds.

A value of `0` disables the expiration of replica sessions; any other value must be at least `10`.

## IceGrid.Registry.Server.*AdapterProperty*

`IceGrid.Registry.Server.AdapterProperty=value`

The IceGrid registry uses the adapter name `IceGrid.Registry.Server` for the object adapter that processes incoming requests from servers.

The registry requires [IceGrid.Registry.Server.Endpoints](https://docs.zeroc.com/ice/3.8/property-reference/object-adapter-properties.md#adapter.endpoints) to start.

## IceGrid.Registry.SessionFilters

`IceGrid.Registry.SessionFilters=num`

This property controls whether IceGrid establishes filters for sessions created with the [IceGrid session manager](https://docs.zeroc.com/ice/3.8/services/icegrid/glacier2-integration-with-icegrid.md). If `num` is set to a value larger than `0`, IceGrid establishes these filters, so Glacier2 limits access to the `IceGrid::Query` and `IceGrid::Session` objects, and to objects and adapters allocated by the session. If `num` is set to `0`, IceGrid does not establish filters, so access to objects is controlled solely by Glacier2's configuration.

The default value is `0`.

## IceGrid.Registry.SessionManager.*AdapterProperty*

`IceGrid.Registry.SessionManager.AdapterProperty=value`

The IceGrid registry uses the adapter name `IceGrid.Registry.SessionManager` for the object adapter that processes incoming requests from [client sessions](https://docs.zeroc.com/ice/3.8/services/icegrid/resource-allocation-using-icegrid-sessions.md).

The registry creates this adapter only when [IceGrid.Registry.SessionManager.Endpoints](https://docs.zeroc.com/ice/3.8/property-reference/object-adapter-properties.md#adapter.endpoints) is set. These endpoints should only be accessible to Glacier2 routers used to create IceGrid client sessions.

## IceGrid.Registry.SSLPermissionsVerifier

`IceGrid.Registry.SSLPermissionsVerifier=proxy`

Specifies the proxy of an object that implements the `Glacier2::SSLPermissionsVerifier` interface for [controlling access to IceGrid sessions](https://docs.zeroc.com/ice/3.8/services/icegrid/resource-allocation-using-icegrid-sessions.md). The IceGrid registry invokes this proxy to validate each new client session created by a client from a secure connection with the `IceGrid::Registry` interface.

As a proxy property, you can configure additional [aspects of the proxy](https://docs.zeroc.com/ice/3.8/property-reference/proxy-properties.md) using properties.

## IceGrid.Registry.Trace.Adapter

`IceGrid.Registry.Trace.Adapter=num`

The object adapter trace level:

| Value | Description |
| --- | --- |
| `0` | No object adapter trace (default). |
| `1` | Trace object adapter registration, removal, and replication. |

## IceGrid.Registry.Trace.Admin

`IceGrid.Registry.Trace.Admin=num`

Set the trace level for the routing of operations to Ice.Admin objects through this registry.

| Value | Description |
| --- | --- |
| `0` | No admin trace (default). |
| `1` | Trace routing of operations to Ice.Admin objects |

## IceGrid.Registry.Trace.Application

`IceGrid.Registry.Trace.Application=num`

The application trace level:

| Value | Description |
| --- | --- |
| `0` | No application trace (default). |
| `1` | Trace application addition, update, and removal. |

## IceGrid.Registry.Trace.Discovery

`IceGrid.Registry.Trace.Discovery=num`

The discovery trace level:

| Value | Description |
| --- | --- |
| `0` | No discovery trace (default). |
| `1` | Trace replied discovery lookup requests. |
| `2` | Like `1`, also includes discarded lookup requests. |

## IceGrid.Registry.Trace.Locator

`IceGrid.Registry.Trace.Locator=num`

The locator and locator registry trace level:

| Value | Description |
| --- | --- |
| `0` | No locator trace (default). |
| `1` | Trace failures to locate an adapter or object, and failures to register adapter endpoints. |
| `2` | Like `1`, but more verbose, including registration of adapter endpoints. |

## IceGrid.Registry.Trace.Node

`IceGrid.Registry.Trace.Node=num`

The node trace level:

| Value | Description |
| --- | --- |
| `0` | No node trace (default). |
| `1`, `2` | Trace nodes going up and down, and node session creation and destruction. |
| `3` | Like `1`, plus the keep-alive messages of each node with its load averages. |

## IceGrid.Registry.Trace.Object

`IceGrid.Registry.Trace.Object=num`

The object trace level:

| Value | Description |
| --- | --- |
| `0` | No object trace (default). |
| `1` | Trace object registration, removal. |
| `2` | Like `1`, plus the allocation and release of allocatable objects. |

## IceGrid.Registry.Trace.Replica

`IceGrid.Registry.Trace.Replica=num`

The replica trace level:

| Value | Description |
| --- | --- |
| `0` | No replica trace (default). |
| `1` | Trace replicas going up and down, and the session lifecycle between the master replica and the other replicas. |
| `2` | Like `1`, plus session establishment attempts and failures. |
| `3` | Like `2`, plus keep-alive messages. |

## IceGrid.Registry.Trace.Server

`IceGrid.Registry.Trace.Server=num`

The server trace level:

| Value | Description |
| --- | --- |
| `0` | No server trace (default). |
| `1` | Trace the addition and removal of servers in the Registry database. |
| `2` | Like `1`, but more verbose: includes load/unload failures, properties updates, and more. |
| `3` | Like `2`, plus the start of each server load and unload on a node. |

## IceGrid.Registry.Trace.Session

`IceGrid.Registry.Trace.Session=num`

The session trace level:

| Value | Description |
| --- | --- |
| `0` | No client or admin session trace (default). |
| `1` | Trace client or admin session creation and destruction, and failures to call a permissions verifier. |

## IceGrid.Registry.UserAccounts

`IceGrid.Registry.UserAccounts=file`

Specifies the file name of an IceGrid registry user account map file, in the format described in [IceGrid.Node.UserAccounts](#icegrid.node.useraccounts). The registry serves this file through the well-known object `IceGrid/RegistryUserAccountMapper`. An IceGrid node whose `IceGrid.Node.UserAccountMapper` property is set to this proxy uses the file to map a server's user string to the operating system account under which the node runs the server; see [Activating Servers with Specific User IDs](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-server-activation.md#activating-servers-with-specific-user-ids). The node can run a server under an account other than its own only when it runs as root on Linux or macOS.
