[MS_WLBS parameters] (Unattend.txt)

[MS_WLBS parameters]

Answer File = Unattend.txt and Sysprep.inf

The [MS_WLBS parameters] section contains parameters for configuring Network Load Balancing (formerly, Windows Load Balancing Service, or WLBS). Bind Network Load Balancing to multiple network adapters.

By default, the bindings of all networking components (except Network Load Balancing) are enabled. You can selectively disable these by using the Disable entry in the [NetBindings] section. In addition, the Enable entry in the [NetBindings] section allows for explicit binding enabling.

Important

All Network Load Balancing parameters are specific to individual adapters. Any section containing settings specific to an adapter must use the SpecificTo entry to declare the adapter that the parameter is specific to. See the sample for examples.

Valid only for Microsoft® Windows® Server 2003 operating systems.

Entry	Description
AliveMsgPeriod	Specifies in milliseconds a period between sending Network Load Balancing cluster heartbeat messages.
AliveMsgTolerance	Specifies the number of lost heartbeat messages before Setup considers the Network Load Balancing cluster host inactive and initiates convergence.
ClusterIPAddress	Specifies the Network Load Balancing cluster's primary Internet protocol (IP) address.
ClusterModeOnStart	Specifies whether a host joins the Network Load Balancing cluster upon startup or waits for an explicit command to do so.
ClusterName	Specifies a full Internet name for the Network Load Balancing cluster.
ClusterNetworkMask	Specifies the subnet mask for the Network Load Balancing cluster IP address.
DedicatedIPAddress	Specifies the host's unique IP address.
DedicatedNetworkMask	Specifies the subnet mask for the dedicated IP address.
DescriptorsPerAlloc	Specifies the number of connection descriptors created for each allocation.
HostPriority	Specifies the host's unique priority ID in the Network Load Balancing cluster.
IGMPSupport	Specifies whether to use IGMP (Internet Group Management Protocol) support to prevent switch flooding.
MaskSourceMAC	Specifies whether to use source Media Access Control (MAC) address masking, allowing Network Load Balancing cluster hosts to connect to different switch ports.
Master	Specifies whether the host is the master.
MaxDescriptorAllocs	Specifies the maximum number of connection descriptor allocations.
McastIPaddress	Specifies the multicast IP address for sending IGMP join messages when you enable IGMPSupport.
MulticastSupportEnable	Specifies whether to use a multicast MAC address for Network Load Balancing cluster operations.
NetmonAliveMsgs	Specifies whether Network Load Balancing forwards heartbeat messages up to the bound protocols, allowing the Network Monitor utility to capture heartbeats.
NumActions	Specifies the number of actions created for each allocation.
NumAliveMsgs	Specifies the number of heartbeat packet buffers created for each allocation.
NumPackets	Specifies the number of packets created for each allocation.
PersistedStates	Specifies whether a host that is shut down while in a suspended state will remain suspended when Windows is started.
Ports	Specifies rules for distributing traffic among Network Load Balancing cluster hosts according to protocol and destination ports.
RemoteControlEnabled	Specifies whether to enable remote-control operations.
RemoteControlPassword	Specifies a password for restricting access to the Network Load Balancing cluster from remote, networked computers running Windows and using the Wlbs.exe control program.
RemoteControlUDPPort	Specifies the remote control UDP (User Datagram Protocol) port.
ReverseHash	Specifies whether the adapter should reverse the source and destination IP addresses and ports before making load balancing decisions.
TeamID	Specifies a valid GUID that identifies a BDA (bidirectional affinity) team.

Sample

This sample demonstrates the [MS_WLBS parameters] section in the context of a complete [Networking] section that defines two adapters using static IP addresses and Network Load Balancing.

[Networking]

[Identification]
DomainAdmin = domain\user
DomainAdminPassword = password
JoinDomain = domain

;We'll have two network adapters - Adapter01 and Adapter02.
;Note: The adapter specified here as No.1 may not be
;LAN connection No.1 in the user interface.
[NetAdapters]
Adapter01 = params.Adapter01
Adapter02 = params.Adapter02

;Specify the network card used by network adapter No. 1.
[params.Adapter01]
ConnectionName = "Intel Adapter"
Netcardaddress = 0x0002A5D0510f

;Specify the network card used by network adapter No. 2.
[params.Adapter02]
ConnectionName = "3Com Adapter"
Netcardaddress = 0x000476D5F57D

;Install client for MS networks.
[NetClients]
MS_MSClient = params.MS_MSClient

[params.MS_MSClient]

;Only install TCP.
[NetProtocols]
MS_TCPIP = params.MS_TCPIP

[params.MS_TCPIP]
;TCP/IP properties
AdapterSections = params.MS_TCPIP.Adapter01,params.MS_TCPIP.Adapter02

;Card 1 using static IP address info
[params.MS_TCPIP.Adapter01]
DHCP = No
DNSServerSearchOrder = 157.5.2.2,157.5.23.13
IPAddress = 172.24.23.91
SpecificTo = Adapter01
SubnetMask = 255.255.255.0
WINS = Yes
WINSServerList = 157.5.2.22,157.5.7.5

;Card 2 using static info
[params.MS_TCPIP.Adapter02]
DefaultGateway = 157.5.4.1
DHCP = No
DNSServerSearchOrder = 157.5.2.2,157.5.23.13
IPAddress = 157.5.4.5
SpecificTo = Adapter02
SubnetMask = 255.255.252.0
WINS = Yes
WINSServerList = 157.5.2.22,157.5.7.5

[params.MS_WLBS]
AdapterSections = params.MS_WLBS.Adapter01,params.MS_WLBS.Adapter02

[params.MS_WLBS.Adapter01]
ClusterIpAddress = 157.5.4.15
ClusterModeOnStart = 1
ClusterName = nlbcluster.domain.com
ClusterNetworkMask = 255.255.252.0
DedicatedIPAddress = 172.24.23.91
DedicatedNetworkMask = 255.255.255.0
HostPriority = 1
IGMPSupport = 0
MulticastSupportEnable = 1
Ports = 1,65535,Both,Multiple,Single,Equal
RemoteControlEnabled = 1
SpecificTo = Adapter01

[params.MS_WLBS.Adapter02]
ClusterIpAddress = 157.5.4.15
ClusterModeOnStart = 1
ClusterName = nlbcluster.domain.com
ClusterNetworkMask = 255.255.252.0
DedicatedIPAddress = 157.5.4.5
DedicatedNetworkMask = 255.255.252.0
HostPriority = 1
IGMPSupport = 0
MulticastSupportEnable = 1
Ports = 1,65535,Both,Multiple,Single,Equal
RemoteControlEnabled = 1
SpecificTo = Adapter02

[NetBindings]
Disable = MS_WLBS,Adapter01
Enable = MS_WLBS,Adapter02

AliveMsgPeriod

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

Syntax	AliveMsgPeriod = integer_between_100_and_10,000
Value	integer_between_100_and_10,000
Default Value	1000
Example	AliveMsgPeriod = 5000

Syntax	AliveMsgTolerance = integer_between_5_and_100
Value	integer_between_5_and_100
Default Value	5
Example	AliveMsgTolerance = 50

Syntax	ClusterIPAddress = IP_address
Value	IP_address
Default Value	0.0.0.0
Example	ClusterIPAddress = 10.192.45.7
Comments	Required. This address is a virtual IP address and it must be set identically for all hosts in the Network Load Balancing cluster. If you use one alias for several IP addresses to the Network Load Balancing cluster, then you must specify only the primary (main) IP address.

Syntax	ClusterModeOnStart = 0 \| 1
Values	0 Host does not join the Network Load Balancing cluster upon startup, but instead waits for an explicit command. 1 Host joins the Network Load Balancing cluster upon startup.
Default Value	1
Example	ClusterModeOnStart = 0

Syntax	ClusterName = fully_qualified_domain_name_of_the_cluster
Values	fully_qualified_domain_name_of_the_cluster
Default Value	cluster.domain.com
Example	ClusterName = nlbcluster.domain.com

Syntax	ClusterNetworkMask = network_mask
Value	network_mask
Default Value	0.0.0.0
Example	ClusterNetworkMask = 255.255.255.0
Comment	Required.

Syntax	DedicatedIPAddress = IP_address
Value	IP_address
Default Value	0.0.0.0
Example	DedicatedIPAddress = 10.192.45.1
Comment	Required.

Syntax	DedicatedNetworkMask = network_mask
Value	network_mask
Default Value	0.0.0.0
Example	DedicatedNetworkMask = 255.255.255.0
Comment	Required.

Syntax	DescriptorsPerAlloc = integer_between_16_and_1024
Value	integer_between_16_and_1024
Default Value	512
Example	DescriptorsPerAlloc = 1024
Comments	Change this value only when an event log message instructs you to do so.

Syntax	HostPriority = integer_between_1_and_32
Value	integer_between_1_and_32
Default Value	1
Example	HostPriority = 5
Comment	Required.

Syntax	IGMPSupport = 0 \| 1
Values	0 Do not use IGMP for Network Load Balancing cluster operations. 1 Use IGMP for Network Load Balancing cluster operations.
Default Value	0
Example	IGMPSupport = 0
Comments	Important Requires MulticastSupportEnable = 1.

Syntax	Mode entry for Multiple: Ports = None \| Single \| ClassC, Equal \| integer_from_1_to_100 Mode entry for Single: Ports = integer_from_1_to_32 Mode entry for Disabled: Ports = None
Values	integer_from_1_to_65535,integer_from_1_to_65535, Both \| TCP \| UDP,Multiple \| Single \| Disabled, mode entry,[...]
Default Value	1, 65535, Both, Multiple, Single, Equal
Example	Ports = 20,21,TCP,Multiple,Single,Equal,80,80,Both,Multiple, None,Equal, 443,443,Both,Multiple,Single,Equal,1024,65535,TCP, Multiple,Single,Equal Ports = ALL,20,21,TCP,Multiple,Single,Equal,80,80,Both,Multiple, None,Equal, 443,443,Both,Multiple,Single,Equal,1024,65535,TCP, Multiple,Single,Equal Ports = 172.31.80.178,20,21,TCP,Multiple,Single,Equal,80,80,Both,Multiple, None,Equal, 443,443,Both,Multiple,Single,Equal,1024,65535,TCP, Multiple,Single,Equal

Syntax	TeamID = {GUID}
Value	{GUID}
Example	TeamID = {BF967924-0DE6-11D0-A285-00AA003049E2}

Syntax	MaskSourceMAC = 0 \| 1
Values	0 Does not use source MAC address masking. The Network Load Balancing cluster connects to a hub to re-enable learning in the upstream switch and conserve its bandwidth. 1 Uses source MAC address masking.
Default Value	1
Example	MaskSourceMAC = 0

Syntax	MaxDescriptorAllocs = integer_between_1_and_1024
Values	integer_between_1_and_1024
Default Value	512
Example	MaxDescriptorAllocs = 1024
Comments	Change this value only when an event log message instructs you to do so.

Syntax	McastIPaddress = IP_address
Value	IP_address
Example	McastIPaddress = 239.255.1.1
Comments	The Primary Cluster IP automatically generates the default address.

Syntax	MulticastSupportEnable = 0 \| 1
Values	0 Does not use multicast MAC addresses for Network Load Balancing cluster operations. 1 Uses multicast MAC addresses for Network Load Balancing cluster operations.
Default Value	0
Example	MulticastSupportEnable = 1

Syntax	NetmonAliveMsgs = 0 \| 1
Values	0 Does not forward heartbeat messages to bound protocols. 1 Forwards heartbeat messages to bound protocols.
Default Value	0
Example	NetmonAliveMsgs = 0

Syntax	NumActions = integer_between_5_and_500
Value	integer_between_5_and_500
Default Value	50
Example	NumActions = 100
Comments	Change this value only when an event log message instructs you to do so.

Syntax	NumAliveMsgs = integer_between_66_and_660
Value	integer_between_66_and_660
Default Value	66
Example	NumAliveMsgs = 100
Comments	Change this value only when an event log message instructs you to do so.

Syntax	NumPackets = integer_between_5_and_500
Value	integer_between_5_and_500
Default Value	100
Example	NumPackets = 100
Comments	Change this value only when an event log message instructs you to do so.

Syntax	RemoteControlEnabled = 0 \| 1
Values	0 Does not enable remote-control operations. 1 Enables remote-control operations.
Default Value	0
Example	RemoteControlEnabled = 1
Comments	Important For security reasons, it is recommended that you place the Network Load Balancing UDP control port behind a firewall.

Syntax	RemoteControlPassword = password
Value	password
Default Value	NULL
Example	RemoteControlPassword = B1gCluster

Syntax	RemoteControlUDPPort = integer_between_1_and_65535
Value	integer_between_1_and_65535
Default Value	2505
Example	RemoteControlUDPPort = 1717