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