cpqscsimon(1M) cpqscsimon(1M)
NAME
cpqscsimon - Compaq Fast-SCSI-2 Monitor
SYNOPSIS
cpqscsimon start [pollingtime]
cpqscsimon stop
DESCRIPTION
The Fast-SCSI-2 Monitoring feature monitors various
operational parameters of the Compaq 32-Bit Fast-SCSI-2
Controller and attached SCSI-2 devices. Support is included
for the ProLiant Storage System and SCSI-2 hard drives. It
reports status changes such as hard drive hot-plug
installation or removal and ProLiant Storage System fan and
temperature alarms to the administrator through mail.
The utility is typically started automatically as the
operating system enters multi-user mode. To prevent the
Fast-SCSI-2 Monitoring feature from being automatically
started as the system enters multi-user mode, rename the file
/etc/rc2.d/S99cpqscsimon to /etc/rc2.d/s99cpqscsimon.
Starting/Stopping the SCSI-2 Monitor
The SCSI-2 Monitor is automatically started during the system
startup. You can manually start it by entering:
cpqscsimon start [pollingtime]
where pollingtime is the number of seconds to wait between
data collection intervals. The minimum allowed value is 2
seconds. The default time is 30 seconds.
To stop the monitor, enter:
cpqscsimon stop
SCSI-2 Monitor Alarm Messages
The Mail alarm messages and causes associated with the monitor
are listed below. They are generally preceded by messages to
the system console from the cled(7) driver.
The following definitions apply to all SCSI-2 Monitor alarm
messages.
cpqsc = host adapter type designation for Compaq 32-Bit Fast-SCSI-2
Controller
Copyright 1994 Novell, Inc. Page 1
cpqscsimon(1M) cpqscsimon(1M)
s = slot number
n = host adapter number
Status of a 32-Bit Fast-SCSI-2 Controller has CHANGED
The SCSI-2 Monitor sends the following alarm message if
it detects a change in the status of a SCSI-2
Controller.
The Status of a 32-Bit Fast-SCSI-2 Controller has CHANGED
ht=cpqsc slot=s ha=n
Prior status status
New status status
where the values for status for both the prior and new
status fields are:
UNKNOWN
No prior status.
OTHER Status not listed below.
OK Normal Controller operating status.
FAILED
Not operational due to hardware or configuration
failure.
Status of a ProLiant Fan has CHANGED
The SCSI-2 Monitor sends the following alarm message if
it detects a change in the status of the ProLiant
Storage System fan.
The Status of a ProLiant Fan has CHANGED
ht=cpqsc slot=s ha=n
Prior status status
New status status
where the values for status for both the prior and new
status fields are:
UNKNOWN
No prior status.
OTHER Status not listed below.
Copyright 1994 Novell, Inc. Page 2
cpqscsimon(1M) cpqscsimon(1M)
OK Normal ProLiant drive enclosure fan operating
status.
FAILED
The ProLiant drive enclosure fan is not
operational.
NONE The ProLiant drive enclosure does not contain a
monitored fan.
Temperature Status of a ProLiant has CHANGED
The SCSI-2 Monitor sends the following alarm message if
it detects a change in the status of the ProLiant drive
enclosure fan.
The Temperature Status of a ProLiant has CHANGED
ht=cpqsc slot=s ha=n
Prior status status
New status status
where the values for status for both the prior and new
status fields are:
UNKNOWN
No prior status.
OTHER Status not listed below.
OK Normal operating status.
DEGRADED
The temperature in the ProLiant drive enclosure is
too hot.
FAILED
The temperature in the ProLiant drive enclosure is
much too hot.
NONE The ProLiant drive enclosure does not have
temperature sensors.
Status of a SCSI hard drive has CHANGED
The Status of a type SCSI hard drive has CHANGED
ht=cpqsc slot=s ha=n
Prior status status
Copyright 1994 Novell, Inc. Page 3
cpqscsimon(1M) cpqscsimon(1M)
New status status
where type is one of the following:
Non-Hot-Plug
The drive is not in a hot pluggable location.
External Hot
The hot pluggable drive is in an external Plug
enclosure
Internal Hot
The hot pluggable drive is in the server Plug
enclosure
and where the values for status for both the prior and
new status fields are:
UNKNOWN
No prior status.
OTHER Status not listed below.
OK Normal operating status.
OK REMOVED
A hot pluggable drive which had not failed was
removed.
FAILED
The last read or write request before this drive
went offline failed.
REMOVED
A hot pluggable drive which had failed was
removed.
Compaq Fast-SCSI-2 Monitor Starting/Stopped
The following message may appear as the Compaq Fast-
SCSI-2 Monitor starts.
Compaq Fast-SCSI-2 Monitor Starting ..... Started.
This indicates that the /etc/cpqscsimon start command
has been successfully executed.
Copyright 1994 Novell, Inc. Page 4
cpqscsimon(1M) cpqscsimon(1M)
The following message may appear as the Compaq Fast-
SCSI-2 Monitor stops.
Compaq Fast-SCSI-2 Monitor Stopping ..... Stopped.
This indicates that the /etc/cpqscsimon stop command has
been successfully executed.
Operational Error Messages
Operational errors may cause the Compaq Fast-SCSI-2 Monitor to
issue any of the following messages.
Error n opening command pipe text (CPQ1002)
Error n text
These messages indicate an internal error. The error number n
is a UnixWare "errno" error number. The text for this error
number is included in the message. The text may indicate the
cause, which is sometimes a temporary shortage of kernel
resources such as processes or inodes.
Command Line Errors
The following messages may result from command line errors
when starting the Compaq Fast-SCSI-2 Monitor.
insufficient arguments
Bad poll time argument xyz
Bad set argument xyz
Bad trap argument xyz
Unknown command line option xyz
where xyz is the portion of the command line that was in
error.
FILES
/etc/cpqscsimon script to start the monitor
/etc/rc2.d/S99cpqscsimon linked to /etc/cpqscsimon to
auto-start the monitor
/etc/rc0.d/K01cpqscsimon linked /etc/cpqscsimon to
auto-stop the monitor
/usr/bin/compaq/diags/cpqscsi/cpqscsimonexecutable file for the
Copyright 1994 Novell, Inc. Page 5
cpqscsimon(1M) cpqscsimon(1M)
monitor
/usr/bin/compaq/registry/scsi/*files holding current status
of peripherals
/usr/bin/compaq/registry/stsys/*files holding current status
of ProLiant Storage Cabinets
REFERENCES
cpqsc(7), cled(7)
NOTICES
This command is only supported on applicable Compaq systems.
Copyright 1994 Novell, Inc. Page 6