Applies to:

Sun SPARC Enterprise M3000 Server

Sun SPARC Enterprise M4000 Server
Sun SPARC Enterprise M9000-32 Server - Version: Not Applicable and later    [Release:
NA and later]
Sun SPARC Enterprise M9000-64 Server - Version: Not Applicable and later    [Release:
NA and later]
All Platforms
Goal
This doc describes the various ways to gather diagnostic data from either the XSCF or the
domain and XSCF combined.
Solution
Running snapshot on Sun SPARC Enterprise Mx000 (OPL) XSCF
Snapshot stores the collected data on a remote network  host or on  an  external media device,
based upon the use of the -t or -d option. To store the collected data on a remote network  host 
using  the -t option, you must specify a host name (or IP address), a target directory on the
remote  network host,  and the user name of a user on the remote host.  When storing  data on a
remote network host, snapshot opens a network connection using SSH to act as a data pipe to the
remote file.
Example of running snapshot to a remote host:
   XSCF> snapshot -L F -t <username>@<hostname or IP address>:<location to write to>
   XSCF> snapshot -L F -t joe@jupiter.west:/home/joe/logs/x

Example of running snapshot to a USB device:

   XSCF> snapshot -L F -d usb0 -r
   Note: The -r flag will remove all files from the USB device.

Running explorer on Sun SPARC Enterprise Mx000 (OPL) Servers

This example of explorer was done on a domain of a Sun SPARC Enterprise M8000 (DC1) It
gathers both the domain info and the xscf info, via ssh. The explorer host is the system that
explorer package is loaded on and runs the program.  So the domain is the explorer host for this
example.  You must have at least explorer version 5.8 for Mx000 machines.  Explorer may be
downloaded via http://www.sun.com/download Click on the Downloads A-Z and look in the 'E'
section for explorer.

Summary of the steps to get explorer running

1.  Find an existing (or create a new) user login on the xscf.

2.  Make sure this xscf user login has platadm privileges.
3.  As root on explorer host, ssh into xscf once to establish known_hosts entry.
4.  Copy/paste /etc/ssh/ssh_host_dsa_key.pub contents from the explorer host.
5.  On the xscf as the user login for explorer, setssh -c addpubkey (paste in key).
6.  Setup archiving from the xscf to the explorer host (setarchiving).
7.  On the xscf as the user login for explorer, test connectivity via snapshot -T.
8.  As root on the explorer host ./explorer -w xscfextended,default.
9.  When prompted ; Supply the IP address of the xscf.
10.  When prompted ; Supply the user login on the xscf.

Now that you've seen the basic steps listed, but before we dive into the details, here is a brief
description of snapshot and log archiving.  Snapshot is a command on the xscf that gathers all the
xscf error logs etc. and copies them to a user specified location. This can be a USB drive plugged
into the xscf USB port, or a user specified path.

Log archiving on the xscf allows the xscf to periodically copy all it's logs to a specified location.
Log archiving is setup on the xscf via the setarchiving command.

The detailed steps follow:

1. Add a user for explorer.  On the xscf there needs to be a user that has platadm privileges.  As
explorer runs, it will prompt you for this user (i.e. 'Remote username:').

   XSCF> adduser explorer

   XSCF> setprivileges explorer platadm
   XSCF> password explorer
   New XSCF password:
   Retype new XSCF password:

2.  Verify user was added and the correct permissions were applied.
   XSCF> showuser explorer
   User Name: explorer
   UID: 100
   Status: Enabled
   Minimum: 0
   Maximum: 99999
   Warning: 7
   Inactive: -1
   Last Change: Dec 04, 2008
   Password Expires: Never
   Password Inactive: Never
   Account Expires: Never
   Privileges: platadm

3. As root on the explorer host, you must manually ssh into the xscf one time to establish the
known_hosts entry (on the explorer host) for the xscf. 
   Note: below you must answer yes the first time you ssh into the xscf.
   # ssh -l explorer 10.4.145.76
   The authenticity of host '10.4.145.76 (10.4.145.76)' can't be established.
   RSA key fingerprint is 80:c0:74:eb:4d:89:5b:b0:f0:ee:7b:44:72:2f:43:b8.
   Are you sure you want to continue connecting (yes/no)? yes
   Warning: Permanently added '10.4.145.76' (RSA) to the list of known hosts.
   explorer@10.4.145.76's password:
   Last login: Thu May  3 15:37:41 2007 from sr1-unwk-02.sfbay.sun.com
   XSCF>

 
4. Copy/paste the /etc/ssh/ssh_host_dsa_key.pub contents from the explorer host to the XSCF.
    On the xscf, paste in the key as shown below.
   Don't forget to hit a carriage return, followed by a control-d !

   NOTE: You must be logged into the xscf as the same user that will be used by explorer.

XSCF> setssh -c addpubkey

   Please input a public key:
   ssh-dss AAAAB3NzaC1kc3MAAACBAILP6i1v7rBPc57vTdzfvwQcDJ/qpUcRgZG6i5QvIvBhCQ6U
   MeAdyDlCMXsXNgOWKmNLgbM0wLsHrcXuxzYxSwv4ArzuK8gh23t3XT5PsKeIvSvQFWieArWcW4Fc
   EGYMs3JwwCjwFLeIpdKW5HoJa78uH5mHFuWv7EJdA73iNHAAAAFQDD/fmQPy3TdHX0iEcm+XcVOi
   znQAAAIAuZHPrey2IbhiDIiEp5hB/09i7zW2j0peky2Q8WgMPrs7ABlX00L2p0/3wAm1KgNt87vF
   9ZAaj12ikV5/66s7EP9o2Yp5kfvEMLvisyUvRqbct5D7JRySLcTESG0JjunpcJcM6nfT1Sj4iG3q
   /85zbMEsP8GY86o2QJ7tbBQogAAAIA2CGJwSyGlkQVWkiozLzb/4QchEqtiJqXSrSXHRk8QW9ge
   KAsnsH+poT5J+j9PQx6XyTFjTLC2m+IGXDxaIDkTPwCNt2nAYP+5NJOjtj7eUTWLuD5WiruLN1k
   OQgiQbTLGrdVrXzSs0pMQY6ZM1JOPoHLS2vAyPvgAEYi8ZXVw==root@v4u-m8000a-dom00

[ctrl]-[d]

  5. Next, setup archiving from the xscf to the explorer host (domain 0 in this case).   IP address
of the explorer host is 10.4.145.8.  
   XSCF> setarchiving disable
   XSCF> setarchiving -k download -r -t rob@10.4.145.87:/usr/rob
   Fingerprint: 27:5e:08:5a:34:7c:3e:7b:45:d8:75:7a:43:21:8a:d2
   Accept this public key (yes/no)  yes
   Enter ssh password for rob@10.4.145.87:
   XSCF> setarchiving enable
   Testing the archiving configuration...
   Logs will be archived to 10.4.145.87

6. Test the connectivity via snapshot.

   NOTE: The '-T' Specifies executing snapshot in SSH target mode using the value for
user@host:directory previously set using setarchiving.
 
   As the xscf user login for explorer use:

   XSCF> snapshot -T
   Setting up ssh connection to rob@10.4.145.87...
   Collecting data into rob@10.4.145.87:/usr/rob/v4u-m8000a-xscf0_10.4.145.76_2007-05-04T22-26-13.zip
   Data collection complete
   XSCF>

7. Run explorer on the explorer host:

   # cd /opt/SUNWexplo/bin
   # ./explorer -w xscfextended,default
   May 03 06:56:02 v4u-m8000a-dom00[25803] explorer: explorer ID: explorer.809210d0.v4u-m8000a-dom00-
2007.05.03.13.56
   May 03 06:56:02 v4u-m8000a-dom00[25803] patch: RUNNING
   May 03 06:56:02 v4u-m8000a-dom00[25803] pkg: RUNNING
   May 03 06:56:22 v4u-m8000a-dom00[25803] sysconfig: RUNNING
........

8. You will be prompted for remote system information.

   Type return to end the list.

   Remote hostname or IP address: 10.4.145.76  (IP address of the xscf)
   Remote username: explorer
   Telnet password or blank to use SSH connection:  (Just hit return)

 9. In a few minutes (The xscfextended portion runs about 4 minutes) it will prompt you for the
next remote hostname or IP address.  If this is the only xscf you want to gather info on, just hit
return and the explorer will quickly finish.  The output is in: /opt/SUNWexplo/output/and the
xscf snapshot portion is in :
/opt/SUNWexplo/output/explorer.809210d0.v4u-m8000a-dom00-
2007.05.03.15.50/xscf/10.4.145.76/xscf/10.4.145.76.
   # ls
   snapshot.err
   snapshot.out
   v4u-m8000a-xscf0_10.4.145.76_2007-05-03T23-02-48.zip
Additionially /opt/SUNWexplo/doc/README has much of this same info in the xscf section of
the file.

Example in my system:
#Luxadm -e port
/devices/pci@1,700000/SUNW,emlxs@0,1/fp@0,0:devctl CONNECTED ( zone )
/devices/pci@2,600000/SUNW,emlxs@0/fp@0,0:devctl NOT CONNECTED ( un zone )

#fcinfo hba-port
HBA Port WWN: 10000000c986688d
OS Device Name: /dev/cfg/c2
Manufacturer: Emulex
Model: LPe11002-S
Firmware Version: 2.82a4 (Z3F2.82A4)
FCode/BIOS Version: Boot:5.02a1 Fcode:1.50a9
Serial Number: 0999BT0-09090007KT
Driver Name: emlxs
Driver Version: 2.50o (2010.01.08.09.45)
Type: N-port
State: online
Supported Speeds: 1Gb 2Gb 4Gb
Current Speed: 4Gb
Node WWN: 20000000c986688d
HBA Port WWN: 10000000c9a09c66
OS Device Name: /dev/cfg/c3
Manufacturer: Emulex
Model: LPe12002-S
Firmware Version: 1.11a5 (U3D1.11A5)
FCode/BIOS Version: Boot:5.03a0 Fcode:3.01a1
Serial Number: 0999BT0-10270002RW
Driver Name: emlxs
Driver Version: 2.50o (2010.01.08.09.45)
Type: N-port
State: online
Supported Speeds: 2Gb 4Gb 8Gb
Current Speed: 2Gb
Node WWN: 20000000c9a09c66