Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin
Znav
nextIceGrid Descriptor Element
prevDistrib Descriptor Element

An icebox element defines an IceBox server to be deployed on a node. It typically contains at least one service element, and may supply additional information such as command-line options, environment variables, configuration properties and a server distribution.

The IceBox service manager's object adapter, IceBox.ServiceManager,  can only be configured as a direct object adapter, using properties. This object adapter is enabled only if the property IceBox.ServiceManager.Endpoints is set. Note however that the service manager's functionality remains available as an administrative facet even when its object adapter is disabled.

This element may only appear as a child of a node element or a server-template element.

This element supports the same attributes as the server element.

The IceGrid node on which this server is deployed generates the following configuration property for the server:

Wiki Markup
{zcode}
IceBox.InstanceName=${server}
{zcode}

An optional nested description element provides free-form descriptive text.

Here is an example to demonstrate the use of this element:

Wiki Markup
{zcode:xml}
<icebox id="MyIceBox"
        activation="on-demand"
        activation-timeout="60"
        application-distrib="false"
        deactivation-timeout="60"
        exe="/opt/Ice/bin/icebox"
        pwd="/">
    <option>--Ice.Trace.Network=1</option>
    <env>PATH=/opt/Ice/bin:$PATH</env>
    <property name="IceBox.UseSharedCommunicator.Service1" value="1"/>
    <service name="Service1" .../>
    <service-instance template="ServiceTemplate" name="Service2"/>
</icebox>
{zcode}
Ztop
See Also
Zret
Znav
nextIceGrid Descriptor Element
prevDistrib Descriptor Element