Page History

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:

{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:

{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}

See Also

• IceBox
• Service Descriptor Element
• Adapter Descriptor Element
• Properties Descriptor Element
• Node Descriptor Element
• Server-Template Descriptor Element
• Server Descriptor Element
• Description Descriptor Element
• Using Command Line Options in Descriptors
• Setting Environment Variables in Descriptors
• Application Distribution
• Administrative Facility