This page describes how to launch the IceGrid Admin tool.

On this page:

System Requirements

IceGrid Admin is a JavaTM application supported on a wide range of platforms, including Windows, Linux and OS X.

The minimum requirements for running IceGrid Admin are listed below:

In order to use IceGrid Admin's metrics graphs feature, you will need the following:

You can download Java SE 7 for most platforms from Oracle.

If you want to read IceGrid XML files from IceGrid Admin, you also need to have the icegridadmin command-line utility (version 3.5) in your PATH.

Starting IceGrid Admin

On Windows IceGrid Admin can be started by clicking the IceGrid Admin icon in the Start menu:


On OS X IceGrid Admin can be started by clicking the IceGrid Admin icon in Finder Applications folder:

On Linux with a RPM installation, you can use the icegridgui script installed in /usr/bin:

$ icegridgui

On all platforms, you can also start IceGrid Admin from a terminal by typing:

java -jar path-to-IceGridGUI.jar

Command Line Arguments

IceGrid Admin can be configured using Ice properties, and like with most Ice applications, these properties can be set using command-line arguments or a configuration file (or both).

Since IceGrid Admin is an Ice application (a client to the IceGrid registry), setting regular Ice properties can be useful as well. For example, you can set the Ice.Trace.Network property to get detailed information about network communications sent to stderr.

$ icegridgui --Ice.Trace.Network=2

There are also a number of properties specific to IceGrid Admin itself, describe in IceGrid Administrative Client Properties.

If you need to set many properties, it is a good idea to write a configuration file and use the --Ice.Config command-line argument to specify the location of this file. For example:

> java -jar "C:\Program Files (x86)\ZeroC\Ice-3.5.1\bin\IceGridGUI.jar" --Ice.Config=icegridadmin.conf

Main IceGrid Admin Window

The main IceGrid Admin window allows to navigate between your live deployment and the definitions of several applications.


 The main IceGrid Admin window shows one or more tabs:

IceGrid Admin may show any number of application tabs, including none at all.

Status Bar

 The status bar at the bottom of the main window shows information about operations performed by IceGrid Admin, or messages received from the IceGrid registry.

See Also