fwupdate Command Syntax

The fwupdate command uses the following syntax:

fwupdate subcommand target options

If you use the --help or --version options, the fwupdate command does not require subcommands; otherwise a subcommand is mandatory.

When a command fails, it returns one of the failure codes listed in fwupdate Error Codes.

fwupdate supports the subcommands listed in the following table.

Subcommand Description

list

Provides firmware information about a device or a file. For targets and options specific to the list subcommand, see Listing Component Firmware Information.

update

Updates the firmware of one or more system components based on command-line directives. Devices can be updated automatically using metadata information contained in an XML file included with the device patch (recommended), or updated manually using a firmware image file. For targets and options specific to the update subcommand, see Updating Component Firmware.

reset

Resets the specified device if the device supports a reset. Perform a reset on a device after a manual mode firmware update (if required). In some cases where the metadata used in an automatic mode firmware update does not automatically reset a device that requires one, this subcommand can be used. For targets and options specific to the reset subcommand, see Reset a Device After a Firmware Update.

The following table lists general options available for fwupdate. Options specific to each subcommand are described in the section that describes using the subcommand.

Short Option Long Option Description

-?, -h

--help

Displays help information.

-H

--remote-hostname=sp_ip

The host name, Common Name, or IP address of the remote service processor as specified by sp_ip. This option must be used in combination with the -U option.

Note:

When accessing an SP over a remote Ethernet network connection, client-side SSL certificate validation is performed by default. For proper validation, you must use the Common Name stored in the client-side SSL certificate and the DNS server for the SP remote host name (e.g. -H ORACLESP-1000NML000). Otherwise, you will receive a "hostname validation failed" error.

-U

--remote-username=username

The user name with root access used to log in to the remote service processor as specified by username. This option must be used in combination with the -H option.

-V

--version

Displays the tool version.

-q

--quiet

Uses silent, non-interactive mode. Suppresses user prompts and informational message output and only returns error codes during the update. Useful for scripting.

Note:

When using the quiet option, if the --no-cert-check option is not used and the certificate validation fails the utility will return an error.

-t

--intfname=interface

Specifies the IPMI interface to use. No auto-detect is attempted. Supported interfaces that are compiled in are visible in the usage help output (socket interfaces in case -H option is used). See the -T description for more information.

This option was introduced in Oracle Hardware Management Pack 2.4.9.0.

-T

--remote-intfname-fallback=interface

Selects the least secured IPMI socket interface to use if more secure interfaces are not supported. The tool attempts the most secure interface first (orcltls). If the BMC does not support the interface, then attempt the next most secured socket interface until the specified interface. Supported socket interfaces that are compiled in are visible in the usage help output in the appropriate order. If lanplus or lan is specified, certificate checking is disabled when attempting the orcltls interface.

Note:

If the -T or -t option is not specified, then no auto-detect is enabled and only the orcltls interface is attempted including certificate checking.

This option was introduced in Oracle Hardware Management Pack 2.4.9.0.

-y

--yes

Bypass user confirmation prompt when overwriting an existing output file of the same name.

n/a

--cert-dir=pathname

Location of trusted certificates as specified by pathname. Use this option if your client-side SSL certificate is in a different directory than the expected default system certificate directory.

This option was introduced in Oracle Hardware Management Pack 2.4.4.

n/a

--no-cert-check

Do not perform SSL certificate checking.

This option was introduced in Oracle Hardware Management Pack 2.4.4.