Cluster

Cluster contains the settings to specify details about a cluster, such as its interface, IP address, portrules, and so on.

Note

To enable this Network Load Balancing setting, the NetworkLoadBalancingFullServer package must be enabled in the Windows image you are installing. To do this, use Windows System Image Manager to add the Microsoft-Windows-Foundation-Package to your answer file, and then configure the NetworkLoadBalancingFullServer package to enable it. For more information about adding and configuring packages, see the OEM Preinstallation Kit User's Guide or the Windows Automated Installation Kit User's Guide.

Child Elements

Interface

Specifies the interface name to bind to network load balancing (NLB). This is a required setting.

ClusterIpAddress

Specifies the cluster primary IP address.

ClusterNetMask

Specifies the subnet mask for the cluster IP address.

VirtualIpAddresses

Specifies the cluster’s virtual IP addresses.

Portrules

Specifies details about the port rules that are used for the cluster, including a port rule's name, virtual IP address, protocol, mode, and so on.

DedicatedIpAddresses

Specifies the host's unique IP addresses.

HostIdentifier

Specifies the host identifier used by this cluster.

ClusterMacAddress

Specifies the cluster MAC address to be used when configuring a unicast cluster.

ClusterName

Specifies a full Internet name for the cluster.

ClusterMode

Specifies the mode for the cluster.

InitialHostState

Specifies the initial host state for the cluster.

PersistSuspendedState

Specifies whether a host that is shut down while in a suspended state will remain suspended when Windows is started.

MembershipHeartbeatPeriod

Specifies a period between sending Network Load Balancing cluster heartbeat messages.

MembershipHeartbeatLossTolerance

Specifies the number of lost heartbeat messages before Setup considers the Network Load Balancing cluster host inactive and initiates convergence.

IdentityHeartbeatPeriod

Specifies the recurrence interval for transmitting identity heartbeats between the NetworkLoadBalancing cluster hosts.

MulticastSpoofEnabled

Specifies whether or not address resolution protocol (ARP) traffic should be spoofed.

MaskSourceMacEnabled

Specifies whether source Media Access Control (MAC) address masking is used.

ICMPFilteringEnabled

Specifies whether Internet Control Message Protocol (ICMP) filtering is enabled for the cluster.

NetBTSupportEnabled

Specifies whether NetBT support is enabled for the cluster.

ClusterIpToClusterMacEnabled

Specifies whether the cluster MAC address is automatically calculated from the primary cluster IP address.

UnicastInterHostCommunicationSupportEnabled

Specifies whether Unicast, interhost communication support is enabled for the cluster.

MaximumConnectionDescriptors

Specifies the maximum number of descriptors per allocation for the cluster.

BDATeam

Specifies details about a bidirectional affinity (BDA) team.

Valid Passes

specialize

Parent Hierarchy

Microsoft-Windows-NetworkLoadBalancing-Core | Clusters | Cluster

Applies To

For the list of the supported Windows editions and architectures that this component supports, see Microsoft-Windows-NetworkLoadBalancing-Core.

XML Example

<Cluster>
   <Interface>Local Area Connection 2</Interface>
   <ClusterIpAddress>10.100.0.234</ClusterIpAddress>
   <ClusterNetMask>255.255.255.0</ClusterNetMask>
   <VirtualIpAddresses>
      <IpAddress wcm:keyValue="Ip1">
         <IpAddress>10.192.45.1</IpAddress>
         <NetworkMask>255.255.255.0</NetworkMask>
      </IpAddress>
      <IpAddress wcm:keyValue="Ip2">
         <IpAddress>fe80::204:23ff:feb9:1111</IpAddress>
      </IpAddress>
   </VirtualIpAddresses>
   <Portrules>
      <Portrule wcm:keyValue="Portrule1">
         <VirtualIpAddress>255.255.255.255</VirtualIpAddress>
         <Protocol>TCP</Protocol>
         <StartPort>0</StartPort>
         <EndPort>65535</EndPort>
         <Mode>MultipleHost</Mode>
         <EqualLoad>true</EqualLoad>
         <ClientAffinity>None</ClientAffinity>
      </Portrule>
      <Portrule wcm:keyValue="Portrule2">
         <VirtualIpAddress>10.100.0.223</VirtualIpAddress>
         <Protocol>Both</Protocol>
         <StartPort>80</StartPort>
         <EndPort>80</EndPort>
         <Mode>MultipleHost</Mode>
         <LoadWeight>100</LoadWeight>
         <ClientAffinity>Single</ClientAffinity>
      </Portrule>
      <Portrule wcm:keyValue="Portrule3">
         <VirtualIpAddress>10.100.0.99</VirtualIpAddress>
         <Protocol>TCP</Protocol>
         <StartPort>23</StartPort>
         <EndPort>23</EndPort>
         <Mode>Disabled</Mode>
      </Portrule>
      <Portrule wcm:keyValue="Portrule4">
         <VirtualIpAddress>255.255.255.255</VirtualIpAddress>
         <Protocol>UDP</Protocol>
         <StartPort>25</StartPort>
         <EndPort>25</EndPort>
         <Mode>MultipleHost</Mode>
         <EqualLoad>true</EqualLoad>
         <ClientAffinity>Network</ClientAffinity>
      </Portrule>
      <Portrule wcm:keyValue="Portrule5">
         <VirtualIpAddress>10.100.0.223</VirtualIpAddress>
         <Protocol>TCP</Protocol>
         <StartPort>3389</StartPort>
         <EndPort>3389</EndPort>
         <Mode>SingleHost</Mode>
         <HostPriority>1</HostPriority>
      </Portrule>
   </Portrules>
   <DedicatedIpAddresses>
      <IpAddress wcm:keyValue="Ip1">
         <IpAddress>10.192.45.1</IpAddress>
         <NetworkMask>255.255.255.0</NetworkMask>
      </IpAddress>
      <IpAddress wcm:keyValue="Ip2">
         <IpAddress>fe80::204:23ff:feb9:1111</IpAddress>
      </IpAddress>
   </DedicatedIpAddresses>
   <HostIdentifier>6</HostIdentifier>
   <ClusterMacAddress>02-bf-01-02-03-04</ClusterMacAddress>
   <ClusterName>mycluster.domain.com</ClusterName>
   <ClusterMode>Multicast</ClusterMode>
   <InitialHostState>Started</InitialHostState>
   <PersistSuspendedState>false</PersistSuspendedState>
   <MembershipHeartbeatPeriod>1000</MembershipHeartbeatPeriod>
   <MembershipHeartbeatLossTolerance>5</MembershipHeartbeatLossTolerance>
   <IdentityHeartbeatPeriod>2000</IdentityHeartbeatPeriod>
   <MulticastSpoofEnabled>false</MulticastSpoofEnabled>
   <MaskSourceMacEnabled>true</MaskSourceMacEnabled>
   <ICMPFilteringEnabled>false</ICMPFilteringEnabled>
   <NetBTSupportEnabled>true</NetBTSupportEnabled>
   <ClusterIpToClusterMacEnabled>true</ClusterIpToClusterMacEnabled>
   <UnicastInterHostCommunicationSupportEnabled>true</UnicastInterHostCommunicationSupportEnabled>
   <MaximumConnectionDescriptors>512</MaximumConnectionDescriptors>
   <BDATeam>
      <Team>{BF967924-0DE6-11D0-A285-00AA003049E2}</Team>
      <Master>true</Master>
      <ReverseHash>true</ReverseHash>
   </BDATeam>
</Cluster>