sysinfo(1M)

sysinfo -- generate report on system configuration for diagnostic use

Syntax

sysinfo [ -b | -t | -h ] [ -v | -q ] -ordckz [-f filename] [-m filename] [-s seconds] [-l length] [-- command_set [command_set ...]]

sysinfo configure

sysinfo template

sysinfo help

sysinfo version

Description

sysinfo 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.

sysinfo accepts the following options:

-b

generate both HTML and text reports.

-t

generate a text report

-h

generate an HTML report

-v

verbose option. Outputs specific command names to track progress of sysinfo execution.

-q

minimal progress indicator

-o

process additional command file or command set(s) only.

-r

recursively link HTML archives. Useful for running sysinfo through cron.

-d

creates a live system dump. Created as /var/adm/systemname.timestamp.live-dump.Z.

-c

combines the live system dump and generated report

-k

enable kernel profiling during the report

-z

compress output file

-f filename

specifies output report name. If no suffix is supplied, ".txt" or ".html" is appended automatically as appropriate. If no pathname is supplied, the file is created in the current working directory.

-m filename

specify additional command file.

-s seconds

specifies seconds before individual statistical commands time out. Default is 30 seconds; accepted range is 10-999.

-l length

length of file listings contained in the report. Default is 200 lines; accepted range is 10-999.

configure

menu interface to configure what information is reported.

template

creates template file that can be edited and used to build a report.

command_set

Command sets allow for reports created for specific issues. The following built-in sets are available:

basic: basic configuration information
net: networking configuration and statistics
nfs: NFS and NIS statistics
ppp: PPP configuration
hw: hardware configuration
perf: performance statistics
uucp: serial and UUCP configuration
mail: sendmail or MMDF configuration

Additionally, command sets can be created in /usr/lib/sysinfo.d/sets.uw714.

If the file exists, a special command set, /usr/lib/sysinfo.d/sysinfo.data, is executed each time.

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

Option defaults can be changed in the file /usr/lib/sysinfo.d/sysinfo.conf.

Examples

Most common syntax, to generate a full HTML report in /tmp:
sysinfo -vf /tmp/sysinfo.html

To generate an HTML report named status.html in /usr/local/apache/htdocs and generate a live, verbose dump:

sysinfo -dvf /usr/local/apache/htdocs/status

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, the timeout can be extended to a minute:

sysinfo -s 60

To execute a series of commands from a custom command script by itself:

sysinfo -vo -m my_scripts

Limitations

The default filenames for -c and -d options cannot be changed.