使用英特尔®以太网闪存固件实用程序升级、启用或禁用闪存

文档

安装与设置

000005790

2020 年 03 月 03 日

使用英特尔®以太网闪存固件实用程序(BootUtil)对支持英特尔 PCI 和 PCI Express 的网络适配器闪存上的 PCI 选项 ROM 进行编程。您可以使用 BootUtil 更新配置。

下载英特尔以太网闪存固件实用程序

BootUtil 是一项实用程序,可更改您的英特尔®以太网适配器的默认设置。您可以使用 BootUtil 启用或禁用 LAN 唤醒和 Intel®启动代理功能,并启用或禁用启动代理程序使用的一些设置。BootUtil 还允许对存储在 NIC flash 组件中的图像进行现场升级。

  • BootUtil 替代了旧的实用程序,并提供了旧 IBAUTIL, ISCSIUTL, LANUTIL 的功能,以及 PROBOOT, ISBoot 中找到的 FLAUTIL 实用程序,以及 PROEFI web 包。
  • BootUtil 支持前面的实用程序支持的所有适配器。
  • BootUtil 不是用作 LAN 板载(LOM)实施的实用程序。在 LOM 实现上对 BootROM 设置进行的调整可能不会影响适配器的运行方式。
会议使用 BootUtil 更新适配器闪存时,将清除闪存中的任何现有固件映像。

 

运行 BootUtil

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

逻辑组中列出了适用的选项。如果您在不使用任何命令行选项的情况下运行 BootUtil,则会显示系统中找到的所有受支持的英特尔网络适配器的列表。

常规选项

实参说明
-HELP-?显示一个命令行选项列表。
-EXITCODES显示通过 BootUtil 返回到操作系统的退出代码。
-IMAGEVERSION-IV显示资源映像中的固件类型和版本号。
如果与 -FILE 选项一起使用,则资源映像在 FLB 文件中。
如果与 -NIC 选项一起使用,则资源映像在适配器闪存中。
如果与 -ALL 选项一起使用,每个资源映像将为所有适配器连续显示。
-E枚举系统中所有受支持的网络端口。
-O = [FILENAME]

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

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

 

闪存编程选项
实参说明
-UP 要么-UPDATE=[ROMType]

[-FILE= 文件名]

更新由其指定的适配器的闪存-NIC 选项与给定的 FLB 闪存固件映像文件一起使用。在-QUIET 未指定,则在升级之前系统会提示用户确认覆盖现有固件映像。如果未提供文件名,则实用程序会查找默认不 bootimg.flb。具有所有图像类型的 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
为旧式 BIOS 启用 FCoE 并禁用 iSCSI/PXE 启动。

PXE 启动配置选项(可与 -NIC-ALL 一起使用)
实参说明
-DEFAULTCONFIG-DEFCFG将所选 NIC 的 PXE 配置设置回默认设置。
-SETUPENABLE-STE启用 "设置" 菜单。
-SETUPDISABLE-STD1禁用 "设置" 菜单。
-TITLEENABLE-TLE启用初始标题消息。
-TITLEDISABLE-TLD禁用初始标题消息。
-MESSAGEENABLE-MSE支持在 PXE 初始化时显示控制-S 安装消息。在较新的启动代理版本中,不能再使用 Control S 设置消息,释放选项 ROM 空间。
-MESSAGEDISABLE-MSD1禁用 PXE 初始化时显示的控制-S 安装消息。
-SETWAITTIME=X-SWT=X1NIC 的设置延迟时间设置为 X 秒。有效的延迟时间为0、2、3和5。
-MODE将给定模式设置写入给定 NIC 的 EEPROM。

  1 因空间限制而不再可用。菜单被移除,以释放空间,因为我们的选项 Rom 限制为64KB。尝试改用-TLE-TLD ,而不是启用和禁用。

iSCSI 引导配置选项
实参说明
-SAVECONFIG将选定端口上的 iSCSI 启动配置快照保存到一个二进制文件中。需要通过-FILE 选项指定文件名。
警告:出于安全原因,建议在使用此选项时禁用 CHAP 设置。
-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指定无、CHAP 或 MutualCHAP
-CHAPUSERNAME指定 CHAP 用户名。
-CHAPSECRET指定要使用 CHAP 用户名的机密文本字符串。
-MUTUALCHAPSECRET指定反向(目标) CHAP 机密文本字符串。

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个十六进制数字或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

本产品的 CHAP 身份验证功能需要以下确认:

退出代码

BootUtil 返回退出代码到 OS 环境。可能的退出代码如下所示:

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

 

相关主题
下载英特尔®以太网闪存固件实用程序
下载用户指南