Flash Intel iSCSI NIC firmware
These are old notes from 2014.
Note: Intel Remote Boot AGen v19.1 is current.
Flash Enable
> BOOTUTILW64E.EXE -ALL -update=iSCSI > BOOTUTILW64E.EXE -NIC=1 -flashenable > BOOTUTILW64E.EXE -NIC=2 -flashdisable > BOOTUTILW64E.EXE -NIC=3 -flashenable
iSCSI config
Set the iSCSI configuration:
> BOOTUTILW64E.EXE -NIC=1 -I neon.cfg Intel(R) Ethernet Flash Firmware Utility BootUtil version 1.4.103.0 Copyright (C) 2003-2014 Intel Corporation Successfully updated iSCSI boot priority configuration on port 1 Successfully updated iSCSI initiator DHCP configuration on port 1 Successfully updated iSCSI initiator name configuration on port 1 Successfully updated iSCSI initiator IPv4 address configuration on port 1 Successfully updated iSCSI subnet mask configuration on port 1 Successfully updated iSCSI VLAN id configuration on port 1 Successfully updated iSCSI target DHCP configuration on port 1 Successfully updated iSCSI target name configuration on port 1 Successfully updated iSCSI target IPv4 address configuration on port 1 Successfully updated iSCSI target port number configuration on port 1 Successfully updated iSCSI boot LUN configuration on port 1 Successfully updated iSCSI authentication type configuration on port 1 Successfully updated iSCSI CHAP name configuration on port 1 Successfully updated iSCSI CHAP secret configuration on port 1 Port Network Address Location Series WOL Flash Firmware Version ==== =============== ======== ======= === ============================= ======= 1 2C534A000FF6 2:00.0 Gigabit NO iSCSI Primary 3.0.23 2 2C534A000FF7 2:00.1 Gigabit N/A FLASH Disabled 3 2C534A000FF8 2:00.2 Gigabit N/A FLASH Disabled 4 2C534A000FF9 2:00.3 Gigabit N/A FLASH Disabled
Show
> BOOTUTILW64E.EXE -NIC=1 Intel(R) Ethernet Flash Firmware Utility BootUtil version 1.4.103.0 Copyright (C) 2003-2014 Intel Corporation bootpriority=primary initiatorname=neon initiatordhcp=disable expansionrommenu=enable connwaittime=15 initiatorip=10.20.108.3 netmask=255.255.255.0 gateway=0.0.0.0 iscsivlan=208 targetname=iqn.2013-07.nz.co.lucidsolutions:pc-neon targetdhcp=disable targetip=10.20.108.2 targetport=3260 bootlun=0 authenticationmethod=chap chapusername=neon chapsecret=<12-16chars> mutualchapsecret= Port Network Address Location Series WOL Flash Firmware Version ==== =============== ======== ======= === ============================= ======= 1 2C534A000FF6 2:00.0 Gigabit NO iSCSI Primary 3.0.23 2 2C534A000FF7 2:00.1 Gigabit N/A FLASH Disabled 3 2C534A000FF8 2:00.2 Gigabit N/A FLASH Disabled 4 2C534A000FF9 2:00.3 Gigabit N/A FLASH Disabled
Residuals and issues
- Documentation on the 'iscsivlan' option is limited (setting it in the BIOS ROM menu is disabled)
- The CHAP passphrase/secret is limited to a string with 12-16 characters
- Configuration file options:
- should be specified in lower case
- don't need a hypen prefix
- lines with hash seem to be treated as comments
Links
http://www.intel.com/p/en_US/support/highlights/network/iscsi
Appendices
Adapter fails to show configuration
I had an adapter that failed
Display configuration
# ./bootutil64e -NIC=1 Intel(R) Ethernet Flash Firmware Utility BootUtil version 1.4.96.0 Copyright (C) 2003-2014 Intel Corporation bootpriority=primary initiatorname=blue initiatordhcp=disable expansionrommenu=enable connwaittime=15 initiatorip=10.20.101.9 netmask=255.255.255.0 gateway=0.0.0.0 iscsivlan=201 targetname=iqn.2013-07.nz.co.lucidsolutions:pc-blue targetdhcp=disable targetip=10.20.101.2 targetport=3260 bootlun=0 authenticationmethod=chap chapusername=blue chapsecret= mutualchapsecret= Port Network Address Location Series WOL Flash Firmware Version ==== =============== ======== ======= === ============================= ======= 1 A0369F183AA4 7:00.0 Gigabit NO iSCSI Primary 3.0.14 2 A0369F183AA4 7:00.1 Gigabit N/A iSCSI 3.0.14
Boot util options
RUNNING BootUtil
================
The syntax for issuing BootUtil command line options is:
BOOTUTIL -[OPTION] or -[OPTION]=[VALUE]
NOTE: Rebooting is required after executing BootUtil to make updated
settings valid.
COMMAND LINE OPTIONS
====================
BootUtil accepts one executable option and its associated non-executable
options in an execution. If conflicting executable options (such as
-FLASHENABLE and -UPDATE used together) are supplied, BOOTUTIL exits with an
error.
The options, where applicable, are listed in logical groups.
NOTE: If you run BootUtil without any command line options, the utility
displays a list of all supported Intel network ports found in the system.
NOTE: BootUtil displays up to 128 adapter ports.
GENERAL OPTIONS:
-HELP or -?
Displays a list of command line options.
-P
With this command, BootUtil pauses screen after displaying every 25th
line.
In pause mode, last line of the screen will contain information that:
- screen has been paused, and
- user can press Enter to continue
-EXITCODES
Displays exit codes returned to the OS environment by BootUtil.
-IMAGEVERSION or -IV
Displays firmware types and version numbers from a resource image.
If used with the -FILE option, the resource image is in the FLB file.
If used with the -NIC option, the resource image is in the adapter flash.
If used with the -ALL option, each resource image is continuously
displayed for all adapters.
-E
Enumerates all supported network ports in the system.
-O=[FILENAME]
Must be used with -E or -NIC.
If used with the -E option, saves a list of all NICs and their MAC
addresses to the specified file.
If used with the -NIC option, saves all iSCSI Remote Boot configuration
options for the specified NIC to the specified file.
-I=[FILENAME]
Reads iSCSI boot configuration options from [FILENAME] script file and
program settings on the selected port.
-FILE=[FILENAME]
Specifies the file name for -SAVEIMAGE, -RESTOREIMAGE, -SAVECONFIG,
-RESTORECONFIG, -UP or -UPDATE option.
POWER MANAGEMENT OPTIONS:
-WOLENABLE or -WOLE
Enables Wake On Lan (WOL) functionality on the selected port.
-WOLDISABLE or -WOLD
Disables Wake On Lan (WOL) functionality on the selected port.
ADAPTER SELECTION OPTIONS:
-ALL
Selects all supported network ports found in the system.
-NIC=XX
Selects a specific network port in the system. If used without any
executable option, it prints the iSCSI boot configuration of the
selected port, or saves it in the file when the -O option is used.
-TARGET=XX
This is a FCoE specific selection option. Legal values are 1,2,3,and 4.
This Option is required for configuration commands -WWPN, -FCOELUN,
FCOEVLAN, and -BOOTORDER.
-BLINK
Blinks the LED on the selected port for ten seconds.
ADAPTER FLASH ENABLE/DISABLE OPTIONS:
-FLASHENABLE or -FE
Enables the capability to run flash firmware on the selected adapter.
-FLASHDISABLE or -FD
Disables the capability to run flash firmware on the selected adapter.
-BOOTENABLE=[PXE, ISCSIPRIMARY, ISCSISECONDARY, FCOE, or DISABLE]
Selects flash firmware type to enable or disable on the selected port.
The combo option ROM could have all capabilities. The monolithic
option ROM has either PXE, iSCSI, or FCoE capability but not all. This
command will NOT WORK on monolithic Option ROMs.
Notes:
This manual command is not applicable to the UEFI network driver.
The UEFI network driver is enabled by default and loaded automatically
unless network ports are already used by other flash firmware.
BOOTENABLE=DISABLE
Disables iSCSI, PXE, and FCoE functionalities for legacy BIOS.
BOOTENABLE=ISCSIPRIMARY
Enables port as iSCSI primary and disables PXE/FCoE for legacy BIOS.
BOOTENABLE=ISCSISECONDARY
Enables port as iSCSI secondary and disables PXE/FCoE for legacy BIOS.
BOOTENABLE=PXE
Enables PXE and disables iSCSI/FCoE boot for legacy BIOS.
BOOTENABLE=FCOE
Enables FCoE and disables iSCSI/PXE boot for legacy BIOS.
FLASH PROGRAMMING OPTIONS:
-UP or -UPDATE=[RomType] [-FILE=Filename]
Updates the flash memory of the adapter specified by the -NIC option
with the given FLB flash firmware image file. If -QUIET is not specified,
the user is prompted to confirm overwriting the existing firmware image
before upgrading. If a Filename is not provided, the utility looks for the
default bootimg.FLB file which contains all imagetypes.
The following examples use pxe, but could also be efi, efi64, FCoE or
iSCSI.
eg: Bootutil -Nic=x -up=pxe
or Bootutil -Nic=x -up=pxe -file=pxeimg.flb
If your adapter supports a combo option rom, the following command option
automatically detects the supported combo image and programs the adapter
with that image -up=combo
-SAVEIMAGE or -SI
Saves the existing firmware image in the flash memory of the adapter
specified by the -NIC option to a disk file. The destination file is
specified by the -FILE option.
-RESTOREIMAGE or -RI
Restores a previously-saved firmware image to the same network adapter
using the -NIC option. The source file is specified by the -FILE option.
-QUIET
Runs BootUtil without confirmation prompts. This option is used with
-IMAGEVERSION, -UP, -UPDATE, -RESTOREIMAGE, or -HELP option.
PXE BOOT CONFIGURATION OPTIONS: (Can be used with -NIC or -ALL)
-DEFAULTCONFIG or -DEFCFG
Sets the PXE configuration of the selected NIC back to default settings.
-SETUPENABLE or -STE
Enables Setup Menu.
-SETUPDISABLE OR -STD
Disables Setup Menu.
-TITLEENABLE OR -TLE
Enables Initial Title Message.
-TITLEDISABLE OR -TLD
Disables Initial Title Message.
-MESSAGEENABLE or -MSE
Enables display of the Control-S Setup message when PXE initializes.
-MESSAGEDISABLE or -MSD
Disables display of the Control-S Setup message when PXE initializes.
-SETWAITTIME=X or -SWT=X
Set the setup delay time for the NIC to X seconds. Valid delay times are
0, 2, 3, and 5."
PXE BOOT CONFIGURATION OPTIONS CONTINUED:
-MODE
Writes the given MODE setting to EEPROM of the given NIC(s).
ISCSI BOOT CONFIGURATION OPTIONS:
-SAVECONFIG
Saves a snapshot of iSCSI boot configurations on the selected port to a
binary file. Need to specify the file name by the -FILE option.
WARNING: For security reasons it is recommended that CHAP settings are
disabled when using this option.
-RESTORECONFIG
Restores previously-saved iSCSI boot configuration snapshot on the
selected port. Need the -FILE option to specify the saved data.
WARNING: This feature may create multiple primary or secondary ports if
the same command is issued to multiple ports. Review the boot priority
setting in the iSCSI setup menu for the next system boot.
PORT CONFIGURATION OPTIONS FOR ISCSI INITIATOR:
These options can either be used individually with the -NIC=XX option,
or in a script file with the -I option. The value is specified in
-[OPTION]=[VALUE] format. Use "[OPTION]=reset" to clear configuration.
-INITIATORNAME
Specifies the iSCSI Qualified Name (IQN) for the initiator.
-INITIATORIP
Specifies the initiator IPv4 address in dotted decimal notation.
-INITIATORDHCP
Enables or disables DHCP client for the initiator.
-NETMASK
Specifies the initiator subnet mask in dotted decimal notation.
-GATEWAY
Specifies the gateway IPv4 address in dotted decimal notation.
-BOOTPRIORITY
Specifies iSCSI boot priority as PRIMARY, SECONDARY or DISABLE.
The -BOOTPRIORITY command works only when a discrete iSCSI image
is programmed on the flash and will not work with combo images.
ISCSI TARGET CONFIGURATION OPTIONS:
These options can either be used individually with the -NIC=XX option,
or in a script file with the -I option. The value is specified in
-[OPTION]=[VALUE] format. Use "[OPTION]=reset" to clear configuration.
-TARGETNAME
Specifies the iSCSI Qualified Name (IQN) for the target.
-TARGETIP
Specifies the target IPv4 address in dotted decimal notation.
-TARGETDHCP
ENABLE or DISABLE to get the target information from DHCP Root Path.
-TARGETPORT
Specifies the TCP port number on the target to connect to.
-BOOTLUN
Specifies the LUN number to boot from.
AUTHENTICATION CONFIGURATION OPTIONS:
These options can either be used individually with the -NIC=XX option,
or in a script file with the -I option. The value is specified in
-[OPTION]=[VALUE] format. Use "[OPTION]=reset" to clear configuration.
-AUTHENTICATIONMETHOD
Specifies either NONE, CHAP or MUTUALCHAP.
-CHAPUSERNAME
Specifies CHAP user name
-CHAPSECRET
Specifies a secret text string to go with the CHAP user name.
-MUTUALCHAPSECRET
Specifies the reverse (target) CHAP secret text string.
FCOE GENERAL CONFIGURATION OPTIONS:
These options have to be used with the -NIC=XX option. They cannot
be used with the -ALL Option.
-WWPNPREFIX
Specifies the Prefix to use for the WWPN. The prefix comprises of
4 hex digits. Separators '-' or ':' are allowed but optional.
Eg: BOOTUTIL -NIC=1 -WWPNPREFIX=20-00
-WWNNPREFIX
Specifies the Prefix to use for the WWNN. The prefix comprises of
4 hex digits. Separators '-' or ':' are allowed but optional.
Eg: BOOTUTIL -NIC=1 -WWNNPREFIX=1000
-SHOWFCOE
Displays the FCoE Target Configurations for the selected NIC.
Eg. BOOTUTIL -NIC=1 -SHOWFCOE
FCOE TARGET CONFIGURATION OPTIONS:
These Options require the use of both the -NIC=XX Option AND the
-TARGET=XX Option. The -ALL option is not allowed.
-WWPN
Specifies the WWPN for the selected Target. The WWPN consists of
16 HEX digits or 8 bytes. Each byte can be separated with '-' or ':'
as an optional separator.
Eg: BOOTUTIL -NIC=1 -TARGET=1 -WWPN=00-11-22-33-44-55-66-77
-FCOELUN
Specifies the LUN for the selected FCoE Target. Valid range is
0..255.
-FCOEVLAN
Specifies the VLAN to use in order to connect to the selected target.
Valid range is 0..4094.
-BOOTORDER
Specifies the boot order for the selected target. Valid range is 1-4.
If 0 is specified then this target will be excluded from the boot order.
Boot orders need to be unique AND shared across multiple ports.
If duplicate boot order configurations are attempted, the action
will result in duplicate boot orders being set to zero, and a warning
message displayed to the user.
NOTE: These commands can all be used on the same command line to configure
an entire target in one shot
Eg: BOOTUTIL -NIC=1 -TARGET=2 -WWPN=0011223344556677 -FCOELUN=0
-FCOEVLAN=1 -BOOTORDER=2
Flash enable
> BOOTUTILW64E.EXE -flashenable -ALL Intel(R) Ethernet Flash Firmware Utility BootUtil version 1.4.61.2 Copyright (C) 2003-2013 Intel Corporation Enabling boot ROM on port 1...Success Reboot the system to enable the boot ROM on this port Enabling boot ROM on port 2...Success Reboot the system to enable the boot ROM on this port Enabling boot ROM on port 3...Success Reboot the system to enable the boot ROM on this port Enabling boot ROM on port 4...Success Reboot the system to enable the boot ROM on this port Port Network Address Location Series WOL Flash Firmware Version ==== =============== ======== ======= === ============================= ======= 1 2C534A000FF6 2:00.0 Gigabit NO Reboot Required 2 2C534A000FF7 2:00.1 Gigabit N/A Reboot Required 3 2C534A000FF8 2:00.2 Gigabit N/A Reboot Required 4 2C534A000FF9 2:00.3 Gigabit N/A Reboot Required
iSCSI Firmware
> BOOTUTILW64E.EXE -ALL -update=iSCSI Intel(R) Ethernet Flash Firmware Utility BootUtil version 1.4.61.2 Copyright (C) 2003-2013 Intel Corporation Programming flash on port 1 with flash firmware image Create restore image of NIC 1 before proceeding? (Y)es or (N)o: Y Saving flash firmware image on port 1 to file 15214003.FLB...saved Updating iSCSI removes PXE functionality. Would you like to continue? (Y)es or (N)o: Y | Invalid iSCSI boot configuration on port 1 Skipping port 2 (shared flash with previous port) Skipping port 3 (shared flash with previous port) Skipping port 4 (shared flash with previous port) Port Network Address Location Series WOL Flash Firmware Version ==== =============== ======== ======= === ============================= ======= 1 2C534A000FF6 2:00.0 Gigabit NO iSCSI 2.8.30 2 2C534A000FF7 2:00.1 Gigabit N/A iSCSI 2.8.30 3 2C534A000FF8 2:00.2 Gigabit N/A iSCSI 2.8.30 4 2C534A000FF9 2:00.3 Gigabit N/A iSCSI 2.8.30
IOUtil
> IOUTILW64E.EXE /all
IOUtil v1.22.11.0 - Intel(R) Network IO Mode Enable/Disable Utility
Copyright (C) 2013 by Intel (R) Corporation. All rights reserved.
Error: No action selected.
Usage:
Run with no arguments to list adapters and usage.
/NIC=X Adapter to modify
/ALL Modify all adapters
/E Enable IO mode
/D Disable IO mode
NIC B/D/F Ven-Dev MAC IO Branding string
=== ======== ========= ============ === =======================================
1) 02/00/00 8086-1521 2C534A000FF6 ENA Intel(R) Ethernet Server Adapter I350-T
2) 02/00/01 8086-1521 2C534A000FF7 ENA Intel(R) Ethernet Server Adapter I350-T
3) 02/00/02 8086-1521 2C534A000FF8 ENA Intel(R) Ethernet Server Adapter I350-T
4) 02/00/03 8086-1521 2C534A000FF9 ENA Intel(R) Ethernet Server Adapter I350-T

