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 ...]]
/etc/sysinfo configure
/etc/sysinfo template
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.
configure-
menu interface to configure what information is reported.
template-
creates template file /usr/lib/sysinfo.d/lib/template,
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.osr5.
These command sets are included:
print-
printer configuration
tta-
Tarantella information
afps-
Advanced File and Print Server information
vdm-
Virtual Disk Manager information
vas-
Vintela Authentication from SCO (VAS) client information
misc-
Other miscellaneous information
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/lib/sysinfo.conf.
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)
© 2004 The SCO Group, Inc. All rights reserved.