Solaris Troubleshooting X86 : ipmitool usage for diagnosis

Here we discuss about  how to use ‘ipmitool’ to collect information on platform events, sensors, status LEDs, and hardware components, from the Service Processor (SP). It also covers the use of ipmitool for platform startup & shutdown, and SP reconfiguration.


Usage and examples

Some examples of ipmitool commands for performing common tasks are given below. For more detailed usage information, see the ipmitool man page, and documentation included with the package. Not all ipmitool functionality is available across all server platforms,  refer to the service processor documentation for your server if something is not working as expected.

BMC and network interfaces

ipmitool can access the Service Processor (SP) of the local host via the in-band (internal) Base Management Controller (BMC) interface. For example, to display the status of the local chassis:


ipmitool -I <interface> chassis status


Where <interface> is bmc on Solaris systems, open on Linux systems, and ms on Windows 2003Server R2 Enterprise systems. To access the SP via network, specify lan as the interface name, along with the IP address or resolvable hostname of the SP, and valid username (for which you will be prompted to enter the password).



ipmitool -I lan -H <SP IP address> -U root chassis status


While most of the examples in this document use the lan interface, the commands will also work using the local BMC interface.

Collecting configuration, status and event log information

Useful commands for checking the state and health of a system. Provide output from these commands to Sun Oracle support when raising a service ticket.

  • View the System Event Log (SEL):
    ipmitool -I lan -H <SP IP> -U root sel elist
    ipmitool -I lan -H <SP IP> -U root -v sel elist
  • Display hardware FRU component information:
    ipmitool -I lan -H <SP IP> -U root fru print
  • Display system sensors, status LEDs and chassis information:
    ipmitool -I lan -H <SP IP> -U root sensor list
    ipmitool -I lan -H <SP IP> -U root sunoem led get
  • ipmitool -I lan -H <SP IP> -U root sunoem sbled get all
    ipmitool -I lan -H <SP IP> -U root sdr list all info
    ipmitool -I lan -H <SP IP> -U root chassis status
    ipmitool -I lan -H <SP IP> -U root chassis restart_cause
  • Display details of active faults present on the system: (not available on some platforms)
    ipmitool -I lan -H <SP IP> -U root sunoem cli “show -o table -level all /SP/faultmgmt”
  • Print ILOM / ELOM version:
    ipmitool -I lan -H <SP IP> -U root sunoem cli “version”

ILOM Snapshot automates the collection of ipmitool command outputs and other information from the platform needed by Sun Oracle support to troubleshoot system problems. Where possible, provide an ILOM snapshot when opening a support ticket for server problems.


Platform management and control

  • Power control:
    ipmitool -I lan -H <SP IP> -U root chassis power on
    ipmitool -I lan -H <SP IP> -U root chassis power off
    ipmitool -I lan -H <SP IP> -U root chassis power reset
  • Set boot target for the next system boot:
    ipmitool -I lan -H <SP IP> -U root chassis bootdev bios
    ipmitool -I lan -H <SP IP> -U root chassis bootdev cdrom
    ipmitool -I lan -H <SP IP> -U root chassis bootdev diag
    ipmitool -I lan -H <SP IP> -U root chassis bootdev pxe
  • Reset the Service Processor: (does not affect the platform OS)
    ipmitool -I lan -H <SP IP> -U root bmc reset cold
  • Send diagnostic NMI:
    ipmitool -I lan -H <SP IP> -U root chassis power diag

Configuring the service processor

  • Configure the SP with a static IP address and other network details:
    ipmitool -I <interface> set 1 ipsrc static
    ipmitool -I <interface> set 1 ipaddr 192.168.10.10
    ipmitool -I <interface> set 1 netmask 255.255.255.0
    ipmitool -I <interface> set 1 defgw ipaddr 192.168.10.254

Where <interface> is bmc on Solaris, open on Linux systems, and  ms on Windows 2003 Server R2 Enterprise systems.

  • Add a new user named ‘john’ to the SP

List existing SP users and user ID numbers:
ipmitool -I lan -H <SP IP> -U root user list

ID Name Callin Link Auth IPMI Msg Channel Priv Limit 1 false false true NO ACCESS 2 root false false true ADMINISTRATOR

Add john’s username to the SP, assigning it an unused ID number (3 in this example):
ipmitool -I lan -H <SP IP> -U root user set name 3 john

Assign the password ‘fandango‘ to john’s user ID:
ipmitool -I lan -H <SP IP> -U root user set password 3 fandango

Enable the account
ipmitool -I lan -H <SP IP> -U root user enable 3

Assign administrator privileges to john:
ipmitool -I lan -H <SP IP> -U root channel setaccess 1 3 privilege=4
(To list all available privileges run: ipmitool channel )

    • The new SP account should now be active.

Unexpected output

Output similar to the following indicates ipmitool was not able to decode data received from the SP:

Sun OEM Get LED command failed: Parameter out of range
Sun OEM Get LED command failed: Destination unavailable



Ramdev

Ramdev

I have started unixadminschool.com ( aka gurkulindia.com) in 2009 as my own personal reference blog, and later sometime i have realized that my leanings might be helpful for other unixadmins if I manage my knowledge-base in more user friendly format. And the result is today's' unixadminschool.com. You can connect me at - https://www.linkedin.com/in/unixadminschool/

11 Responses

  1. Really informative blog post.Much thanks again. Great.

  2. Ramdev Ramdev says:

    Hi Aylin, Thanks for the Comment.

  3. microsence says:

    ipmitool -I lan -H -U root sunoem cli “version” 
    No output….
    above command is no working and below is my area of pain..

    bash-3.2# svcs hwmgmtd
    STATE          STIME    FMRI
    disabled       14:27:08 svc:/application/management/hwmgmtd:default

    i tried to restart or enable this service multiple times but it goes only disable or maintenance mode only.

  4. Ramdev Ramdev says:

    what does the service related log from /var/svc/log/  directory says?

  5. Bras says:

    Hello,

    Thanks for this article and all others.

    About this article, could you please indicate if CLI commands work for any version of ipmitool?
    Actually I don’t get all CLI commands woking for ipmitool 1.8.8 and less !

    Thanks

  6. ukash says:

    You actually make it appear so easy along with your presentation however I to find this matter to be really one thing that I think I would never understand. It sort of feels too complex and extremely broad for me. I’m looking forward in your next submit, I will attempt to get the cling of it!

  1. December 1, 2010

    […] […]

  2. March 2, 2012

    ukash…

    […]unix administration @ gurkulindia.com » Solaris Troubleshooting X86 : ipmitool usage for diagnosis[…]…

  3. September 16, 2015

    […] Read – ipmitool usage for diagnosis in Solaris X86 […]

  4. September 18, 2015

    […] Read – ipmitool usage for diagnosis in Solaris X86 […]

What is in your mind, about this post ? Leave a Reply

Close
  Our next learning article is ready, subscribe it in your email

What is your Learning Goal for Next Six Months ? Talk to us