server element defines a server to be deployed on a node. It typically contains at least one
adapter element, and may supply additional information such as command-line options, environment variables, configuration properties, and a server distribution.
The following attributes are supported:
Specifies whether the server's activation mode. Legal values are
Defines the number of seconds a node will wait for the server to activate. If the timeout expires, a client waiting to receive the endpoints of an object adapter in this server will receive an empty set of endpoints. If not defined, the default timeout is the value of the
Specifies whether the server can be allocated. A server is allocated implicitly when one of its allocatable objects is allocated. The value of this attribute is ignored if the server activation mode is
Specifies whether this server's distribution is dependent on the application's distribution. If the value is
Defines the number of seconds a node will wait for the server to deactivate. If the timeout expires, the node terminates the server process. If not defined, the default timeout is the value of the node's configuration property
The pathname of the server executable. On Windows, if a relative path is specified, the executable is searched in the system path. On Linux, it's searched in the user path specified by the PATH environment variable from the environment where the
Specifies the Ice version in use by this server. If not defined, IceGrid assumes the server uses the same version that IceGrid itself uses. A server that uses an Ice version prior to 3.3 must define this attribute if its adapters use the
Specifies the identifier for this server. The identifier must be unique among all servers in the registry. Within the server, child elements can refer to its identifier using the reserved variable
The default working directory for the server. If not defined, the server is started in the node's current working directory.
Specifies the name of the user account under which the server is activated and run. If a user account mapper is configured for the node, the value of this attribute is used to find the corresponding account in the map.
Node running on Windows as any user, or Linux and macOS as non-root:
Node running on Linux and macOS as root:
An optional nested
description element provides free-form descriptive text.
Here is an example to demonstrate the use of this element:
- Adapter Descriptor Element
- Properties Descriptor Element
- Node Descriptor Element
- Server-Template Descriptor Element
- Description Descriptor Element
- Using Command Line Options in Descriptors
- Setting Environment Variables in Descriptors
- Application Distribution
- IceGrid Server Activation
- Using Descriptor Variables and Parameters