DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

sysinfo(ADM)


sysinfo -- generate report on system configuration for diagnostic use

Syntax

/etc/sysinfo -bcdhortv [-f filename] [-m filename] [-s seconds] [-l length] [-- command_set [command_set ...]]

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. This script uses Open Source utilities sockinfo, ss, lsof, memhog, cpuhog, and iohog if they are available in /usr/local/bin.

sysinfo accepts the following options:


-b
generate both HTML and text reports.

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

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

-m filename
specify additional command file.

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

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

-t
generates a text report, by default in /usr/adm/sysinfo.txt.

-h
generates an HTML report in the default document directory, /usr/lib/apache/htdocs/sysinfo.html for Apache or /usr/internet/ns_httpd/docs/sysinfo.html for Netscape if either of these exist, otherwise, it is placed in /usr/adm/sysinfo.html.

-c
archives the live system dump and generated report in a tar(C) file named /usr/adm/systemname.timestamp.tar.

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

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

command_set
Command sets allow for reports created for specific issues. The following built-in command 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.osr5. These command sets are included:

print
printer configuration

tta
Tarantella information

afps
Advanced File and Print Server information

vdm
Virtual Disk Manager information

misc
Other miscellaneous information
A special command set, /usr/lib/sysinfo.d/sysinfo.data, will be executed every time if it exists.
A report summary shows commands that failed with a non-zero exit status.

Examples

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

Limitations

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

Open Source utilities must be located in /usr/local/bin.

See also

sysdump(ADM), uname(C), brand(ADM), swconfig(ADM), hwconfig(C), memsize(ADM), hw(ADM), ulimit(C), swap(ADM), df(C), lpstat(C), arp(ADMN), netconfig(ADM), ifconfig(ADMN), netstat(TC), ndstat(ADM), rpcinfo(NADM), showmount(NADM), ypwhich(NADM), ipcs(ADM), sysdef(ADM), ps(C), sar(ADM), who(C), finger(C)
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003