WINLPCFG.EXE

Use the WINLPCFG utility to configure Fibre Host Bus Adapters (HBAs). The ServerGuide Scripting Toolkit, Windows Edition includes both 32-bit and 64-bit versions of this utility.

You can download this utility from Emulex at http://www.emulex.com. You can also view the Emulex documentation in the sgdeploy\SGTKWinPE\Docs\winlpcfg directory.

Usage

Table 1. WINLPCFG usage
Command Description
winlpcfg.exe help
winlpcfg.exe ?
winlpcfg.exe help command
winlpcfg.exe ? command
Displays help for the winlpcfg.exe command.

To view a list of all available commands, enter: winlpcfg.exe help or winlpcfg.exe ?.

To view the help for a specific command, add the command name. For example:
winlpcfg.exe help download
or
winlpcfg.exe ? download
winlpcfg.exe listwwn
Lists all adapters installed in the system and shows the factory-assigned WWN, the nonvolatile WWPN, and the WWNN used to identify the adapter in the SAN.
winlpcfg.exe listhba
Lists the following information for all installed adapters in the system:
  • Adapter number
  • IEEE address assigned by the manufacturer
  • Firmware version
  • Adapter type
  • Possible mailbox errors
winlpcfg.exe readbootdevice n=adapter_number
Displays the WWN, LUN, and the topology in use for the indicated boot device.
winlpcfg.exe enableboot n=adapter_number i=index
Enables or disables the BootBIOS specified by the index number on the specified adapter.
winlpcfg.exe setbootdevice n=adapter_number w0=
wwpn_word_0 w1=wwpn_word_2 l=lun t=
topology
Sets the boot device to the indicated adapter, WWPN, and topology (select 0 for Arbitrated Loop or 1 for Point to Point).
winlpcfg.exe readaltboot n=adapter_number
Displays the WWN and LUN of all possible alternate boot devices. Up to seven alternate boot devices are supported.
winlpcfg.exe setaltboot i=index w0=wwpn_word_0 w1=
wwpn_word_2 l=lun
Specifies an alternate boot device. You can set up to seven boot devices by specifying indexes from 1 to 7.

Examples

The following examples illustrate winlpcfg.exe utility usage.
Note: While some of these examples are broken across multiple lines, when using WINLPCFG.EXE, you must enter all of the parameters on a single line.
Example Description
winlpcfg.exe help
Displays all available commands.
winlpcfg listwwn
Displays the WWNs of all adapters in the system
winlpcfg listhba
Lists all adapters in the system.
winlpcfg readbootdevice n=1
Displays the WWN, LUN, and topology for adapter number one.
winlpcfg enableboot n=6 i=1
Enables BootBios on adapter number 6.
winlpcfg setbootdevice n=1 w0=a1b2c3d4 w1=b946a4e8
 l=46 t=0
Sets the boot device to adapter number one, LUN 46, with an Arbitrated Loop topology.
winlpcfg readaltboot n=1
Displays the WWN and LUN number of all possible alternate boot devices.
winlpcfg setaltboot n=1 i=1 w0=12345678 w1=a842b6 l=3
Sets the alternate boot device on adapter 1, LUN 3.