---
title: "Node Runtime Component"
url: https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-gui-tool/live-deployment-tab/runtime-components/node-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).

# Node Runtime Component

A node represents an IceGrid node process registered with the IceGrid registry.

## States

A node can be either up ![node up](https://docs.zeroc.com/images/ice/3.8/node-runtime-component/node-up.jpeg) or down ![node down](https://docs.zeroc.com/images/ice/3.8/node-runtime-component/node-down.jpeg). A "down" node is shown only when it is described by an application deployed on this IceGrid registry.

## Actions

A node provides the following actions, from its contextual menu and from the `Tools > Node` menu:

- **Retrieve Ice log** Retrieve the log messages sent to the IceGrid node'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 node's logger.
- **Retrieve stdout** Retrieve the IceGrid node'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 node'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 node'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 node'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.
- **Start All Servers** Start each server of this node that is inactive, enabled, and not configured with `session` activation, including servers hidden by the [Filter live deployment](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-gui-tool/live-deployment-tab/application-component.md) action.
- **Stop All Servers** Stop each server of this node that is not inactive, including servers hidden by the Filter live deployment action.
- **Shutdown** Shutdown the IceGrid node process.

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

## Properties

![image2017-4-3 14:17:0.png](https://docs.zeroc.com/images/ice/3.8/node-runtime-component/image2017-4-3-14-17-0.png)

The Node Properties panel shows:

- **Hostname** The name of the host on which the IceGrid node process is running.
- **Operating System** The operating system name and version of the host on which the IceGrid node process is running.
- **Machine Type** The type of CPUs and the number of CPU threads of the host on which the IceGrid node process is running. For example, a computer with a dual-core CPU and 2 "hyper threads" per core will show 4 CPU threads.
- **CPU Usage (Windows) or Load Average (Linux and macOS)** On Windows, shows the percentage of CPU utilization in the past 1, 5, and 15 minutes. On Linux and macOS, shows the load-average in the past 1, 5 and 15 minutes. These values are retrieved when the Node Properties panel is displayed. Click on the Refresh button to retrieve the latest values.
- **Build Id** The build Id of this node: 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 IceGrid node.
- **Load Factor** Shows the load factor defined by each application using this node.

## Children

An IceGrid node can only 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)
- [Regular Server](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-gui-tool/live-deployment-tab/runtime-components/server-runtime-component.md)
- [IceBox Server](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-gui-tool/live-deployment-tab/runtime-components/server-runtime-component.md)
