Reference

mpsutil(8)

Utility for managing LSI Fusion-MPT 2/3 controllers

Part of mprutil(8).

NAME

mpsutil, mprutil – Utility for managing LSI Fusion-MPT 2/3 controllers

SYNOPSIS

mpsutil version

mpsutil [-u unit] show adapter

mpsutil [-u unit] show adapters

mpsutil [-u unit] show all

mpsutil [-u unit] show cfgpage page [num] [addr]

mpsutil [-u unit] show devices

mpsutil [-u unit] show discovery

mpsutil [-u unit] show enclosures

mpsutil [-u unit] show expanders

mpsutil [-u unit] show iocfacts

mpsutil [-u unit] set ncq [enable|disable]

mpsutil [-u unit] flash save [firmware|bios] [file]

mpsutil [-u unit] flash update [firmware|bios] file

DESCRIPTION

The mpsutil utility can be used to display or modify various parameters on LSI Fusion-MPS 2 controllers.

The mprutil utility can be used to display or modify various parameters on LSI Fusion-MPS 3 controllers.

Both the mprutil and mpsutil commands behave identically.

Each invocation of mpsutil consists of zero or more global options followed by a command. Commands may support additional optional or required arguments after the command.

Currently one global option is supported:

-u unit

unit specifies the unit of the controller to work with. If no unit is specified, then unit 0 is used.

The mpsutil utility supports several different groups of commands. The first group of commands provide information about the controller. The second group of commands are used to manager controller-wide operations.

The informational commands include:

version

Displays the version of mpsutil.

show adapter

Displays information about the controller such as the model number or firmware version.

show adapters

Displays a summary of all adapters.

show all

Displays all devices, expanders and enclosures.

show devices

Displays all devices.

show discovery

Displays the firmware DiscoveryStatus field for each PHY (“SAS IO Unit Page 0)” and the AccessStatus field for each device (“SAS Device Page 0)”. Entries with a nonzero DiscoveryStatus, a non-Ok AccessStatus, or a PHY still showing discovery in progress are marked “SUSPECT”. Useful for finding which PHY or device a firmware discovery stall was attributed to, since these fields aren't otherwise exposed and can remain set after the boot completes.

show expanders

Displays all expanders.

show enclosures

Displays all enclosures.

show iocfacts

Displays IOC Facts messages.

show cfgpage page [num] [addr]

Dump raw config page in hex.

Controller management commands include:

set ncq [enable|disable]

Enables or disables NCQ in the NVRAM of the card.

flash save [firmware|bios] [file]

Save the firmware or bios from the controller into a local file. If no file is specified then the file will be named firmware or bios.

flash update [firmware|bios] file

Replace the firmware or bios from the controller with the one specified via file.

SEE ALSO

mpr(4), mps(4)

HISTORY

The mpsutil utility first appeared in FreeBSD 11.0.

TODO

Flash operations (save/update) are not supported on big-endian architectures.

History