KB - Collapsing Licenses on a Multihomed Windows System
BBj and Visual PRO/5 (VPRO/5) clients are designed to consume only one license (or ‘collapse’) when they are launched together on the same Windows desktop. However, due to slightly different mechanisms used by BBj and VPRO/5 to check the host IP address, it is possible for BBj to acquire a different IP address than VPRO/5 and thus consume an additional license.
Using the steps and tools below, add a hosts file entry to force BBj to use the same IP address as that acquired by VPRO/5.
With VPRO/5 and BBj clients running on the same desktop, use the lmutil utility to determine which IP addresses the VPRO/5 and BBj clients are using.
At the DOS prompt, change directories to the BASIS License Manager directory and type the following: lmutil.exe lmstat -a
The lmutil output will show which features are checked out and user/host/display information about the clients that performed the license checkouts.
In Figure 1, notice that user ‘Administrator’ has two licenses checked out from two different IP addresses: 10.0.0.247 and 10.0.1.173. In this case, the VPRO/5 11.0 client can be distinguished from the BBj 13.0 client by the version information listed in the output:
Administrator 10.0.0.247 0a0000f72 (v11.0)
Administrator 10.0.1.173 0a0000f72 (v13.0)
If your BBj and VPRO/5 clients happen to be at the same revision, the following program may be run in the BBj client to confirm the IP Address the BBj client is using:
0010 use java.net.InetAddress
0020 A$ = InetAddress.getLocalHost().toString()
0030 print A$
Figure 1. Sample lmutil.exe lmstat -a output on Windows
Add an entry to the system’s hosts file to point the systems hostname to the IP address the VPRO/5 client is using. In the example above, the VPRO/5 client was using 10.0.0.247, while the BBj client was using 10.0.1.173
The resolution in this sample case will be to add an entry to the hosts file like this (‘dino’ is the hostname of the server):
The location of the hosts file on Windows is: %SystemRoot%\system32\drivers\etc\hosts