                        IMPORTANT INFORMATION
 
    Copyright(C)1996-1999, Sun Microsystems, Inc. ALL RIGHTS RESERVED.
 
    SUN ENTERPRISE EXPLORER IS DESIGNED FOR INTERNAL USE BY SUN
    MICROSYSTEMS, INC. ("SUN"). IT MAY BE USED BY OTHERS ONLY WITH SUN'S
    EXPRESS WRITTEN APPROVAL AND THEN ONLY SUBJECT TO THE FOLLOWING: THIS
    PRODUCT IS PROVIDED "AS IS" AND "WITH ALL FAULTS"; ANY USER USES THIS
    PRODUCT AT ITS OWN RISK AND BEARS SOLE RESPONSIBILITY FOR THE RESULTS
    OF ANY SUCH USE; SUN DISCLAIMS AND USER WAIVES ANY AND ALL EXPRESS
    CONDITIONS, REPRESENTATIONS, OR WARRANTIES, AS WELL AS ANY AND ALL
    IMPLIED WARRANTIES INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
    WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A
    PARTICULAR PURPOSE.
NAME
    explorer - is a tool that gathers extensive system information, a
    complete list is provided at the end of this man page. Explorer can
    be executed in interactive or batch mode. The explorer output can be
    automatically e-mailed to the explorer-database (see the -mail option
    issues/problems related to e-mailing to SUN)

SYNOPSIS

    explorer
    explorer [-nofile | -file file_name] [-mail | -myemail email_address]
	      [-keep | -keepdata]
    explorer -E10000_return_fru | -e10000_return_fru
    explorer [-v | -help]

OUTPUT TAR FILES
    At the conclusion of each run explorer generates tar files containing
    the system configuration information. Two tar files are generated:
   	 1. xxx.uu  (tar,gzip,uuencode format)
	 2. xxx.Z   (tar, compress format)

    Un-taring the above tar files will generate an explorer output directory
    containing the gathered information. Each output directory contains a
    README file explaining in detail what the output means. The output
    directory naming convention is (yyyy.mm.dd.HH.MM = date and time
    explorer was executed):
        explorer.hostid.hostname-yyyy.mm.dd.HH.MM

DESCRIPTION

Interactive mode
    With no arguments explorer will prompt for manual input of user name,
    customer name etc.

-E10000_return_fru
    USE THIS OPTION ONLY WHEN RETURNING A E10000 FAILING FRU, and ONLY
    ON THE System Service Processor (SSP).

    This option will generate an electronic version of the "E10000 failure
    information form". It forces interactive mode, and you must answer a few
    questions. Explorer will guide you through the "return FRU" process.
    When returning a FRU, you should also execute explorer on each domain
    (without this switch). You need to e-mail all explorer outputs to:

    explorer-database@sun.com

    Note: this option should only be used on the SSP when returning a failing
    	  E10000 FRU. For all other cases, including escalations, run explorer
	  on the SSP like you would on any other system.

-file file_name
    Batch mode. User name, customer name etc. will be read from file_name,
    see the provided explorer.template file for an example.
    Note: file_name must follow the -file option, it can be a fully
    qualified or relative path. file_name must be a valid and readable file,
    else explorer will fail. For automatic e-mail of explorer output to the
    explorer database see the -mail option.
    Note: -file and -nofile are mutually exclusive.

-help
    Display this information.

-keep
    Don't de-install explorer at the conclusion of the run. However, all
    explorer output data will be deleted. This option is useful for
    batch/cron executions in combination with -mail or -myemail options.
    Note: -keep and -keepdata are mutually exclusive, i.e. choose one or
    the other.

-keepdata
    Don't de-install explorer at the conclusion of the run and keep
    the .Z output file. Useful when explorer is executed in batch/cron
    and the output is collected locally or on a centrally exported
    file system.
    Note: -keep and -keepdata are mutually exclusive, i.e. choose one or
    the other.

-nofile
    Batch mode. Information about user name, customer name etc. will not
    be provided. This is useful for systems that use explorer regularly and
    this information is readily available. The output file can be matched
    to the customer using hostid.
    Note: -file and -nofile are mutually exclusive.

-mail
    Can be used to automatically e-mail explorer output to:
         explorer-database@sun.com
    If -mail is not specified, e-mail will not be generated.

    Note: E-mail issue - IP Resolvable Return Addresses (The following
    workaround is NOT supported.)

    All e-mail directed to SUN is reverse address checked. If the sender's
    return address is not a valid, 'reachable' address, the mail is rejected. 
    The system/mail administrator at the customer site needs to modify the
    domain definition (return address), to match their named, IP routed e-mail
    address, or verify/allow the resolution and acceptance of the suspected
    return addressee back through the senders firewall. In essence, the valid,
    complete, return address recipient would be able to receive e-mail from
    outside your company firewall.
     
     Examples for invalid 'From:' addresses:
      
      root@hostname.sun.sun.com <- unreachable outside firewall
		  root@hostname <- incomplete address

-myemail email_address
    Automatically e-mail explorer output to email_address of your choice.
    Note: -mail and -myemail are mutually exclusive. The file mailed
    is tar;gzip;uuencode.

-v
    Display explorer revision level.


REQUIREMENTS
    explorer requires root privileges to run.

    root needs write privileges to the current directory.

    explorer works only on Solaris 2.x systems and has only been tested
    on SPARC architecture.

SUPPORTED HARDWARE AND OPERATING SYSTEMS
    The following hardware has been tested: sun4m, sun4d, sun4u,
    sun4u1 (starfire) & System Service Processor (ssp), SC6400

    Solaris 2.3, 2.4, 2.5, 2.5.1, 2.6, 2.7

MORE INFORMATION
    For additional information on explorer, how to get the latest
    version, access the explorer-database and more see:
        http://explorer-www.corp

WHAT DOES EXPLORER COLLECT
    This program collects extensive system information on disks (Vendor,
    Product, Rev, and Serial Number), SSA, VM, SDS, general HW
    configuration, patches and packages installed, error messages, and
    more.

    The following is the content of the README file. At the conclusion
    of each run explorer generates a tarfile containing the system
    configuration information. Each tarfile also contains this README
    file explaining the output and how it was generated.

    Explorer's output is organized into sub-directories as follows:


Detailed configuration information
==================================

The following directories contain detailed system information:
-------------------------------------------------------------

cluster - this directory will exist if SunCluster or HA is present.

	The following directories are cp -Rp of the corresponding cluster
	and HA directories from /etc/opt and /var/opt, if present.

	etc_opt_SUNWhadf
	var_opt_SUNWhadf
	etc_opt_SUNWcluster
	var_opt_SUNWcluster
	var_opt_oracle
	var_opt_sybase


disks - a directory containing disk related information, eg: SDS, Sonoma,
        SSA, VM, etc.

        dev-lL.out  - output from: 
			find /dev -type d -print | xargs ls -lL
			major/minor#'s of everything under /dev

	df-k.out - output from df -k
	df-a.out - output from df -a
	df-e.out - output from df -e
	df-g.out - output from df -g

        diskinfo - lists disks info: Vendor, Product, Rev, and Serial Number.
		   Note: for Sonoma only LUN information is provided,
		         eg: c1t4d1 <SYMBIOS-RSMArray6000-0204 ... 
			 To get Vendor, Prod, Rev, etc. information
			 for Sonoma see disks/sonoma/drivutil-i/...

        format.out - output from format. May be empty if format hangs for
                        some reason.

        ls-l_dev_rdsk.out - output from:
				ls -l /dev/rdsk
	ls-ld_tmp.out     - output from:
				ls -ld /tmp
        maj_min_dev#.out  - output from:
				ls -lL /dev/*dsk/*
        			list major/minor numbers under /dev/(r)dsk

	swap-l.out - output from swap -l
	swap-s.out - output from swap -s

disks/photon - a directory containing information needed for Photon support:

	ls-l_dev.es - output from ls -l /dev/es
	luxadm_probe.out - output from luxadm probe
	luxadm_probe-p.out - output from luxadm probe -p
	luxadm-v_fcal_s_download.out - output from luxadm -v fcal_s_download
	    Note: 1) fcal_s_download will be executed only if the system is in
		     single-user mode.
		  2) You can always get the socal's FCode version as follows:

	sed -n -e '/device_type:.*socal/,/name:.*SUNW,socal/p' prtconf-vp.out
	Where: prtconf-vp.out is located in the sysconfig dir. Sample output:
	       
		device_type:  'socal'
		version: '@(#) FCode 1.11 97/12/07'
		manufacturer:  'SUNW'
		model:  '501-3060'


	boxnames - a directory containing a series of sub-directories
		with outputs from luxadm for each photon. Each
		sub-directory is named after its SENA.

	       each sub-directory contains output from:

	       luxadm_display.out   - luxadm  display SENA_name
	       luxadm-v_display.out - luxadm -v display SENA_name
	       luxadm_display-r.out - luxadm display -r SENA_name
	       luxadm_-e_dump_map.out - luxadm -e dump_map SENA_name

	       Note: for backward compatibility with pre explorer
	       3.0.1, the older sesN name is now a symbolic link to
	       SENA_name, e.g.
	       ses0 -> boxnames/SENA_name

disks/prtvtoc - a directory containing prtvtoc output files.
	
	cNtNdNsN - print volume table of contents, partition
		information, for each disk as reported by
		prtvtoc /dev/rdsk/cNtNdNsN. It will create one file per
		disk, where file_name=disk_name, eg: c0t1d0s0.

		NOTE: prtvtoc output will not be available for unlabeled
		or reserved disks.

disks/sds  - a directory containing Solstice Disk Suite information:
	     
	metastat.out 		   - output from metastat
	metastat-p.out 		   - output from metastat -p
	metadb.out   		   - output from metadb
	metaset.DISKSETNAME.out    - output from metaset -s disksetname
	metastat.DISKSETNAME.out   - output from metastat -s disksetname
	metastat.DISKSETNAME-p.out - output from metastat -s disksetname -p
	metadb.DISKSETNAME.out     - output from metadb -s disksetname

	NOTE: i) The first two outputs are for SDS's local disks. Output for
	         disk sets (metaset metastat metadb) if the system is
		 configured with one or more sets.

	     ii) If the system doesn't own the diskset, then
	         the xxxx.DISKSETNAME.out files will contain the
		 following message:
		 "...must be owner of the set for this command"

disks/sonoma - a directory containing information needed for Sonoma support:
 
        nvutil-v - a directory containing output from
                /usr/sbin/osa/nvutil -v cntrl, list NVRAM settings for
                controller specified by -c, one file per controller.
                eg:
                # nvutil -v c1t1d0s0 > disks/sonoma/nvutil-v/c1t1d0s0

        raidutil-i - a directory containing output from
                /usr/sbin/osa/raidutil -c cntrl -i, listing information on
                the software and firmware revision level and date for the
                given controller specified by -c, one file per controller.
                eg:
                # raidutil -c c1t1d0s0 -i > disks/sonoma/raidutil-i/c1t1d0s0

        raidutil-V - a directory containing output from
                /usr/sbin/osa/raidutil -c cntrl -V 0, listing information
                on the values in the Caching mode page (08). -V 0 would
                display page 08 of LUN 0 for the device given by the -c
                parameter. One file per controller is generated.
                eg:
                # raidutil -c c1t1d0s0 -V 0 > disks/sonoma/raidutil-V/c1t1d0s0

        rdacutil-i - a directory containing information about the redundant
                controller configuration, output from
                /usr/sbin/osa/rdacutil -i command.  One file per Sonoma
                unit installed, where:
                file_name=raid_module_specifier

        drivutil-I - a directory containing drive group information. Output
                from /usr/sbin/osa/drivutil -I command. One file
                per Sonoma unit, where
                file_name=raid_module_specifier

        drivutil-i - a directory containing detailed disk information.
                Including: disk Location, Capacity, Status, Vendor,
                Product ID, Firmware, and Serial Number. Sonoma's physical
                disks are not listed in the file 'disks/diskinfo'.
                For Sonoma, 'disks/diskinfo' contains LUN information, eg:
                c1t4d1 SYMBIOS  RSM Array 2000 ...
                Output from /usr/sbin/osa/drivutil -i command. One file per
                Sonoma unit, where
                file_name=raid_module_specifier

        drivutil-l - a directory containing LUN information. Output from
                /usr/sbin/osa/drivutil -l command. One file per Sonoma unit,
                where file_name=raid_module_specifier

        healthck-a.out - output from RAID healthck -a command.

        kernel_drv - a directory containing files copied from /kernel/drv
                rdnexus.conf - name, parent, instance configuration file.
                rdriver.conf - configuration file for Redundant Disk Array
                                Controller driver.
                sd.conf      - LUN entries configuration file.

        lad.out - output from RAID lad command.

        usr_lib_osa - a directory containing files copied from /usr/lib/osa
                rmparams - RAID Manager parameter file
                rmlog.log - RAID Manager log file
	
	ls-l_dev.osa.dev.dsk  - output from ls -l /dev/osa/dev/dsk
	ls-l_dev.osa.rdev.dsk - output from ls -l /dev/osa/dev/rdsk


disks/ssa - a directory containing SSA information:

        ssaadm.cN.out - for each SSA, perform "ssaadm  display". Where
                        N is the controller #.

	NOTE: if the disks are reserved, eg: Solstice HA, then
		the files will contain "...Close: I/O error",
		which is not an error.

	cN.disk_list - a series of directories, containing the output   
                        from "ssaadm display /dev/rdsk/cNtNdNs0". The
                        directories are organized by SSA controller #s,
			eg: c1.disk_list=SSA_CONT_c1. Each directory
			contains ssaadm display output for all the
			disks in that SSA, where file_name=disk_name.
                        So, if you want to find out which SSA drives have
			Fast Writes Enabled, you can do: 
                        % grep "Enabled" c*.disk_list/*

		NOTE: if the disks are reserved, eg: Solstice HA, then
			the files will contain "...Close: I/O error",
			which is not an error.

disks/vxvm - a directory containing Volume Manager information:

	disk_groups - a directory containing vxprint & vxdg outputs for each
			disk group (DG is the disk group name).
		
			vxdg-g_free=DG.out - output from vxdg -g DG free
			List free space that can be used  for allocating
			subdisks.

			vxdg_list=DG.out - output from vxdg list DG
			List the contents of DG and its configuration.

        		vxprint-vng=DG.out - output from vxprint -vng DG
			Lists the volumes for each disk group.

			vxprint-hmQqg_4vxmk=DG.out - output from:
			# vxprint -hmQqg DG vol1 vol2 ...
			Note: this file is vxmake ready. It doesn't
			include the dg and dm definitions.
			eg:
			    recreating VXVM configuration records
			    vxmake -g disk_group vxprint-hmQqg_4vxmk=DG.out

			vxprint-hmQqg=DG.out - output from:
			# vxprint -hmQqg DG
			Note: this file contains the dg and dm
			definitions and can be used to replay vxprint
			options if you have access to vxprint.
		      	eg:
			   vxprint -th -D - < vxprint-hmQqg=DG.out
			   vxprint -f  -D - < vxprint-hmQqg=DG.out
				    
	vxdisk-list.out - output of vxdisk list
	vxdg-q-list.out - output of vxdg -q list
	vxprint-h.out   - output of vxprint -h
	vxprint-th.out  - output of vxprint -th

etc - a directory containing some files copied, with -p, from /etc :
      Note: some of these file will be present only in certain configurations.

	auto_master
	defaultdomain
	defaultrouter
	dfs/dfstab
	dfs/sharetab
	default/init
	ethers
	hostname.* - can be multiple files
	hosts
	inetd.conf
	inittab
	mnttab
	name_to_major
	nodename
	notrouter - if file exists
	nsswitch.conf
	path_to_inst
	rpc
	release - present for some OS only, eg: Solaris 2.5.1 HW4/97
	resolv.conf - DNS only
	services
	ssphostname - on E10000 systems only. Contains the SSP's hostname
	syslog.conf
	system
	vfstab

	etc/inet - directory containing files compied from /etc/inet
		netmasks
		networks

	etc/init.d - directory containing files compied from /etc/init.d
		sysetup - useful to see if savecore is enabled in
			  Solaris 2.3-2.6 systems. For 2.7 and up see
			  dumpadm.out.

input_file - this file will exist only if explorer is executed in batch mode,
	i.e. -file or -nofile options. If the file is empty than -nofile
	was selected. For -file input_file will include customer's
	account information.

messages - a directory containing error messages files copied from:
	   /var/adm/messages*

netinfo - a directory containing some networking information:
	arp-a.out     - output from arp -a
	netstat-a.out - output from netstat -a
	netstat-an.out- output from netstat -an
	netstat-i.out - output from netstat -i
	netstat-k.out - output from netstat -k
	netstat-m.out - output from netstat -m
	netstat-p.out - output from netstat -p
	netstat-pn.out- output from netstat -pn
	netstat-r.out - output from netstat -r
	netstat-rn.out- output from netstat -rn
	netstat-s.out - output from netstat -s
	nfsstat.out   - output from nfsstat
	nisshowcache-v.out - output from /usr/lib/nis/nisshowcache -v
	rpcinfo.out   - output from rpcinfo
	rpcinfo-m.out - output from rpcinfo -m
	firewall-1_fw_ver.out - FireWall-1 version, present if
				FireWall-1 is installed. output from:
				/etc/fw/bin/fw ver

patch+pkg - a directory containing patch and package listings installed on
	    the system:

        patch-list    - patch listing summary.
        patch_date    - date each patch was installed, ls -l /var/sadm/patch.
        pkginfo-i.out - list fully installed pkgs.
        pkginfo-l.out - long listing output.
        pkginfo-p.out - list partially installed pkgs.
        showrev.out   - output from "showrev".
        showrev-p.out - output from "showrev -p".
	modinfo.out   - loaded kernel module listings

rev - this file contains explorer rev level used to generate this output.

ssp - this directory will exist ONLY when explorer is executed on a System
      Service Processor for starfire:

	The following files were copies from: /var/opt/SUNWssp/.ssp_private
		cb_config
		domain_config
		ssp_resource
		ssp_to_domain_hosts
        sys_id-d.domain - this directory contains files resulting from
			  the command sys_id -d; where: file_name = domain_name
                          This will facilitate association of SSP output
                          with each explorer run on the different domains.
                          In each domain's file (in the dir sys_id-d.domain),
			  look for the following two fields:
			      Machine Type = 0x80
			      Serial number (machine ID) = 0xa65005
                          Using the above information the domain's hostid is:
			  80a65005, i.e. 'Machine Type' (80) followed
			  by 'Serial number' (a65005).
			  Note: only one domain has a hostid which begins
			  with 80a65XXX, this is the primary domain.
			  All other domains will have a hostid in the 80a66XXX
			  range (eg: 80a66011).
	SUNWssp-adm - this is a directory resulted from:
			cp -Rp /var/opt/SUNWssp/adm ssp/SUNWssp-adm

sysconfig - a directory containing system HW configuration:
	dumpadm.out      - output from dumpadm, Solaris 2.7 and up, current
			    dump  configuration.
	eeprom.out       - output from eeprom
        ifconfig-a.out   - output from ifconfig -a
	kernel_ls-l.out  - output from ls -l /platform/`arch -k`/kernel
					(Solaris 2.5 and higher)
				OR  ls -l /kernel (Solaris 2.3, 2.4)
        prtconf-v.out    - output from prtconf -v
        prtconf-vp.out   - output from prtconf -vp
        prtconf-V.out    - output from prtconf -V (Solaris 2.5 and higher)
        prtdiag-v.out    - output from prtdiag -v (if applicable)
        psrinfo-v.out    - output from psrinfo -v
        sysdef-d.out     - output from sysdef -d
        sysdef.out       - output from sysdef
        uptime.out       - output from uptime

u4ft - a directory containing FT1800 diagnostic information

	all-device-states - list states of all devices according to FT
		framework. This file is generated by:
		u4ftctl find / | while read cookie;do
		   path=`u4ftctl get_path $cookie`
		   state=`u4ftctl get_state $cookie`
		   echo "$cookie $state $path"
		done > u4ft/all-device-states.u4ftctl

	fru_eeproms - a directory containing eeprom data. One file per location,
	    	      generated by:
		for LOCATION in \
		A-MBD B-MBD A-CPU B-CPU A-CAF B-CAF \
		A-PCI0 A-PCI1 A-PCI2 A-PCI3 A-PCI4 A-PCI5 A-PCI6 A-PCI7 \
		B-PCI0 B-PCI1 B-PCI2 B-PCI3 B-PCI4 B-PCI5 B-PCI6 B-PCI7 \
		A-RMM B-RMM A-DSK B-DSK \
		A-PSU0 A-PSU1 A-PSU2 B-PSU0 B-PSU1 B-PSU2
		do
		    cmsfruinfo -i -l $LOCATION EE_EEPROM 1> \
		        u4ft/fru_eeproms/$LOCATION 2>&1
		done

	debug - output from cat /dev/u4ftlog:debug,nodelay
	etc_SUNWcms_.config - a directory containing the content of:
				/etc/SUNWcms/.config
	nvlog - output from cat /dev/u4ftlog:nvlog,nodelay
	var_SUNWlogu - a directory containing the content of: /var/SUNWlogu

var - a directory containing some information from /var:
	INST_RELEASE - output from cp -p /var/sadm/softinfo/INST_RELEASE
	sadm-ld.out  - output from ls -ld /var/sadm, i.e. is it symbolic link
	yp_binding_ls-l.out - output from ls -l /var/yp/binding
