Running Service-Related Commands - Sun Netra T5440 Server

Language:

1.4.2 Running Service-Related Commands

This section describes commands commonly used for service-related activities.

1.4.2.1 Connecting to the Service Processor

Before you can run ILOM commands, you must connect to the service processor in one of two ways:

Connect an ASCII terminal directly to the serial management port.
Use the ssh command to connect to the service processor through an Ethernet connection on the network management port.

Note - Refer to the Sun Integrated Lights Out Management 2.0 Supplement for the Sun Netra T5440 Server for instructions on configuring and connecting to the service processor.

1.4.2.2 Switching Between the System Console and Service Processor

To switch from the console output to the ALOM CMT CLI sc> prompt, type #. (Hash-Period).
To switch from the service processor prompt to the console, do one of the following:
- From the ILOM -> prompt, type start /SP/console.
- From the ALOM-CMT sc> prompt, type console.

1.4.2.3 Service-Related Commands

Service-Related Commands describes the typical ALOM CMT CLI commands for servicing a server. For descriptions of all ALOM CMT CLI commands, issue the help command or refer to the Integrated Lights Out Management 2.0 User's Guide.

Table 1-6 Service-Related Commands

ILOM Command	ALOM CMT Command	Description
`help` `[command]`	`help` [`command`]	Displays a list of all available commands with syntax and descriptions. Specifying a command name as an option displays help for that command.
`set /HOST send_break_action=break`	`break` [`-y`][`-c`][`-D`] `-y` skips the confirmation question. `-c` executes a `console` command after the `break` command completes. `-D` forces a core dump of the Solaris OS.	Takes the host server from the OS to either `kmdb` or OpenBoot PROM (equivalent to a Stop-A), depending on the mode Solaris software was booted.
`set /SYS/component` `clear_fault_action=true`	`clearfault` `UUID`	Manually clears host-detected faults. The `UUID` is the unique fault ID of the fault to be cleared.
start /SP/console	console [-f] `-f` forces the console to have read and write capabilities.	Connects you to the host system.
`show /SP/console/history`	consolehistory [-b `lines`\|-e `lines`\|-v] [-g `lines`] [boot\|run] The following options enable you to specify how the output is displayed: `-g` `lines` specifies the number of lines to display before pausing. `-e` `lines` displays `n` lines from the end of the buffer. `-b` `lines` displays `n` lines from the beginning of the buffer. `-v` displays the entire buffer. `boot\|run` specifies the log to display (`run` is the default log).	Displays the contents of the system's console buffer.
set /HOST/bootmode `property`=`value` [where `property` is `state`, `config`, or `script`]	bootmode [normal] [reset_nvram] [config=`configname`] [bootscript=`string`]	Controls the host server OpenBoot PROM firmware method of booting.
`stop /SYS; start /SYS`	`powercycle` [`-f`] The `-f` option forces an immediate poweroff. Otherwise the command attempts a graceful shutdown.	Performs a `poweroff` followed by `poweron`.
`stop /SYS`	`poweroff` [`-y`] [`-f`] `-y` enables you to skip the confirmation question. `-f` forces an immediate shutdown.	Powers off the host server.
`start /SYS`	`poweron [-c]` `-c` executes a `console` command after completion of the `poweron` command.	Powers on the host server.
set /SYS/PS`x` prepare_to_remove_action=true	`removefru PS0\|PS1`	Indicates if it is okay to perform a hot-swap of a power supply. This command does not perform any action. But this command provides a warning if the power supply should not be removed because the other power supply is not enabled.
`reset /SYS`	`reset` [`-y`] [-c] `-y` enables you to skip the confirmation question. `-c` executes a `console` command after completion of the `reset` command.	Generates a hardware reset on the host server.
`reset /SP`	`resetsc` [`-y`] `-y` enables you to skip the confirmation question.	Reboots the service processor.
`set /SYS keyswitch_state=value` `normal \| stby \| diag \| locked`	`setkeyswitch` `[-y]` `value` `normal` \| `stby` \| `diag` \| `locked` `-y` enables you to skip the confirmation question when setting the keyswitch to `stby`.	Sets the virtual keyswitch.
`set /SYS/LOCATE value=value` [`Fast_blink` \| `Off`]	`setlocator` `value` [`on` \| `off`]	Turns the Locator LED on the server on or off.
{No ILOM equivalent.)	`showenvironment`	Displays the environmental status of the host server. This information includes system temperatures, power supply, front panel LED, hard drive, fan, voltage, and current sensor status.
`show faulty`	`showfaults` [`-v`]	Displays current system faults.
{No ILOM equivilient.)	`showfru` [`-g` `lines`] [`-s` \| `-d`] [`FRU`] `-g` `lines` specifies the number of lines to display before pausing the output to the screen. `-s` displays static information about system FRUs (defaults to all FRUs, unless one is specified). `-d` displays dynamic information about system FRUs (defaults to all FRUs, unless one is specified).	Displays information about the FRUs in the server.
`show /SYS keyswitch_state`	`showkeyswitch`	Displays the status of the virtual keyswitch.
`show /SYS/LOCATE`	`showlocator`	Displays the current state of the Locator LED as either on or off.
`show /SP/logs/event/list`	`showlogs` [`-b` `lines` \| `-e` `lines` `\| -v]` [`-g` `lines`] [`-p logtype[r\|p]]`]	Displays the history of all events logged in the service processor event buffers (in RAM or the persistent buffers).
`show /HOST`	`showplatform` [`-v`]	Displays information about the operating state of the host system, the system serial number, and whether the hardware is providing service.

Note - See ASR Commands for the automatic system recover (ASR) commands.

Detecting Faults

The ILOM show faulty command displays the following kinds of faults:

E nvironmental or configuration faults – System configuration faults, or temperature or voltage problems that might be caused by faulty FRUs (power supplies, fans, or blower), or by room temperature or blocked air flow to the server.
POST detected faults – Faults on devices detected by the power-on self-test diagnostics.
PSH detected faults – Faults detected by the Solaris Predictive Self-healing (PSH) technology

Use the show faulty command for the following reasons:

To see if any faults have been diagnosed in the system.
To verify that the replacement of a FRU has cleared the fault and not generated any additional faults.

At the -> prompt, type the show faulty command.

The following show faulty command examples show the different kinds of output from the show faulty command:

Example of the show faulty command when no faults are present:

-> show faulty
Target              | Property               | Value
--------------------+------------------------+------------------------------- 
 
-----------------------------------------------------------------------------

Example of the show faulty command displaying an environmental fault:

-> show faulty
Target              | Property               | Value 
--------------------+------------------------+-------------------------------
/SP/faultmgmt/0     | fru                    | /SYS/FANBD0/FM0 
/SP/faultmgmt/0     | timestamp              | Dec 14 23:01:32 
/SP/faultmgmt/0/    | timestamp              | Dec 14 23:01:32 faults/0 
/SP/faultmgmt/0/    | sp_detected_fault      | TACH at /SYS/FANBD0/FM0/F0 has 
faults/0            |                        | exceeded low non-recoverable
                    |                        | threshold.

Example showing a fault that was detected by POST. These kinds of faults are identified by the message Forced fail reason where reason is the name of the power-on routine that detected the failure.

-> show faulty
Target              | Property               | Value 
--------------------+------------------------+-------------------------------- 
/SP/faultmgmt/0     | fru                    | /SYS/MB/CMP0/BR1/CH0/D0
/SP/faultmgmt/0     | timestamp              | Dec 21 16:40:56
/SP/faultmgmt/0/    | timestamp              | Dec 21 16:40:56 
faults/0            |                        |
/SP/faultmgmt/0/    | sp_detected_fault      | /SYS/MB/CMP0/BR1/CH0/D0 
faults/0                                     | Forced fail(POST)

Example showing a fault that was detected by the PSH technology. These kinds of faults are identified by the text Host detected fault and by a UUID.

-> show faulty
Target              | Property               | Value 
--------------------+------------------------+--------------------------------
/SP/faultmgmt/0     | fru                    | /SYS/MB/CMP0/BR0/CH1/D0 
/SP/faultmgmt/0     | timestamp              | Dec 14 22:43:59
/SP/faultmgmt/0/    | sunw-msg-id            | SUN4V-8000-DX
faults/0            |                        |
/SP/faultmgmt/0/    | uuid                   | 3aa7c854-9667-e176-efe5-e487e520
faults/0            |                        | 7a8a 
/SP/faultmgmt/0/    | timestamp              | Dec 14 22:43:59 
faults/0            |                        |