Sun Microsystems, Inc.  Sun System Handbook - ISO 3.4 June 2011 Internal/Partner Edition
   Home | Current Systems | Former STK Products | EOL Systems | Components | General Info | Search | Feedback

Asset ID: 1-71-1009290.1
Update Date:2010-11-01
Keywords:

Solution Type  Technical Instruction Sure

Solution  1009290.1 :   Obtaining FRU Data information from a Sun Fire[TM] v1280, E2900, 3800, 4800, 4810, 6800, E4900, E6900 or Netra 1280, 1290 Server  


Related Items
  • Sun Fire E6900 Server
  •  
  • Sun Fire 4810 Server
  •  
  • Sun Fire V1280 Server
  •  
  • Sun Fire 3800 Server
  •  
  • Sun Fire 6800 Server
  •  
  • Sun Fire E4900 Server
  •  
  • Sun Fire 4800 Server
  •  
  • Sun Fire E2900 Server
  •  
  • Sun Netra 1290 Server
  •  
  • Sun Netra 1280 Server
  •  
Related Categories
  • GCS>Sun Microsystems>Servers>Midrange Servers
  •  

PreviouslyPublishedAs
212860


Applies to:

Sun Fire 3800 Server
Sun Fire 4800 Server
Sun Fire 6800 Server
Sun Fire E4900 Server
Sun Fire E6900 Server
All Platforms

Goal

Service personnel may request FRU data information when troubleshooting server issues. This type of information contains the revision level, configuration and history of all the parts installed in a server. This document is intended to be a security and technical reference for anyone tasked with retrieving this type of data.
NOTE:  This document is applicable to the Sun Fire[TM] v1280, E2900, 3800, 4800, 4810, 6800, E4900, E6900 and Netra[TM] 1280, 1290 server family.

There are two procedures which can be used to obtain the FRU data:

  1. Oracle Explorer Data Collector.
         or
  2. The prtfru command utility.

We will cover the description and the use of both methods. The scope of this document is meant to cover only FRU data collection with these utilities.  If data collection is required for analysis of a system problem, see Document 1011830.1 for instructions on how to proceed.

Solution

Oracle Explorer Data Collector

Explorer is a common tool used to obtain all sorts of data from Sun systems. If properly run it will also obtain FRU data which may be requested by the services team. The latest Explorer packages can be downloaded from the Oracle Services Tools Bundle for Sun Systems web site. The website also contains detailed information as to how to install, run, obtain the data, among other information. See also Document 1002383.1 for information on the Oracle Explorer Data Collector.

  1. To obtain the FRU data with Explorer it is necessary to make certain that the machine which is going to collect the data is on the same private network as the system controller(s) to be polled.

    If the machine has been properly configured, it should have a loghost. This would be an ideal data collection machine. Alternately, if a loghost has not been configured it may be possible to run the explorer from any Solaris machine with Explorer packages installed residing on the same private network as the System Controller being polled.  Explorer's fru option cannot run unless the scextended option is also run and it will require the password for the console.

    Example:

    # ping 123.45.67.890
    123.45.67.890 is alive   <<< ping should be successful on the
    machine you wish to run explorer on.

  1. Run the Explorer (Document 1011830.1 provides recommended instructions). 
    If the default parameter is prefixed with  !  It will reduce the size of the collected explorer file and the run-time.  The use of  !default  prevents the explorer from capturing internal data from the loghost/domain while collecting scextended data. 

    If the explorer is being collected for extensive troubleshooting all data collection may be required and a parameter of  default  may be necessary without the  !  prefix.

  2. Example:

    # /opt/SUNWexplo/bin/explorer -w !default,scextended,fru
    Nov 28 10:48:07 hostname[7276] explorer: explorer ID:
    explorer.80fb1234.hostname-2009.11.28.16.48
    Nov 28 10:48:07 hostname[7276] patch: RUNNING
    Nov 28 10:48:08 hostname[7276] pkg: RUNNING
    Nov 28 10:48:19 hostname[7276] sysconfig: RUNNING
    Nov 28 10:50:21 hostname[7276] sysconfig: exited: AP not installed
    Nov 28 10:50:22 hostname[7276] fru: RUNNING
    Nov 28 10:50:24 hostname[7276] scextended: RUNNING

    You will be prompted for a System Controller name.   If the hostname
    cannot be resolved, you will have to  use the IP address.

    To avoid site specific network configuration issues, Oracle suggests
    using the I.P. Address instead of the hostname as shown below.


    Type return to end the list.
    Please enter the name of the SC: 123.45.67.890
    Please enter the SC platform password for 123.45.67.890: Password
    Please enter the name of the SC:
    Nov 28 11:26:37 hostname[7276] explorer: data collection complete
    Nov 28 11:26:40 hostname[7276] explorer: removing previous explorers
    from /opt/SUNWexplo/output
    Nov 28 11:26:41 hostname[7276] explorer: Explorer finished

  1. Explorer, when it is finished running will create a directory with all files created under it and a gzip compressed data file.

    # ls /opt/SUNWexplo/output
    explorer.80fb1234.hostname-2009.11.28.16.48
    explorer.80fb1234.hostname-2009.11.28.16.48.tar.gz <<<file to forward
  1. If you cd into the explorer directory tree there should be a prtfru_x.out file located in one of two locations.
    -  On Sun Fire[TM] 3800, 4800, 4810, 6800, E4900, E6900 it should be in /explorer_name/sc/sc_name_or_ip/prtfru_-x.out
    -  On Sun Fire[TM] v1280, E2900, n1280, and n1290 it should be in /explorer_file_name/fru/prtfru_-x.out

    Regardless of the system type, if this file exists (like in the examples below), the explorer run was successful:

    # ls /explorer.80fb2543.hostname-2004.09.28.16.48/sc/172.20.10.195
    prtfru_-x.err showcomponent_-d_a.out showdate_-v_-d_a.out
    prtfru_-x.out showcomponent_-d_b.out showdate_-v_-d_b.out
    ......

    The prtfru_-x.out file is the one we're interested in.
  1. If this file exists please forward the gzip'ed file in our example:

    explorer.80fb1234.hostname-2009.11.28.16.48.tar.gz

The prtfru Utility

Like Explorer, this utility should be run from a Solaris workstation located on the same private network as the System Controller (SC) to be polled.    The advantage to the utility is its ability to access FRU data from SCs without logging in to them.  The utility uses a Java Remote Method Invocation (RMI) in read-only mode to collect FRU information from a Sun Fire Midrange Server Service Processor.    The utility does not access or return any Solaris or any active process data on any configured domain.  This RMI interface is used by Sun specific products: Sun Management Center (SunMC) and Explorer (rprtfru) to securely gather data.

The following message in the example below may be displayed :

# ./prtfru_sg -b 123.45.67.890  <# ./prtfru_sg[42]: getopts: b bad option(s)

usage: prtfru_sg <SC> [<SC> ...]
       prtfru_sg -f <batchfile>

       <SC> Hostname or IP address of a Sun Fire SC
       <batchfile> File containing one <SC> per line
This error message will occur and is normal for this utility. 
It refers to an option not selected to create a batch file containing System Controller  IP address's.

The prtfru package is available for your use as an attachment to this article.

It is suggested that you utilize Explorer for capturing this data, but the package has been made available to you in this form if required/desired.

Example of prtfru utility in use

The untarred package will have the executable script in its the top level directory

# ls
sg_prtfru
<<< directory created from tar command
sg_prtfru.tar

# cd  sg_prtfru<<< directory created by tar command
# ls
java           
prtfru_sg  <<< Executable Script
bin      
lib

# ./prtfru_sg -b 123.45.67.890  <# ./prtfru_sg[42]: getopts: b bad option(s)

usage: prtfru_sg <SC> [<SC> ...]
       prtfru_sg -f <batchfile>

       <SC> Hostname or IP address of a Sun Fire SC
       <batchfile> File containing one <SC> per line
# ./prtfru_sg 123.45.67.890
Collecting data for 1 host:
  123.45.67.890
Contacting "123.45.67.890"...
Contacted "123.45.67.890" successfully
Collecting FRUID Data from "123.45.67.890".  (This may take several minutes)
FRUID Data Collection done.
********************************************
Refer to 123.45.67.890_result for the output.
********************************************

Checking the collected data.

# ls
java           
123.45.67.890_result  <<< file created by prtfru
bin                                  
lib
prtfru_sg
terminator#

Please send the  *_ result file to the engineer requesting the data.


Attachments
This solution has no attachment
  Copyright © 2011 Sun Microsystems, Inc.  All rights reserved.
 Feedback