Gathering diagnostic data for Sun SPARC Enterprise[TM] Mx000 (OPL) Servers

Asset ID:	1-71-1008229.1
Update Date:	2011-03-30
Keywords:

Solution Type Technical Instruction Sure

Solution 1008229.1 : Gathering diagnostic data for Sun SPARC Enterprise[TM] Mx000 (OPL) Servers

Applies to:

Sun SPARC Enterprise M3000 Server - Version: Not Applicable and later    [Release: N/A and later]
Sun SPARC Enterprise M4000 Server - Version: Not Applicable and later    [Release: N/A and later]
Sun SPARC Enterprise M9000-64 Server - Version: Not Applicable and later    [Release: N/A and later]
Sun SPARC Enterprise M5000 Server - Version: Not Applicable and later    [Release: N/A 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.

To discuss this information further with Oracle experts and industry peers, we encourage you to review, join or start a discussion in the My Oracle Support Community - M Series Servers

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 [email protected]:/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 from here "Oracle Services Tools Bundle".

Summary of the steps to get explorer running

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.
As root on the explorer host ./explorer -w xscfextended,default.
When prompted ; Supply the IP address of the xscf.
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.
   [email protected]'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 [email protected]:/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 [email protected]:

   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 [email protected]...
   Collecting data into [email protected]:/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:

   # chmod 1777 /opt/SUNWexplo/tmp
   # 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

Additionally /opt/SUNWexplo/doc/README has much of this same info in the xscf section of the file.

explorer, xscfextended, OPL
Previously Published As @ 89403

Attachments

This solution has no attachment