Intel(R) Ethernet Flash Firmware Utility
========================================
November 28, 2012
CONTENTS
========
- DISCLAIMER
- INTRODUCTION
- RUNNING BootUtil
- COMMAND LINE OPTIONS
- EXAMPLES
- EXIT CODES
DISCLAIMER
==========
This README.TXT, as well as the software described in it, is furnished under
licen and may only be ud or copied in accordance with the terms of the
licen. The information in this manual is furnished for informational
u only, is subject to change without notice, and should not be construed
as a commitment by Intel Corporation. Intel Corporation assumes no
responsibility or liability for any errors or inaccuracies that may appear
in this document or any software that may be provided in association with
this document.
Except as permitted by such licen, no part of this document may be
reproduced, stored in a retrieval system, or transmitted in any form or
by any means without the express written connt of Intel Corporation.
INTRODUCTION
============
The Intel(R) Ethernet Flash Firmware Utility (BootUtil) is a utility that
can be ud to program the PCI option ROM on the flash memory of supported
难为自己Intel PCI and PCI-Express-bad network adapters, and to update configurations.
BootUtil replaces existing utilities and provides the functionality of the
older IBAUTIL, ISCSIUTL, LANUTIL, and FLAUTIL. BootUtil supports all the
adapters supported by the previous utilities.
NOTE: Updating the adapter's flash memory using BootUtil will era any existing
firmware image from the flash memory.
Intel provides the following flash firmware in FLB file format for programming to
the flash memory:
- Intel(R) Boot Agent as PXE Option ROM for legacy BIOS
/support/network/adapter/pro100/bootagent/
- Intel(R) iSCSI Remote Boot as iSCSI Option ROM for legacy BIOS
/support/network/iscsi/remoteboot/
- Network Connectivity, UEFI network driver
/support/network/sb/cs-006120.htm
OEMs may provide custom flash firmware images for OEM network adapters. Plea
refer to the instructions given by OEMs.
BootUtil allows the ur to flash supported firmware to the adapter from
the included master FLB file. This option ROM includes PXE, iSCSI, FCoE,
and UEFI drivers, and the image is programmed to the flash memory at once.
BootUtil will also build the required combo images for supported adapter
and program tho images to the flash, as well. Since both discrete and combo
images are supported, the -BOOTENABLE command ONLY works on combo images.
PXE+EFI and iSCSI+EFI image combinations are supported for all OEM generic
竟然的反义词adapters, however support is limited to devices which support both technologies
as discrete images. However, flash size is a limiting factor, as the image size
can change without notice.
The Master FLB file (BOOTIMG.FLB) is the new container for all the Intel(R)
boot Option ROMs. Th
is file replaces the existing FLB files for iSCSI, PXE,
FCoE and EFI.
NOTE: BootUtil supports older flb files to maintain backwards compatibility
with the previous utilities.
BootUtil without command-line options will display a list of all supported
Intel network ports in the system. BootUtil will also allow the ur to enable
or disable the flash memory on specific ports by using -FLASHENABLE or
-FLASHDISABLE options in order to control access to the firmware from the
system.
BootUtil allows the ur to individually t iSCSI, FCoE, UEFI and PXE boot
configurations by -NIC=xx -[OPTION]=[VALUE] options. The -I option is iSCSI
specific and will not work for PXE configurations.
NOTES: BootUtil displays up to 128 adapter ports.
No configuration ttings are supported for the UEFI driver.
Functionality from the previous utility, IBAutil, is prerved in BootUtil.
BootUtil is located on the software installation CD in the \APPS\BootUtil
directory. Check the Intel Customer Support () website
for the latest information and component updates.
RUNNING BootUtil
================
The syntax for issuing BootUtil command-line options is:
BOOTUTIL -[OPTION] or -[OPTION]=[VALUE]
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 ud 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.
GENERAL OPTIONS:
-
HELP or -?
Displays a list of command-line options.
-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 ud with the -FILE option, the resource image is in the FLB file.
If ud with the -NIC option, the resource image is in the adapter flash.
If ud 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 ud with -E or -NIC.
If ud with the -E option, saves a list of all NICs and their MAC
address to the specified file.
If ud 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 ttings on the lected port.
-FILE=[FILENAME]
Specifies the file name for -SAVEIMAGE, -RESTOREIMAGE, -SAVECONFIG,
-RESTORECONFIG, -UP or -UPDATE options.
-P
With this command, BootUtil paus s
creen after displaying every 25th
line.
In pau mode, last line of the screen will contain information that:
- screen has been paud, and
- ur can press Enter to continue
-NODPL
With command, BootUtil does not display the PCI device location.
POWER MANAGEMENT OPTIONS:
-WOLENABLE or -WOLE
Enables Wake On Lan (WOL) functionality on the lected port.
-WOLDISABLE or -WOLD
Disables Wake On Lan (WOL) functionality on the lected 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 ud without any
executable option, it prints the iSCSI boot configuration of the
lected port, or saves it in the file when the -O option is ud.
-TARGET=XX
This is an FCoE-specific lection 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 lected port for ten conds.
ADAPTER FLASH ENABLE/DISABLE OPTIONS:
-FLASHENABLE or -FE
Enables the capability to run flash firmware on the lected adapter.
NOTE: This parameter is not supported on the following adapters.
-
Intel(R) Gigabit ET Quad Port Mezzanine Card
- Intel(R) Ethernet X520 10GbE Dual Portr KX4 Mezz
- Intel(R) Ethernet X520 10GbE Dual Portr KX4-KR Mezz
-FLASHDISABLE or -FD
Disables the capability to run flash firmware on the lected adapter.
NOTE: This parameter is not supported on the following adapters.
- Intel(R) Gigabit ET Quad Port Mezzanine Card
- Intel(R) Ethernet X520 10GbE Dual Portr KX4 Mezz
- Intel(R) Ethernet X520 10GbE Dual Portr KX4-KR Mezz
-BOOTENABLE=[PXE, ISCSIPRIMARY, ISCSISECONDARY, FCOE, or DISABLED]
Selects flash firmware type to enable or disable on the lected 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 ud by other flash firmware.
BOOTENABLE=DISABLED
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 condary 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 BIO
S.
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 ur 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 image types.
The following examples u 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
up=pxe+efi and up=iscsi+efi are valid.
-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 ud with
-IMAGEVERSION, -UP, -UPDATE, -RESTOREIMAGE, or -HELP option.
余罪资源PXE BOOT CONFIGURATION OPTIONS: (Can be ud with -NIC or -ALL)
-DEFAULTCONFIG or -DEFCFG
Sets the PXE configuration of the lected NIC back to default ttings.
-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 tup delay time for the NIC to X conds. Valid delay times are 0,
2, 3, and 5.
-MODE
This parameter should not be ud except as advid by Intel Support
personnel.
ISCSI BOOT CONFIGURATION OPTIONS:
-
SAVECONFIG
Saves a snapshot of iSCSI boot configurations on the lected port to a
binary file. Need to specify the file name by the -FILE option.
WARNING: For curity reasons it is recommended that CHAP ttings are
disabled when using this option.
-RESTORECONFIG
Restores previously-saved iSCSI boot configuration snapshot on the
lected port. Need the -FILE option to specify the saved data.
介绍元宵节>ppt模式WARNING: This feature may create multiple primary or condary ports if
the same command is issued to multiple ports. Review the boot priority
tting in the iSCS
I tup menu for the next system boot.
PORT CONFIGURATION OPTIONS FOR ISCSI INITIATOR:
The options can either be ud individually with the -NIC=XX option,
or in a script file with the -I option. The value is specified in
-[OPTION]=[VALUE] format.
-INITIATORNAME
Specifies the iSCSI Qualified Name (IQN) for the initiator.
-INITIATORIP
Specifies the initiator IPv4 address in dotted decimal notation.
-INITIATORDHCP
Enable or disable to get initiator configuration from DHCP.
-
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.
ISCSI TARGET CONFIGURATION OPTIONS:
The options can either be ud individually with the -NIC=XX option,
or in a script file with the -I option. The value is specified in
-[OPTION]=[VALUE] format.
-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:
The options can either be ud individually with the -NIC=XX option,
or in a script file with the -I option. The value is specified in
-[OPTION]=[VALUE] format.
-AUTHENTICATIONMETHOD
Specifies either NONE, CHAP or MUTUALCHAP.
-CHAPUSERNAME
Specifies CHAP ur name
-CHAPSECRET
Specifies a cret text string to go with the CHAP ur name.
(cret must be 12 to 16 characters long)
-MUTUALCHAPSECRET
Specifies the rever (target) CHAP cret text string.
(cret must be 12 to 16 characters long)
FCOE GENERAL CONFIGURATION OPTIONS:
The options have to be ud with the -NIC=XX option. They cannot be ud
with the -ALL option.
-WWPNPREFIX
Specifies the Prefix to u for the WWPN. The prefix compris of 4 hex
digits. Separators '-' or ':' are allowed but optional.
Eg: BOOTUTIL -NIC=1 -WWPNPREFIX=20-00
-WWNNPREFIX
Specifies the Prefix to u for the WWNN. The prefix compris of 4 hex
digits. Separators '-' or ':' are allowed but optional.
Eg: BOOTUTIL -NIC=1 -WWNNPREFIX=1000-00
FCOE TARGET CONFIGURATION OPTIONS:
The Options require the u of both the -NIC=XX Option AND the -TARGET=XX
Option. The -ALL option is not allowed.
-WWPN
Specifies the WWPN for the lected Target. The WWPN consists of 16 HEX
digits or 8 bytes. Each byte can be parated with '-' or ':' as an
optional parator.
Eg: BOOTUTIL -NIC=1 -TARGET=1 -WWPN=00-11-22-33
