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:


