Mellanox PreBoot Drivers (FlexBoot &amp

Add to My manuals
69 Pages

advertisement

Mellanox PreBoot Drivers (FlexBoot & | Manualzz

7

7.1

FlexBoot System Settings Configuration Options

Below are listed the attributes shown in varies FlexBoot User Interface menus.

System Setup

In the following menu, you can set the following options:

Diagnostic

[ConnectX-5 Only] Power Configuration

Chip Type

Device Name

PCI Device ID

Banner Menu Timeout

Virtualization Mode

Number of Virtual Functions

Figure 5: System Setup Menu

24 Mellanox Technologies Rev 3.0

7.1.1 Diagnostic

Diagnostic menu enables the user to diagnose problems in released ROMs by enabling the debug log levels for specific modules. This ability should be used only when debug session is needed.

Figure 6: Diagnostic Properties Menus

7.1.1.1 boot_to_shell

Location:

Description:

Configurable:

Available options:

Diagnostic

When set to enable, Flexboot well boot to ipxe shell instead of the normal boot.

Yes

1 - Enable

2 - Disable

Rev 3.0 Mellanox Technologies 25

7.1.1.2

7.1.2

7.1.3

7.1.4

7.1.5

7.1.6

Persistency: panic_behavior

Location:

Description:

Configurable:

Available options:

Persistency:

Persistent through AC cycle

Diagnostic

Flexboot behavior on critical failure.

 when set to PRINT , print error to screen

 when set to HALT - freeze system

 when set to OPEN_SHELL, open ipxe shell

 when set to REG_DUMP dump FW registers and exit to shell

Yes

1 - PRINT

2 - HALT

3 - OPENSHELL

4 - REG_DUMP

Persistent through AC cycle

Bus:Device:Function

Location:

Description:

Configurable:

System setup

Specifies the BIOS assigned PCI Bus:Device:Function identifier of the card

No

Chip Type

Location:

Description:

Configurable:

Device Name

Location:

Description:

Configurable:

System setup

Specifies the chip type

No

System setup

The device’s product name

No

PCI Device ID

Location:

Description:

Configurable:

System setup

The PCI Device ID of the controller

No

Banner Menu Timeout

Location:

System setup

26 Mellanox Technologies Rev 3.0

7.1.7

7.1.8

Description:

Configurable:

Persistency:

Reboot required:

Available options:

Defines the Banner's timeout

Yes – via input

Persistent through AC cycle

Yes – reboot is needed in order for this change to apply

1-14 sec

Virtualization Mode

Location:

Description:

Configurable:

Persistency:

Reboot required:

Available options:

System setup

Specifies the type of virtualization used by the controller on all ports.

Only valid for adapters that support SR-IOV virtualization mode.

Yes – built-in options

Persistent through AC cycle

Yes – reboot is needed in order for this change to apply

1. None

2. SR-IOV

Number of Virtual Functions

Location:

Description:

Configurable:

Persistency:

Reboot required:

Value restrictions:

System setup

The number of virtual functions advertised and usable by the driver. Only valid for adapters that support SR-IOV virtualization mode.

Yes – via input – If virtualization mode is SR-IOV

Persistent through AC cycle

Yes – reboot is needed in order for this change to apply

Minimum integer value is 0. Maximum integer value is the value supported by the firmware installed.

Rev 3.0 Mellanox Technologies 27

7.2 Power Configuration

[ConnectX-5 Only] In the following menu, you can set advanced power settings:

Advanced Power Settings

Disable Slot Power Limiter

Figure 7: Power Configuration Properties Menu

7.2.1

7.2.2

Advanced Power Settings

Location:

Description:

Configurable:

Available options:

Power Configuration

When set to Enabled, additional power settings parameter are configurable.

Yes

1. Enabled

2. Disabled

Disable Slot Power Limiter

Location:

Description:

Configurable:

Available options:

Power Configuration

When set, the slot power limiter is disabled, and the device is allowed to consume more than 25W from the PCIe power rails.

Yes

1. Enabled

2. Disabled

28 Mellanox Technologies Rev 3.0

7.3 Firmware Image Properties

In the following menu, you can set the following options:

Flexboot Version

Family Firmware Version

Figure 8: Firmware Image Properties Menu

7.3.1

7.3.2

Flexboot Version

Location:

Description:

Configurable:

Available options:

System setup /Firmware Image Properties

Flexboot driver version information

No

3. None – no PXE boot, no iSCSI boot

4. PXE – PXE first and if failed try iSCSI iSCSI – iSCSI first and if failed try PXE

Family Firmware Version

Location:

Description:

Configurable:

System setup /Firmware Image Properties

Device’s firmware version information.

No

Rev 3.0 Mellanox Technologies 29

7.4 Main Configuration

In the following menu, you can set the following options:

Blink LEDs

MAC Address

Figure 9: Main Configuration

30

7.4.1 Blink LEDs

NOTE: Blink LEDs will not appear in the boot menu if the feature is not supported by the firmware.

NOTE: LEDs starts to blink as soon as you press the Enter key.

Location:

Description:

Configurable:

Persistency:

Effects:

Value restrictions:

System setup/Port main configurations

Specifies the number of seconds the LEDs on physical network port should blink to assist with port identification. Only valid for adapters with blink LEDs.

Yes – via input

Valid only for current cycle

Blink LEDs duration value of the port will be as set in the current cycle

The minimum integer value is 0 and the maximum is 15.

Mellanox Technologies Rev 3.0

7.4.2

7.5

7.5.1

MAC Address

Location:

Description:

Configurable:

System setup/Port main configurations

Permanent MAC address assigned during manufacturing

No

NIC Configuration

Ethernet NIC Configuration

In the following menu, you can set the following options:

Legacy Boot Protocol

IPv4/IPv6 support

Boot Retry Count

Undi network wait timeout

Virtual LAN ID

Virtual LAN Mode

VPI link type

Wake on LAN

Figure 10: Ethernet NIC Configuration

7.5.1.1 Legacy Boot Protocol

Location:

Description:

System setup/Port main configurations/NIC Configuration

Use a non-UEFI network boot protocol.

The chosen protocol is tried first; if boot fails the other protocol may be used.

Rev 3.0 Mellanox Technologies 31

32

7.5.1.2

7.5.1.3

7.5.1.4

Configurable:

Persistency:

Available options:

Notes:

1. If set to NONE, the boot will be skipped on this port.

2. IF all the ports per Bus Device function (BDF) are set as NONE, a

BEV entry is not registered.

Yes – built-in options

Persistent through AC cycle

5. None – no PXE boot, no iSCSI boot

6. PXE – PXE first and if failed try iSCSI

7. iSCSI – iSCSI first and if failed try PXE

IPv4/IPv6 support

Location:

Description:

Configurable:

Persistency:

Reboot required:

Available options:

System setup/Port main configurations/NIC Configuration

Select which IP protocol version will be used when booting. If both are configured, FlexBoot will try to boot with the 2 nd

protocol only if failed to boot with the 1 st

one.

Yes – built-in option

Persistent through AC cycle

No

1. IPv4

2. IPv6

3. IPv4/IPv6

Boot Retry Count

Location:

Description:

Configurable:

Persistency:

Available options:

System setup/Port main configurations/NIC Configuration

The number of retries to attempt in case of a boot failure.

Yes – built-in options

Persistent through AC cycle

0. No retries

1. Retry

2. Retries

3. Retries

4. Retries

5. Retries

6. Retries

7. Indefinite Retries

Undi network wait timeout

Location:

Description:

Configurable:

Value restrictions:

System setup/Port main configurations/NIC Configuration

When the UNDI interface is used, defines the delay time when

PXENV_UNDI_OPEN call is issued.

Yes – via input

The minimum integer value is 0 and Maximum integer value is 30.

Mellanox Technologies Rev 3.0

7.5.1.5

7.5.1.6

7.5.1.7

7.5.1.8

Virtual LAN ID

Location:

Description:

Configurable:

Value restrictions:

Virtual LAN Mode

Location:

Description:

Configurable:

Persistency:

Available options:

System setup/Port main configurations/NIC Configuration

Uses the VLAN tag with the selected boot protocol.

Yes – via input – If virtual LAN mode is enabled

The minimum integer value is 1 and Maximum integer value is 4094.

System setup/Port main configurations/NIC Configuration

Enable/Disable VLAN tagging on the selected boot protocol.

Yes – built-in options

Persistent through AC cycle

1. Enabled

2. Disabled

VPI link type

Location:

Description:

Configurable:

Persistency:

Reboot required:

Available options:

System setup/Port main configurations/NIC Configuration

Specifies the network link type for supported cards.

Note: This option is available only on supported devices.

Yes – built-in option

Persistent through AC cycle

Yes – reboot is needed in order for this change to apply

1. InfiniBand

2. Ethernet

Wake on LAN

Location:

Description:

Configurable:

Persistency:

Available options:

System setup/Port main configurations/NIC Configuration

Status of Wake on LAN feature. When set, it enables the server to be powered using an in-band magic packet.

Only valid for adapters that support Wake on LAN.

Note: This option is available only on supported devices.

Yes – built-in options

Persistent through AC cycle

1. Enabled

2. Disabled

Rev 3.0 Mellanox Technologies 33

7.5.2 InfiniBand NIC Configuration

In the following menu, you can set the following options:

PKey Value

Legacy Boot Protocol

Boot Retry Count

VPI link type

Figure 11: InfiniBand NIC Configuration

7.5.2.1 PKey Value

Location:

Description:

Configurable:

Persistency:

Available options:

System setup/Port main configurations/NIC Configuration

PKey value to be used when booting IPoIB

Yes

Persistent through AC cycle

0-65535

0 – the default PKey value

34 Mellanox Technologies Rev 3.0

7.6 iSCSI General Parameters

In the following menu, you can set the following options:

DHCP IP

DHCP Parameters

IP Version

CHAP Authentication

CHAP Mutual Authentication

Figure 12: iSCSI General Parameters

7.6.1

7.6.2

DHCP IP

Location:

Description:

System setup/Port main configurations/iSCSI Configuration/iSCSI

General Parameters

When the DHCP IP is enabled, the initiator and target’s IP, netmask, gateway and DNS will be taken from DHCP instead of from the menu.

Yes

Configurable:

DHCP Parameters

Location:

Description:

Configurable:

System setup/Port main configurations/iSCSI Configuration/iSCSI

General Parameters

When the DHCP IP and DHCP Parameters are enabled, all the initiator and target’s parameters are taken from DHCP instead of from the menu.

Yes

Rev 3.0 Mellanox Technologies 35

7.6.3

7.6.4

7.6.5

7.6.6

IP Version

Location:

Description:

System setup/Port main configurations/iSCSI Configuration/iSCSI

General Parameters

Specifies whether IPv4 or IPv6 network addressing will be used for iSCSI initiator and targets

No

Configurable:

CHAP Authentication

Location:

Description:

Configurable:

System setup/Port main configurations/iSCSI Configuration/iSCSI

General Parameters

Enables CHAP Authentication for iSCSI initiator.

Yes

CHAP Mutual Authentication

Location:

Description:

Configurable:

System setup/Port main configurations/iSCSI Configuration/iSCSI

General Parameters

Enables mutual CHAP authentication between the iSCSI initiator and target

Yes

Boot to target

Location:

Description:

Configurable:

Available options:

System setup/Port main configurations/iSCSI Configuration/iSCSI

General Parameters

Controls booting to ISCSI target after connection.

Yes

1. Enable

2. Disable

3. One time disabled

36 Mellanox Technologies Rev 3.0

7.7 iSCSI Initiator Parameters

NOTE: iSCSI Initiator Parameters menu is applicable to ConnectX®-3/ConnectX®-3

Pro adapter cards only.

In the following menu, you can set the following options:

CHAP ID

CHAP Secret

IPv4 Address

IPv4 Primary DNS

IPv4 Default Gateway

iSCSI Name

Subnet Mask

Figure 13: iSCSI Initiator Parameters

7.7.1 CHAP ID

Location:

Description:

Configurable:

Persistency:

Effects:

System setup/Port main configurations/iSCSI Configuration/iSCSI

Initiator Parameters

The iSCSI initiator Challenge-Handshake Authentication Protocol

(CHAP) ID

Yes – via input

Persistent through AC cycle

If the Connect and the CHAP Mutual Authentication are enabled – This will be the reverse username used for the iSCSI initiator Challenge-

Handshake Authentication Protocol.

Rev 3.0 Mellanox Technologies 37

7.7.2

7.7.3

7.7.4

7.7.5

Value restrictions:

CHAP Secret

Location:

Maximum string length is 128.

Description:

Configurable:

Persistency:

Effects:

System setup/Port main configurations/iSCSI Configuration/iSCSI

Initiator Parameters

The iSCSI initiator Challenge-Handshake Authentication Protocol

(CHAP) secret (password).

Yes – via input

Persistent through AC cycle

If the Connect and the CHAP Mutual Authentication are enabled – This will be the reverse password used for the iSCSI initiator Challenge-

Handshake Authentication Protocol.

String length should be 0 or 12 to 16

Value restrictions:

IPv4 Address

Location:

Description:

Configurable:

Persistency:

Effects:

Value restrictions:

System setup/Port main configurations/iSCSI Configuration/iSCSI

Initiator Parameters iSCSI initiator’s IPv4 address

Yes – via input

Persistent through AC cycle

If the legacy boot protocol is iSCSI – This will be set as the IP address of the initiator.

Should be in IPv4 format

IPv4 Primary DNS

Location:

Description:

Configurable:

Persistency:

Effects:

System setup/Port main configurations/iSCSI Configuration/iSCSI

Initiator Parameters

The iSCSI initiator Primary DNS IP Address.

Yes – via input

Persistent through AC cycle

If the legacy boot protocol is iSCSI – This will be set as the DNS for the

IP address of the initiator.

Should be in IPv4 format

Value restrictions:

IPv4 Default Gateway

Location:

Description:

Configurable:

Persistency:

System setup/Port main configurations/iSCSI Configuration/iSCSI

Initiator Parameters

The iSCSI initiator default Gateway IP address.

Yes – via input

Persistent through AC cycle

38 Mellanox Technologies Rev 3.0

7.7.6

7.7.7

Effects:

If the legacy boot protocol is iSCSI – This will be set as the default gateway IP address of the initiator.

Should be in IPv4 format

Value restrictions: iSCSI Name

Location:

Description:

Configurable:

Persistency:

Effects:

System setup/Port main configurations/iSCSI Configuration/iSCSI

Initiator Parameters

The initiator's iSCSI Qualified Name (IQN).

Yes – via input

Persistent through AC cycle

If the legacy boot protocol is iSCSI – This will be set as the iSCSI

Qualified Name of the initiator.

Maximum string length is 223

Value restrictions:

Subnet Mask

Location:

Description:

Configurable:

Persistency:

Effects:

Value restrictions:

System setup/Port main configurations/iSCSI Configuration/iSCSI

Initiator Parameters

The iSCSI initiator Subnet Mask for an IPv4 initiator configuration.

Yes – via input

Persistent through AC cycle

If the legacy boot protocol is iSCSI – This will be set as the subnet mask for the IP address of the initiator.

Should be in IPv4 format

Rev 3.0 Mellanox Technologies 39

7.8 iSCSI First Target Parameters

NOTE: iSCSI First Target Parameters menu is applicable to ConnectX®-3/ConnectX®-3 Pro adapter cards only.

In the following menu, you can set the following options:

Boot LUN

Connect

iSCSI Name

CHAP ID

CHAP Secret

IP Address

TCP Port

7.8.1 Boot LUN

Location:

Description:

Configurable:

Persistency:

Effects:

Value restrictions:

System setup/Port main configurations/iSCSI Configuration/iSCSI First target Parameters

The boot Logical Unit Number (LUN) on the first iSCSI storage target.

Yes – via input

Persistent through AC cycle

If the legacy boot protocol is iSCSI and Connect is enabled – This will be the boot LUN in the root path for the first target.

The minimum integer value is 0 and the maximum is 256.

40 Mellanox Technologies Rev 3.0

7.8.2

7.8.3

7.8.4

7.8.5

Connect

Location:

Description:

Configurable:

Persistency:

Available options:

System setup/Port main configurations/iSCSI Configuration/iSCSI First target Parameters

Enable/Disable connecting to the first iSCSI target. This will be ignored if both DHCP IP and DHCP Parameters are enabled in iSCSI general parameters.

Yes – built-in options

Persistent through AC cycle

1. Enabled

2. Disabled

iSCSI Name

Location:

Description:

Configurable:

Persistency:

Effects:

Value restrictions:

CHAP ID

Location:

Description:

Configurable:

Persistency:

Effects:

System setup/Port main configurations/iSCSI Configuration/iSCSI First target Parameters

The iSCSI Qualified Name (IQN) of the first target

Yes – via input

Persistent through AC cycle

If the legacy boot protocol is iSCSI and Connect is enabled – This will be the iSCSI Qualified name in the root path for the first target.

Maximum string length is 223

System setup/Port main configurations/iSCSI Configuration/iSCSI First target Parameters

The first iSCSI storage target Challenge-Handshake Authentication

Protocol (CHAP) ID.

Yes – via input

Persistent through AC cycle

If the Connect and the CHAP Authentication are enabled – This will be the username used for the first target Challenge-Handshake

Authentication Protocol.

Maximum string length is 128.

Value restrictions:

CHAP Secret

Location:

Description:

Configurable:

Persistency:

System setup/Port main configurations/iSCSI Configuration/iSCSI First target Parameters

The Challenge-Handshake Authentication Protocol secret (CHAP password) of the first iSCSI storage target.

Yes – via input

Persistent through AC cycle

Rev 3.0 Mellanox Technologies 41

7.8.6

7.8.7

Effects:

If the Connect and the CHAP Authentication are enabled – This will be the password used for the first target Challenge-Handshake

Authentication Protocol.

String length should be 0 or 12 to 16

Value restrictions:

IP Address

Location:

Description:

Configurable:

Persistency:

Effects:

System setup/Port main configurations/iSCSI Configuration/iSCSI First target Parameters

The IP address of the first iSCSI target

Yes – via input

Persistent through AC cycle

If the legacy boot protocol is iSCSI and Connect is enabled – This will be the IP address in the root path for the first target.

Should be in IPv4 format

Value restrictions:

TCP Port

Location:

Description:

Configurable:

Persistency:

Effects:

Value restrictions:

System setup/Port main configurations/iSCSI Configuration/iSCSI First target Parameters

TCP Port number of first iSCSI target

Yes – via input

Persistent through AC cycle

If the legacy boot protocol is iSCSI and Connect is enabled – This will be the TCP Port in the root path for the first target.

The minimum integer value is 1, and the maximum is 65535.

42 Mellanox Technologies Rev 3.0

advertisement

Related manuals

advertisement

Table of contents