Navigation:  Application > Descriptors > Server >

Plain Server

Print this Topic Previous pageReturn to chapter overviewNext page

Properties

The Server Properties panel offers the following fields:

Server ID

The ID of the server; corresponds to the Ice.ServerID property.  Each server must have a unique ID within an IceGrid deployment.

Description

A free-text description of this server.

Property Sets

List of property-set IDs; you refer to a property set to "include" all its properties in the server.

Properties

Ice properties private to this server.

Log Files

This table can be used to declare a number of log files used by this server. Path is the path to the log file (a relative path is relative to the IceGrid node working directory); when Property is set, IceGrid generates a property with this name and the log file path as value.

You declare log files to be able to conveniently retrieve them using IceGrid Admin (in the Live Deployment tab) or with the icegridadmin command-line utility.

Path to Executable

Path to the server's executable; cannot be blank. A relative path is relative to the IceGrid node working directory.

Ice Version

The Ice version of this server. If you don't provide a value, IceGrid assumes it's the same version as the IceGrid registry.

Working Directory

The working directory for the server when started by the IceGrid node.

Command Arguments

The command-line arguments given to the server when started by the IceGrid node.

Run as

On Linux and Unix, when IceGrid node is running as root, it is possible to run the server under any username. Enter the desired username in this field.

When not set (the default), the server runs as the same user as the IceGrid node, except when IceGrid node runs as root. In this case, the server runs as nobody.

Environment Variables

The environment variables for the server when started by the IceGrid node. These variables are in addition to  variables defined in the IceGrid node own environment.

Activation Mode

The server's activation mode. Must be one of:

always: IceGrid node keeps this server running all the time
manual: this server is started "manually", using IceGrid Admin or the icegridadmin command-line utility
on-demand: IceGrid starts this server when it resolves the object-adapter ID of an object adapter defined in this server
session: IceGrid starts a separate instance of this server for each IceGrid session that allocates this server
a variable or combination of variables that resolves to one of the values above

Activation Timeout

When activating a server, IceGrid gives timeout seconds to object adapters with server lifetime to register their endpoints with the IceGrid registry. During this time, lookup for the corresponding adapter IDs are delayed.

If not set or set to 0, the IceGrid node uses the value of its IceGrid.Node.WaitTime property.

Deactivation Timeout

When deactivating a server, IceGrid gives timeout seconds to the server to exit gracefully. After this timeout, the server process is killed.

If not set or set to 0, the IceGrid node uses the value of its IceGrid.Node.WaitTime property.

Allocatable

Specifies whether the server can be allocated. A server is allocated implicitly when one of its allocatable objects is allocated. This checkbox is ignored if the server activation mode is session; a server with this activation mode is always allocatable. Default: false.

Depends on the application distribution

A server that depends on the application distribution is stopped and disabled before any application distribution update, and re-enabled after such update. Default: true.

IcePatch2 Proxy

A stringified (or well-known) proxy for the IcePatch2 server than contains this server's private distribution. Possible values:

"None selected" (default) or blank: no private distribution defined
${application}.IcePatch2/server: corresponds to the well-known proxy of an IcePatch2 server deployed in this application using the IcePatch2 default server-template (with a default instance-name parameter value).
Your own value

Directories

List of directories included in the server distribution. When blank, the entire IcePatch2 server repository is used as the distribution.

Children

A plain server can have two types of children:

Adapter
Database Environment

 


Page url: http://www.zeroc.com/doc/Ice-3.4.2/IceGridAdmin/index.html?app_plain_server.htm