升级、启用或禁用闪存英特尔® Ethernet Flash Firmware Utility

文档

安装与设置

000005790

2021 年 03 月 26 日

使用 英特尔® Ethernet Flash Firmware Utility (BootUtil) 对支持的英特尔 PCI 和基于 PCI-Express 的网络适配器的闪存上的 PCI 选项 ROM 进行编程。您可以使用 BootUtil 更新配置。

下载英特尔 Ethernet Flash Firmware Utility

BootUtil 是一个实用程序,更改您的适配器的英特尔® Ethernet设置。您可以使用 BootUtil 来启用或禁用 LAN 唤醒和英特尔® Boot Agent功能,以及启用或禁用启动代理使用的一些设置。BootUtil 还允许对存储在闪存组件中的映像进行现场 NIC

  • BootUtil 取代了旧的实用程序,并提供了在 PROBOOT, ISBootPROEFI web 包中IBAUTIL, ISCSIUTL, LANUTILFLAUTIL 实用程序的功能。
  • BootUtil 支持先前实用程序支持的所有适配器。
  • BootUtil 并非作为用于 LAN-on-主板 (LOM) 实施的实用程序。对 LOM 实施上的 BootROM 设置作的调整不会影响适配器的运行方式。
注意使用 BootUtil 更新适配器闪存会擦除闪存中任何现有的固件映像。

 

运行 BootUtil

BootUtil 在一个执行过程中接受一个可执行文件选项及其关联的非可执行选项。如果提供了冲突的可执行文件选项(如 -FLASHENABLE-UPDATE 一起使用)时,BOOTUTIL 退出时出现错误。

这些选项(如适用)列在逻辑组中。如果您在没有任何命令行选项的情况下运行 BootUtil,它将显示系统中所有受支持的英特尔网络适配器列表。

一般选项

参数描述
-HELP-?显示命令行选项列表。
-EXITCODES显示 BootUtil 返回操作系统的退出代码。
-IMAGEVERSION-IV显示资源映像中的固件类型和版本号。
如果与 -FILE 一同使用,则资源映像位于 FLB 文件中。
如果与 -NIC 选项一同使用,则资源映像位于适配器闪存中。
如果与 -ALL 选项一同使用,则所有适配器都持续显示每个资源映像。
-E枚举系统中所有受支持的网络端口。
-O=[文件名]

必须与 ENIC
如果与 -E 一同使用,将所有 NIC 及其 MAC 地址的列表保存到指定文件中。

如果与 -NIC 选项,为指定的保存所有 iSCSI 远程启动配置选项 NIC 到指定的文件。
-I=[文件名]从所选端口上的 [FILENAME] 脚本文件和程序设置中读取 iSCSI 引导配置选项。
-FILE=[文件名]指定用于 -SAVEIMAGE, -RESTOREIMAGE, -SAVECONFIG-RESTORECONFIG 选项的文件名。

 

闪存编程选项
参数描述
-UP-UPDATE=[ROMType]

[-FILE= 文件名]

更新由 -NIC 选项与给定的 FLB 闪存固件映像文件。如果 -QUIET 未指定,系统提示用户确认在升级之前覆盖现有固件映像。如果未提供文件名,则实用程序查找默认 bootimg。包含所有图像类型的 FLB 文件。

以下示例使用 pxe,但也可以包括 efi、efi64、FCoE 或 iSCSI。
例如: Bootutil -NIC=x -up=pxe
Bootutil -NIC=x -up=pxe -FILE= pxeimg.flb

如果您的适配器支持组合选项 ROM,以下命令选项会自动检测受支持的组合图像,并用该图像对适配器进行程序。
-up=combo

-SAVEIMAGE将现有的闪存固件映像保存到由 -NIC 选项指定的适配器的闪存中。目标文件指定 -FILE 选项。
-RESTOREIMAGE使用 -NIC 选项将以前保存的闪存固件映像还原到映像。源文件指定 -FILE 选项。
-QUIET在没有确认提示的情况下运行 BootUtil。此选项与 -IMAGEVERSION, -UP, -UPDATE, -RESTOREIMAGE-HELP 一同使用。

 

电源管理选项
参数描述
-WOLENABLE-WOLE在选定的端口上启用 Lan 唤醒 (WOL) 功能。
-WOLDISABLE-WOLD禁用所选端口上的 Lan 唤醒 (WOL) 功能。

 

适配器选择选项
参数描述
-ALL选择系统中所有受支持的网络端口。
-NIC=XX在系统中选择一个特定的网络端口。如果没有可执行文件选项使用,它打印所选端口的 iSCSI 引导配置,或在使用 -O 选项时保存该文件。
-TARGET=XX这是一个特定于 FCoE 的选择选项。法律值为 1、2、3 和 4。此选项对配置命令 -WWPN, -FCOELUN, FCOEVLAN-BOOTORDER
-BLINK所选端口上的 LED 指示灯闪烁 10 秒钟。

 

适配器闪存启用/禁用选项
参数描述
-FLASHENABLE-FE启用在所选适配器上运行闪存固件的功能。
-FLASHDISABLE-FD禁用在所选适配器上运行闪存固件的功能。
-BOOTENABLE=[PXE, ISCSIPRIMARY, ISCSISECONDARY, FCOEDISABLED]

选择闪存固件类型以在选定的端口上启用或禁用。组合选项 ROM 可以具有所有功能。整体选项 ROM 具有 PXE、FCoE 或 iSCSI 功能,但不是全部。此命令在单片选项 ROM 上不起作用。

笔记

此手动命令不适用于 UEFI 网络驱动程序。

除非其他闪存固件已经使用网络端口,否则默认启用 UEFI 网络驱动程序并自动加载。

BOOTENABLE=DISABLED
禁用传统 BIOS 的 FCoE、iSCSI 和 PXE 功能。

BOOTENABLE=ISCSIPRIMARY
启用端口作为 iSCSI 主端口,并禁用传统 BIOS 的 PXE/FCoE。

BOOTENABLE=ISCSISECONDARY
启用端口作为 iSCSI 辅助端口,并禁用传统 BIOS 的 PXE/FCoE。

BOOTENABLE=PXE
启用 PXE,并禁用传统 BIOS 的 iSCSI/FCoE 启动。

BOOTENABLE=FCOE
启用 FCoE 并禁用传统 BIOS 的 iSCSI/PXE 启动。

PXE 启动配置选项(可用于 -NIC-ALL
参数描述
-DEFAULTCONFIG-DEFCFG设置所选端口的 PXE 配置 NIC 默认设置。
-SETUPENABLE-STE启用设置菜单。
-SETUPDISABLE OR -STD1禁用设置菜单。
-TITLEENABLE OR -TLE启用初始标题消息。
-TITLEDISABLE OR -TLD禁用初始标题消息。
-MESSAGEENABLE-MSE在 PXE 初始化时启用显示 Control-S Setup 消息。在较新的启动代理版本中,Control-S Setup 消息不再可用,这将在选项 ROM 中释放空间。
-MESSAGEDISABLE-MSD1在 PXE 初始化时禁用 Control-S Setup 消息的显示。
-SETWAITTIME=X-SWT=X1将设置延迟时间设置为 x NIC 秒。有效的延迟时间为 0、2、3 和 5。
-MODE将给定的 MODE 设置写入给定模式的 EEPROM NIC(s)。

  1 由于空间限制,这些不再可用。菜单被移除以释放空间,因为选项 ROM 的存储空间限制为 64KB。尝试 -TLE-TLD以启用和禁用,或者。

iSCSI 引导配置选项
参数描述
-SAVECONFIG将所选端口上的 iSCSI 引导配置快照保存到二进制文件。需要用 -FILE 选项指定文件名。
警告: 出于安全原因,建议在使用该选项时禁用的的有(或)的这些设置。
-RESTORECONFIG恢复以前保存在所选端口上的 iSCSI 引导配置快照。需要 -FILE 选项来指定保存的数据。
警告: 如果向多个端口发出相同的命令,此功能可以创建多个主端口或辅助端口。查看 iSCSI 设置菜单中的引导优先级设置,以用于下一次系统启动。

 

iSCSI 启动器端口配置选项

这些选项既可以单独与 -NIC=XX 选项一同使用,也可以用于带 -I 选项的脚本文件中。该值在
-[OPTION]=[VALUE] 格式。

-[OPTION]=[VALUE]

描述

-INITIATORNAME指定启动程序 iSCSI 合格名称 (IQN)。
-INITIATORIP以点十进制表示法指定启动器 IPv4 地址。
-INITIATORDHCP在启动器中启用或禁用 DHCP 客户端。
-NETMASK以点十进制表示法指定启动器子掩码。
-GATEWAY以点十进制表示法指定网关 IPv4 地址。
-BOOTPRIORITY将 iSCSI 引导优先级指定为主要、次要或禁用。

 

iSCSI 目标配置选项

这些选项既可以单独与 -NIC=XX 选项一同使用,也可以用于带 -I 选项的脚本文件中。该值在
-[OPTION]=[VALUE] 格式。

-[OPTION]=[VALUE]

描述

-TARGETNAME指定目标的 iSCSI 合格名称 (IQN)。
-TARGETIP以点十进制表示法指定目标 IPv4 地址。
-TARGETDHCP启用或禁用 以从 DHCP 根路径获取目标信息。
-TARGETPORT指定要连接的目标上的 TCP 端口号。
-BOOTLUN指定要启动的 LUN 号。

 

身份验证配置选项

这些选项可以单独与 -NIC=XX 选项一同使用,也可以用 -I 选项在脚本文件中使用。该值在
-[OPTION]=[VALUE] 格式。

-[OPTION]=[VALUE]

描述

-AUTHENTICATIONMETHOD指定无、或 MUTUALCHAP
-CHAPUSERNAME指定美国国际公司 (2012) 的用户名。
-CHAPSECRET指定一个机密文本字符串以与的的一个的的一个的一个。。
-MUTUALCHAPSECRET指定反向(目标)的(目标)的(或目标)的(或)的(目标)

FCoE 通用配置选项

这些选项必须和 -NIC=XX 一起使用。它们不能与 -ALL 选项一同使用。
-WWPNPREFIX指定用于 WWPN 的前缀。前缀由 4 个六进制数字组成。允许使用"-"或":"小设备,但可选。例如:BOOTUTIL -NIC=1 -WWPNPREFIX=20-00
-WWNNPREFIX指定用于 WWNN 的前缀。前缀由 4 个六进制数字组成。允许使用"-"或":"小设备,但可选。例如:BOOTUTIL -NIC=1 -WWNNPREFIX=10-00

FCoE 目标配置选项

这些选项要求同时使用 -NIC=XX 选项和 -TARGET=XX 选项。不允许 -ALL 选项。
-WWPN指定所选目标 WWPN。该WWPN 由 16 个 HEX 位或 8 个字节组成。每个字节可以分隔为"-"或":",作为可选的"选择"。例如:BOOTUTIL -NIC=1 -TARGET=1 -WWPN=00-11-22-33-44-55-66-77
-FCOELUN指定所选 FCoE 目标的 LUN。有效范围为 0.255。
-FCOEVLAN指定要连接到所选目标的 VLAN。有效范围为 0.4094。
-BOOTORDER

指定所选目标的启动顺序。有效范围为 1-4。如果指定了 0,则目标被排除在引导顺序之外。1-4 的启动顺序值只能跨所有启用 FCoE 的端口分配一次目标。

注意这些命令都可以在同一条命令行上使用,以一次配置整个目标。
例如:BOOTUTIL -NIC=1 -TARGET=2 -WWPN=0011223344556677 -FCOELUN=0 -FCOEVLAN=1 -BOOTORDER=2

本产品的的通过服务验证的功能需要以下代理:

退出代码

BootUtil 将退出代码返回到操作系统环境。可能退出代码如下所示:

代码名称价值
所有 BootUtil 操作均成功完成0
命令行参数错误1
未检测到受支持的网络端口2
选定的网络端口无效3
闪存操作失败4
EEPROM 读取操作失败5
EEPROM 写入操作失败6
文件内容缺失或损坏7
操作员终止8
所选操作不支持 LOM9
网络端口无法启动10
闪存已禁用用于闪存固件11
闪存过小,无法用于选定固件12
编程 iSCSI 引导配置失败13
系统内存分配失败14
文件操作失败15
FCoE 操作失败16

 

相关主题
下载英特尔® Ethernet Flash Firmware Utility
下载用户指南