Go to main content

Oracle® Server CLI Tools for Oracle Solaris 11.3 User's Guide

Exit Print View

Updated: April 2018
 
 

ilomconfig Command Syntax

The ilomconfig commands must be run in administrator mode.

ilomconfig subcommand type [option]

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

Options

The following table lists the options available to all CLI Tools commands, including ilomconfig.

Short Option
Long Option
Description
–?, –h
–-help
Displays help information.
–v
–-version
Displays the tool version.
–q
–-quiet
Suppresses informational message output and returns only error codes.
–y
–-yes
Confirms operation. Does not prompt user for confirmation on the operation when running.

When accessing a service processor, ilomconfig can be used over a local Host-to-ILOM interconnect or a remote Ethernet network connection. When issuing an ilomconfig command that accesses the service processor, credentials are not required when using the Host-to-ILOM interconnect, but they are required for a remote Ethernet network connection.


Note -  For systems with an Oracle ILOM version earlier than 3.2.4, to use a LAN interface (either the local Host-to-ILOM interconnect or remote Ethernet network connection) you must manually include credentials using the -H and -U options for commands that access a service processor. If credentials are not provided the commands will default to the slower local KCS interface to access the local service processor.

The options listed in the following table are supported for ilomconfig over a network connection.

Short Option
Long Options
Description
–H
–-remote-hostname
This option is followed by the host name or IP address of the remote service processor.
–U
–-remote-username
This option is followed by the user name with root access used to log in to the remote service processor.

Use these options to make changes to a service processor using a remote network connection, rather than a local Host-to-ILOM connection. When using these options to access a service processor, you must use both options together. For example:

# ilomconfig list system-summary –-remote-hostname=sp_ip –-remote-username=username

where sp_ip is the host name or IP address (in xx.xx.xx.xx format) of the target system's SP, and username is the user name with login access rights to perform the operation.


Note -  The enable/disable interconnect subcommand cannot be used on remote service processors.

You are then prompted for the Oracle ILOM user password.


Note -  The password required by the remote user name can be piped in on stdin for scripting use.

The option listed in the following table applies to using ilomconfig with a local Oracle ILOM XML configuration file.

Option
Description
–-xmlfile
This option is followed by the path to the file you want to modify.

Note -  If the --xmfile option is specified, the changes are only made to the XML file. If the XML file option is omitted, the changes are made directly to the Oracle ILOM. The XML file cannot be manually edited by a user, it can only be changed by using ilomconfig.

Subcommands

The available ilomconfig subcommands are listed in the following table.

Subcommand
Description
list
Show Oracle ILOM settings, users, SNMP communities, and system summary.
create
Create users and SNMP communities.
delete
Delete users and SNMP communities.
modify
Modify Oracle ILOM settings.
import
Restore Oracle ILOM settings from an XML file.
export
Backup Oracle ILOM settings to an XML file.
reset
Reset Oracle ILOM to factory defaults.
enable
Enable Host-to-ILOM interconnect.
disable
Disable Host-to-ILOM interconnect.