generate report on system configuration for diagnostic use
/etc/sysinfo -bcdhortv [-f filename] [-m filename] [-s seconds] [-l length] [-- command_set [command_set ...]]
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:
generate both HTML and text reports.
recursively link HTML archives.
Useful for running sysinfo through cron.
process additional command file or command set(s) only.
specify additional command file.
verbose option. Outputs specific command names to track progress of
creates a live system dump. Created as
generates a text report, by default in /usr/adm/sysinfo.txt.
generates an HTML report in
the default document directory,
/usr/lib/apache/htdocs/sysinfo.html for Apache
/usr/internet/ns_httpd/docs/sysinfo.html for Netscape
if either of these exist, otherwise,
it is placed in /usr/adm/sysinfo.html.
archives the live system dump and generated report in a
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.
specifies seconds before individual statistical commands time out.
Default is 30 seconds; accepted range is 10-999.
length of file listings contained in the report.
Default is 200 lines; accepted range is 10-999.
menu interface to configure what information is reported.
creates template file /usr/lib/sysinfo.d/lib/template,
that can be edited and used to build a report.
Command sets allow for reports created for specific issues.
The following built-in sets are available:
Additionally, command sets can be created in
These command sets are included:
basic configuration information
networking configuration and statistics
NFS and NIS statistics
serial and UUCP configuration
sendmail or MMDF configuration
If the file exists, a special command set,
is executed each time.
Advanced File and Print Server information
Virtual Disk Manager information
Vintela Authentication from SCO (VAS) client information
Other miscellaneous information
A report summary shows commands that failed with
a non-zero exit status.
Option defaults can be changed in the file
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
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
The default filenames for -c and -d
options cannot be changed.
Open Source utilities must be located in /usr/local/bin.
© 2004 The SCO Group, Inc. All rights reserved.