3.8 Using the SetAddr Utility

This topic is applicable only for endpoints used with NetIQ AppManager.

Endpoints for Windows operating systems ship with a utility that helps you quickly create virtual IP addresses on Windows endpoint computers. Virtual addresses are useful when you are testing hundreds or even thousands of endpoint pairs using only a few computers as endpoints. To all intents and purposes, the traffic on the network is identical, whether you are using “real” or virtual addresses.

When you install a Windows endpoint, Setaddr.exe for 32-bit Windows is automatically installed in the same directory. For 64-bit Windows, a 64-bit version of Setaddr.exe is installed. The two versions of SetAddr cannot be used across operating systems with different architectures.

The usage is as follows:

setaddr [-dr] -a N -f Addr -t Addr -i Addr -s Addr 
| -l[a] 
| -da 
| -ds -f Addr -s Addr  

where “N” indicates the adapter number of the NIC card you are assigning virtual addresses to, and “Addr” indicates the virtual addresses or subnet mask you are assigning to it.

Options:

-l     List all network adapters
-la    List all network adapters and their IP addresses
-a     Adapter to modify (number given by -l options)
-dr    Delete a range of addresses
-da    Delete all addresses
-ds    Delete a single address
-f     From address
-t     To address
-i     Increment by
-s     Subnet Mask

The -d flags cannot be used to delete a computer’s primary IP address.

The -i flag lets you determine how the range of addresses will be created. This is an optional field. By default, SetAddr increments the range by one in the final byte only. This “increment by” value is represented as “0.0.0.1”. Enter a value (0-255) for each byte of the 4-byte IP address. A value of 1 specifies that the address values in that byte will be incremented by one when SetAddr creates the range. For example, enter

setaddr -f 10.40.1.1 -t 10.40.4.250 -i 0.0.1.1 -s 255.255.0.0

SetAddr creates 1000 virtual addresses.

Known Limitations:

  • IPv4 only.

  • SetAddr only works on computers with fixed IP addresses. DHCP-enabled adapters cannot be used.

  • Before testing, restart the computer that has the NIC to which you assigned virtual IP addresses. SetAddr modifies some Windows Registry keys, and restarting is required for the changes to take effect.

  • The number of virtual addresses you can assign to a single adapter depends on the protocol stack and the size of the Windows Registry. NetIQ benchmarked measurements using computers running up to 2500 virtual addresses, which is a recommended limit.

  • No checking is done to ensure that thousands of addresses are not being created. More TCP/IP stack resources are required to manage virtual addresses.

  • You may only add Class A, B, and C virtual IP addresses. Loopback addresses and Class D and E IP addresses are invalid. Valid address ranges, then, are 1.x.x.x to 233.x.x.x, excluding 127.x.x.x.

  • When more than 2250 virtual address are defined on Windows 2000 computers, all the LAN adaptor icons disappear from the Network and Dial-up Connections dialog box in My Network Places. You can still see the adaptors by invoking ipconfig or setaddr from the command line, and the addresses are still reachable. Removing some virtual addresses so that fewer than 2250 were specified and restarting the computer solved the problem.