sysinfo(1M)


sysinfo -- generate report on system configuration for diagnostic use

Synopsis

/etc/sysinfo [-b | -h | -t] [-cdr] [-f filename] [-l lines] [-q | -v] [-s seconds] [command_list]

Description

The sysinfo command 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. The sysinfo command creates a system information report, scanning either the entire system or specific subsystems as directed by the optional command_list. You can also use sysinfo to create a live system dump, and can specify any executable as part of command_list.

The default behavior with no options is to create an HTML report in /var/adm/sysinfo.html. The command does not return any output to the screen unless -q or -v are specified.

Options

The available options are:

-b
Create both html and text reports.

-h
Create an html report only (default).

-t
Create a text report only.

-c
Creates a report and archives the new report (plus any previous reports found in the report directory) in a tar(1) file, /var/adm/system.timestamp.tar. If specified with -d, a live system dump is also taken and archived in the tar file.

-d
Create and archive a live system dump in /var/adm/system.timestamp.live-dump.tar.

-r
Link the new HTML report to any previous reports found in the report directory.

-f filename
Specify different report pathname or filename (default is /var/adm//sysinfo.html); if relative path is given, it is evaluated relative to the current working directory of the invoking process.

-l lines
Sets the maximum length of command/log listings (default is 200 lines; maximum is 999 lines).

-q
Quiet - display minimal progress indicators.

-v
Verbose - display each UNIX command as it is executed.

-s seconds
Sets the timeout for individual commands (default is 30 seconds; maximum is 60 seconds).

Option defaults can be changed in the file /usr/lib/sysinfo.d/lib/sysinfo.conf (with the exception of the file names used for the -c and -d options).

Commands

The provided commands for command_list are:

basic
basic configuration information

defaults
system defaults

hw
hardware configuration

mail
sendmail configuration

misc
miscellaneous information

net
networking configuration and statistics

nfs
NFS and NIS statistics

perf
performance statistics

ppp
Point-to-Point (PPP) protocol statistics

print
printer configuration

uucp
serial and UUCP configuration

vfs
filesystem information and statistics

The following commands work only if the indicated product is installed:


afps
Advanced File and Print Server (AFPS)

lkp
Linux Kernel Personality (LKP)

nsc
NonStop Clustering (NSC)

odm
Online Data Manager (ODM)

tta
Tarantella

vas
SCO Authentication

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

Examples

To generate an HTML report named /var/adm/status.html, generate alive system dump, and watch as each command is executed:
   sysinfo -dvf /var/adm/status.html

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, extend the timeout to one minute:

   sysinfo -s 60

© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004