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. 2. 3. 4. 5. 6. 7. Find an existing (or create a new) user login on the xscf. Make sure this xscf user login has platadm privileges. As root on explorer host, ssh into xscf once to establish known_hosts entry. Copy/paste /etc/ssh/ssh_host_dsa_key.pub contents from the explorer host. On the xscf as the user login for explorer, setssh -c addpubkey (paste in key). Setup archiving from the xscf to the explorer host (setarchiving). 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+XcV Oi 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-2613.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-m8000adom00-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-dom002007.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 ) #fcinfohba-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