iSCSIUtl is a DOS utility for programming the Intel® iSCSI Boot firmware on iSCSI boot-capable adapters.
![]() |
NOTE: Updating the adapter's flash ROM using iSCSIUtl will erase any existing Intel Boot Agent image from the flash ROM. |
iSCSIUtl without command line parameters will display a list of all iSCSI boot-capable adapters in the system. In order to maintain versions of the firmware, Intel iSCSI Boot requires all adapters in the system to have the same version of the firmware.
iSCSIUtl is located on the software installation CD in the \APPS\iSCSI\iSCSIUtl
directory. Always check the Intel Customer Support (http://support.intel.com) website for the latest Intel iSCSI Boot information and component updates. Enter "iSCSI
Boot" in the search field.
For more information on iSCSIUtl see the document iscsiutl.txt located in the \APPS\iSCSI\iSCSIUtl
directory of the software installation CD.
The syntax for issuing iSCSIUtl command line parameters in DOS is:
ISCSIUTL [-option]...
![]() |
NOTES:
|
iSCSIUtl accepts up to 16 simultaneous parameters. If conflicting parameters (such as -FLASHENABLE -FLASHDISABLE
used together) are supplied, iSCSIUtl exits with an error.
The parameters, where applicable, are listed in logical groups. Note that -HELP
, -EXITCODES
and -IMAGEVERSION
have special overriding characteristics. Unless noted, all other parameters may be used in conjunction with any other parameter.
![]() |
NOTE:
If you enter ISCSIUTL without any command line options, the utility displays a list of all the adapters found in your system.
|
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
Save/Restore Options | |
---|---|
Parameter | Description |
-SAVE |
Saves iSCSI Boot settings in the EEPROM to a disk
file on the selected iSCSI-capable port. Need to specify a file name by -FILE
parameter. WARNING: For security reasons it is recommended that CHAP settings are disabled when using save/restore. |
-RESTORE |
Restores previously saved iSCSI Boot settings on the selected iSCSI-capable port. Need -FILE parameter to specify the saved data. |
-FILE |
Specifies a file name for -SAVE or -RESTORE parameters by –FILE = [filename]. |
All other parameters will generate an error.
The following examples show how to enter some typical iSCSIUtl command lines:
To update the Intel iSCSI Boot image on all Intel adapters, enter:
ISCSIUTL -ALL -UP
If iSCSIUtl finds any adapter with a pre-installed Intel Boot Agent image, you will be prompted whether you want to erase the image and replace it with Intel iSCSI Boot. Type
Y
(yes) to erase the pre-installed image and install Intel iSCSI Boot.
To Enable the Boot ROM on the first Intel adapter found in your system, enter:
ISCSIUTL -NIC=1 -FLASHENABLE
To disable the flash ROM on all Intel adapters, enter:
ISCSIUTL -ALL -FD
To enable WOL on the second Intel adapter found in your system, enter:
ISCSIUTL -NIC=2 -WOLENABLE
To get help, enter:
ISCSIUTL -?
iSCSIUtl returns exit codes to the DOS environment. Possible exit codes are listed below:
Code Name | Value |
---|---|
All iSCSIUtl operations completed successfully | 0 |
Bad command line parameter | 1 |
No supported PCI network adapters detected | 2 |
Invalid adapter selected | 3 |
FLASH operation failed | 4 |
EEPROM read operation failed | 5 |
EEPROM write operation failed | 6 |
Image is missing or corrupt | 7 |
Operator termination | 8 |
LOM not supported for selected operation | 9 |
Network adapter port is not bootable | 10 |
Network adapter FLASH memory is disabled | 11 |
FLASH memory too small for selected image | 12 |
Boot protocol not supported on adapter | 13 |
Selected boot protocol is not supported | 16 |
Network adapter does not support iSCSI | 14 |
Last modified on 1/04/07 3:10p Revision 6