---
title: "Registry Runtime Component"
url: https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-gui-tool/live-deployment-tab/runtime-components/registry-runtime-component
docs_index: https://docs.zeroc.com/llms.txt
---

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

# Registry Runtime Component

The registry is the root node of the Runtime Components tree, and represents the IceGrid registry process administered by IceGrid GUI.

## Actions

A registry provides the following actions, from its contextual menu and from the `Tools > Registry` menu:

- **Add Well-Known Object** Create a new dynamic well-known object in the IceGrid registry.
- **Retrieve Ice log** Retrieve the log messages sent to the IceGrid registry's [logger](https://docs.zeroc.com/ice/3.8/administration/logger-facility.md) into an [Ice Log Dialog](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-gui-tool/live-deployment-tab/ice-log-dialog.md). The Ice Log Dialog attaches a [remote logger](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/logger-facet.md) to the registry's logger.
- **Retrieve stdout** Retrieve the IceGrid registry's stdout into a [Log File Dialog](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-gui-tool/live-deployment-tab/log-file-dialog.md). This retrieval succeeds only when the registry's stdout output has been redirected to a file using the [Ice.StdOut](https://docs.zeroc.com/ice/3.8/property-reference/ice-properties.md#ice.stdout) property.
- **Retrieve stderr** Retrieve the IceGrid registry's stderr into a [Log File Dialog](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-gui-tool/live-deployment-tab/log-file-dialog.md). This retrieval succeeds only when the registry's stderr output has been redirected to a file using the [Ice.StdErr](https://docs.zeroc.com/ice/3.8/property-reference/ice-properties.md#ice.stderr) property.
- **Shutdown** Shutdown the registry process.

> **Warning**
>
> You cannot restart an IceGrid registry from IceGrid GUI.

## Properties

The Registry Properties panel shows:

- **Hostname** The name of the host on which the IceGrid registry process is running.
- **Build Id** The build Id of this registry: this corresponds to the Ice property [BuildId](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-and-the-administrative-facility.md).
- **Properties** A table showing all the Ice properties currently set in this registry.
- **Deployed Applications**

![image2017-4-3 14:13:35.png](https://docs.zeroc.com/images/ice/3.8/registry-runtime-component/image2017-4-3-14-13-35.png)

This table shows all the applications deployed on this IceGrid registry, along with the date and time of the last update of each application. A contextual menu allows you to:

- open the corresponding application descriptor
- show additional details on this application in this registry
- remove (undeploy) the application from the registry
- **Dynamic Well-Known Objects**

![dynamic-well-known.png](https://docs.zeroc.com/images/ice/3.8/registry-runtime-component/dynamic-well-known.png)

This table shows the well-known objects registry dynamically with the IceGrid registry: well-known objects defined using adapter and replica-group definitions are not included. A contextual menu allows you to add or remove entries from this table, and to show a given entry in its own dialog.

- **Dynamic Object Adapters**

This table shows the object adapters registered dynamically with the registry. It is typically empty. A registry allows dynamically registered adapters only when its [IceGrid.Registry.DynamicRegistration](https://docs.zeroc.com/ice/3.8/property-reference/icegrid-properties.md#icegrid.registry.dynamicregistration) property is set to a value greater than `0`. A contextual menu allows you to remove entries from this table.

Note that application filtering does not affect this panel: all applications, well-known objects and dynamic object adapters are always displayed.

## Children

A registry node can have the following types of children:

- [Metrics View](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-gui-tool/live-deployment-tab/runtime-components/metrics-view-runtime-component.md)
- [Slave Registry](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-gui-tool/live-deployment-tab/runtime-components/slave-registry-runtime-component.md)
- [Node](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-gui-tool/live-deployment-tab/runtime-components/node-runtime-component.md)
