Node Descriptor Element

A node element defines an IceGrid node. The servers that the node is responsible for managing are described in child elements.

This element may only appear as a child of an application element. Multiple node elements having the same name may appear in an application. Their contents are merged and the last definition of load-factor has precedence.

The following attributes are supported:

Attribute

Description

Required

load-factor

A floating point value defining the factor that is multiplied with the node's load average. The load average is used by the adaptive load balancing policy to figure out which node is the least loaded. The default is 1.0 on Unix platforms and 1/NCPUS on Windows (where NCPUS is the number of CPUs in the node's computer). Note that, if Unix and Windows machines are part of a replica group, the Unix and Windows figures are not directly comparable, but the registry still makes an attempt to pick the least-loaded node.

No

name

The name must be unique among all nodes in the registry. Within the node, child elements can refer to its name using the reserved variable ${node}. An icegridnode process representing this node must be started on the desired computer and its configuration property IceGrid.Node.Name must match this attribute.

Yes

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

XML
<node name="Node1" load-factor="2.0">
    <description>A description of this node.</description>
    <server id="Server1" ...>
        <property name="NodeName" value="${node}"/>
        ...
    </server>
</node>
See Also