ubiosconfig Command Syntax

The ubiosconfig commands use the following command syntax:

ubiosconfig subcommand type [option]

If you use the --help or --version options, the ubiosconfig command does not require subcommands; otherwise one or more subcommands are mandatory.

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

ubiosconfig supports the subcommands listed in the following table.

Subcommand Function

import

Import a configuration XML file that will be applied to the server's UEFI BIOS at next boot.

export

Export the server's UEFI BIOS configuration to a local XML file.

cancel

Cancel pending UEFI BIOS configuration changes.

list

List status information regarding pending UEFI BIOS import or export operations.

reset

Reset the server's UEFI BIOS configuration to factory default at next boot.

The following table lists general options available for ubiosconfig. 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.

-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.

-V

--version

Displays the tool version.

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.