sysinfo(1M)

sysinfo -- generate report on system configuration for diagnostic use

Synopsis

/etc/sysinfo [-b | -h | -t] [-cdr] [-f filename] [-l lines] [-q | -v] [-s seconds] [command_list]

Description

The sysinfo command gathers information about system configuration, setup, and usage, and builds a report to help diagnose system problems. sysinfo executes a series of UNIX commands and incorporates their statistical output.

The report can be generated in either HTML or Text formats and provides an execution summary, listing any commands that fail or timeout. The sysinfo command creates a system information report, scanning either the entire system or specific subsystems as directed by the optional command_list. You can also use sysinfo to create a live system dump, and can specify any executable as part of command_list.

The default behavior with no options is to create an HTML report in /var/adm/sysinfo.html. The command does not return any output to the screen unless -q or -v are specified.

Options

The available options are:

-b: Create both html and text reports.
-h: Create an html report only (default).
-t: Create a text report only.
-c: Creates a report and archives the new report (plus any previous reports found in the report directory) in a tar(1) file, /var/adm/system.timestamp.tar. If specified with -d, a live system dump is also taken and archived in the tar file.
-d: Create and archive a live system dump in /var/adm/system.timestamp.live-dump.tar.
-r: Link the new HTML report to any previous reports found in the report directory.
-f filename: Specify different report pathname or filename (default is /var/adm//sysinfo.html); if relative path is given, it is evaluated relative to the current working directory of the invoking process.
-l lines: Sets the maximum length of command/log listings (default is 200 lines; maximum is 999 lines).
-q: Quiet - display minimal progress indicators.
-v: Verbose - display each UNIX command as it is executed.
-s seconds: Sets the timeout for individual commands (default is 30 seconds; maximum is 60 seconds).

Option defaults can be changed in the file /usr/lib/sysinfo.d/lib/sysinfo.conf (with the exception of the file names used for the -c and -d options).

Commands

The provided commands for command_list are:

basic: basic configuration information
defaults: system defaults
hw: hardware configuration
mail: sendmail configuration
misc: miscellaneous information
net: networking configuration and statistics
nfs: NFS and NIS statistics
perf: performance statistics
ppp: Point-to-Point (PPP) protocol statistics
print: printer configuration
uucp: serial and UUCP configuration
vfs: filesystem information and statistics

The following commands work only if the indicated product is installed:

afps: Advanced File and Print Server (AFPS)
lkp: Linux Kernel Personality (LKP)
nsc: NonStop Clustering (NSC)
odm: Online Data Manager (ODM)
tta: Tarantella
vas: SCO Authentication

A report summary shows commands that failed with a non-zero exit status.

Examples

To generate an HTML report named /var/adm/status.html, generate alive system dump, and watch as each command is executed:

   sysinfo -dvf /var/adm/status.html

To generate an HTML report specific to networking and performance:

   sysinfo -v net perf

To generate a report for a PPP configuration problem:

   sysinfo -v net ppp uucp

To generate a text report called current.txt in /home/admin/reports :

   sysinfo -tf /home/admin/reports/current

If you have a slow system or if some commands are taking more than 30 seconds to complete, extend the timeout to one minute:

   sysinfo -s 60