cpqsmu(1M) cpqsmu(1M)
NAME
cpqsmu - Compaq SCSI-2 Management Utility
SYNOPSIS
cpqsmu [c] [-h] -ttype -nhanum -op
DESCRIPTION
The cpqsmu utility provides general SCSI management support
for the Compaq 32-Bit Fast-SCSI-2 Controller.
SCSI-2 Management support includes both a menu driven mode and
a command line driven mode. Not all of the options are
available in both the menu driven mode and command line mode.
The following table lists the options and the applicable
modes.
Command
SCSI-2 Management Utility Option Menu Mode Line Mode
______________________________________________________________
Current SCSI request activity for the Yes Yes
Compaq Fast-SCSI-2 Controllers and
attached devices
______________________________________________________________
A display of all Compaq SCSI-2 Yes Yes
adapters and attached devices (some
non-Compaq SCSI adapters may also be
displayed)
______________________________________________________________
A display of the status of the Yes No
ProLiant Storage System LEDs
______________________________________________________________
The ability to manipulate display Yes No
parameters associated with the various
SCSI-2 Management Utility status
screens
SCSI-2 Management Utility Menu Mode
The cpqsmu utility uses a menu-driven interface. To execute
and use the SCSI-2 Management Utility through the menu
interface, complete the following steps:
1. Log in as root and execute the following commands:
cd /usr/bin/compaq/diags/cpqscsi
./cpqsmu
Copyright 1994 Novell, Inc. Page 1
cpqsmu(1M) cpqsmu(1M)
2. Use the cursor to highlight the desired menu operation,
then press ENTER to select the menu entry.
3. Press the ESC key to back up one menu screen.
NOTE: When the system contains one or more Compaq 6260
SCSI-2 Controllers, a series of selection timeout errors
are displayed when the utility starts and when it enters
the "SCSI Detail" menu selections. The message is
informational only and may be safely ignored.
The SCSI-2 Management Menu Mode options are described in the
following paragraphs.
Activity
The Activity menu selection displays the SCSI bus activity of
the Compaq Fast-SCSI-2 Controllers. The display can be
configured to include all data since the kernel was booted or
since the SCSI-2 Management Utility Activity screen was
initiated. The ability to refresh the statistics allows you
to view a ``window'' of data based upon a selectable refresh
rate.
Once you have selected the Activity menu, then you can select
either an adapter overview, or display a specific adapter.
The adapter overview only shows configured controller totals
while the specific adapter display includes the selected
adapter totals along with all of the attached SCSI devices.
This data helps an administrator view the requests being
processed. From this data the administrator can get an idea
of how busy each SCSI hard drive is, and how busy each Fast-
SCSI-2 controller is. This information can help in hard drive
and SCSI controller load balancing.
All values given for the fields below are based on activity
over a period of time shown near the top of the screen. The
duration is shown as dd Days hh:mm:ss.
The Ending Time for the period is shown as Weekday Month Day,
hh:mm:ss Year.
The device is either a SCSI host adapter type and number, or a
SCSI peripheral attached to the SCSI bus via that host adapter
and identified by a SCSI ID. The activity numbers for SCSI
host adapters represent the aggregate of all SCSI peripherals
Copyright 1994 Novell, Inc. Page 2
cpqsmu(1M) cpqsmu(1M)
connected to the system via this host adapter.
The following list gives the field names on the Activity menu
screen and their definitions:
Total Transfer Bytes
The total number of bytes transferred by this device
during the period.
Total Complete Requests
The total number of I/O requests completed by the device
during the period. The average number of bytes
transferred in a request may be computed by dividing
Total Transfer Bytes by Total Complete Requests.
Total Rd/Wr Errs
The total number of Read or Write requests which
completed with an error during the period. This number
is frequently 0.
Percent Write Bytes
The percent of Total Transfer Bytes which were bytes
written to the peripheral. The remaining portion of
Total Transfer Bytes were read from the peripheral.
Percent Unit Busy
The percentage of elapsed time in the period during
which the peripheral had a request outstanding. The
remaining portion of the time, the device was idle.
Note that elapsed time is known with 1 second accuracy
and busy time is known with .01 second accuracy.
Percent Queue Busy
The percentage of elapsed time in the period during
which the peripheral had one or more requests queued in
the host adapter driver to be sent to the device. The
host adapter driver queues requests when they must be
delayed by the host adapter. This may happen, for
example, when the device has already been sent the
maximum number of requests it can process at one time.
Per Second Elapsed Bytes
The number of bytes transferred during the period
divided by the number of seconds in the period. This is
a data-transfer rate based real time, not CPU cycle
time.
Copyright 1994 Novell, Inc. Page 3
cpqsmu(1M) cpqsmu(1M)
Per Second Elapsed Requests
The number of I/O requests sent to this device divided
by the number of seconds in the period. This is a
request-completion rate for the device based on real
time, not CPU cycle time.
Per Second Busy Bytes
The number of bytes transferred during the period
divided by the time in seconds the device was busy
during the period. This is an indication of how quickly
the device transferred data when it had requests to
process.
Per Second Busy Requests
The number of requests completed during the period
divided by the time in seconds the device was busy
during the period. This is an indication of how many
requests per second the device processed when it had
requests to process.
The following screen is an example of the Activity screen menu
selection for a selected host adapter.
Press Enter or <ESC> to reselect a Host Adapter
Thu Feb 11 15:55 1993
Adapter Overview
Compaq Fast-SCSI-2 Controller (c0) Slot 6 Host Adapter number 0
0 Days 0:20:50 Ending Thu Feb 11 15:55:39 1993
[Data refresh frequency: DISABLED] [Screen reset: DISABLED]
--------- Total -------- --- Percents --- -------- Per Second ---------
Transfer Complete Rd/Wr Write Unit Queue-- Elapsed -- ---- Busy ----
id Bytes Requests Errs Bytes Busy Busy Bytes Reqs Bytes Reqs
5 0.000 B 216.0 0.000 0 0 0 0.000 B 0.2 0.000 B 270.0
4 11.18MB 413.0 0.000 100 5 0 8.943KB 0.3 179.5KB 6.6
3 93.18KB 321.0 0.000 0 1 0 4.55 B 0.3 5.909KB 20.4
2 8.689MB 476.0 0.000 100 3 0 6.951KB 0.4 211.5KB 11.6
0 35.87MB 4.925K 0.000 56 10 0 238.7KB 3.9 298.0KB 40.9
c0 55.83MB 6.496K 3.000 72 18 0 44.66KB 5.2 242.4KB 28.2
B = Bytes, KB = Kilobytes, MB = Megabytes, GB = Gigabytes, TB = Terabytes
Where 1 KB = 1000 Bytes, 1 MB = 1000000 Bytes, 1 GB = 1 MB x 1 K, etc.
Copyright 1994 Novell, Inc. Page 4
cpqsmu(1M) cpqsmu(1M)
SCSI Detail
The SCSI Detail menu selection provides a display of all of
the Compaq SCSI-2 adapters located within the system. Within
the SCSI Detail menu selection you may select either the
Adapter/Device Map or the ProLiant Storage System LED Map menu
selections.
Adapter/Device Map
The Adapter/Device Map selection allows you to select a host
adapter for display. The display of each host adapter
includes detailed information concerning the adapter and
attached SCSI devices. Information similar to the following
is displayed:
Adapter/Device Map
Press Enter or <ESC> to reselect an Adapter
Thu Feb 11 15:20 1993
Host Adapter
Compaq Fast-SCSI-2 Controller (c0)
Slot 6 SCSI-ID 7 Host Adapter number 0 IRQ 11 I/O addr 0x6000
Adapter Type [cpqsc] SCSI Bus Speed [10 Mb/s] Refresh period [Disabled]
SCSI Devices
Type ID LUN Status Capacity Device Information
DISK 0 0 PASS 1.1 GB COMPAQ C2247 0BC2
TAPE 2 0 NO MEDIA N/A ARCHIVE Python 28209-0013.79
DISK 3 0 PASS 486.5 MB FUJITSU M2624F-512 0404
TAPE 4 0 PASS N/A ARCHIVE Python 25947-XXX2.40
CD-ROM 5 0 PASS 196.4 MB COMPAQ CD-ROM CDU561-311.8i
B = Bytes, KB = Kilobytes, MB = Megabytes, GB = Gigabytes, TB = Terabytes
Where 1 KB = 1000 bytes, 1 MB = 1000000 bytes, 1 GB = 1 MB x 1 KB, etc.
The Host Adapter area of the Adapter/Device Map describes the
following:
Host Adapter
The information contained in the Host Adapter area
includes the name of the host adapter. (for example,
c0).
Copyright 1994 Novell, Inc. Page 5
cpqsmu(1M) cpqsmu(1M)
Slot Data
The second line indicates the slot number, the SCSI ID
that the host adapter is using, the IRQ, DMA (if
applicable), and beginning I/O address.
Adapter Information
The third line contains the adapter type, and the SCSI
bus speed (if applicable).
The SCSI devices area of the Adapter/Device Map describes the
following:
Type The type of SCSI device. The UnixWare supported SCSI
devices include:
DISK - direct access device, typically a hard disk drive
TAPE - sequential access device, typically tape drives
including DAT tape, 320/525 tape
CD-ROM - CD-ROM device
Also, the following devices are displayed if located on
the SCSI bus:
PRINTER - printer device
OPTICAL - optical memory device
CHANGER - medium changer device
WORM - Write-Once devices
ID The SCSI ID of the device
LUN The Logical Unit Number of the device. Currently only
LUN=0 is supported.
Status
The status of the device at the last update. The
possible ``status'' display definitions are as follows:
PASS The device is ready and media (if removable) has
been inserted and is ready. On some SCSI hard
disk drives, a PASS indication is returned even
though the drive is not ``spun-up.''
NO MEDIA
This status indicates that no media is present in
the drive, typically when there is no cartridge in
a tape drive.
Copyright 1994 Novell, Inc. Page 6
cpqsmu(1M) cpqsmu(1M)
NOT READY
The device is attached to the SCSI bus, but is not
ready to accept data without action from you.
Typically, this indicates that a SCSI disk drive
has ``spun-down.''
FAILED
The non-disk device previously returned valid
status, but currently does not respond to any
queries. Either the device has been physically
removed or the device has failed and is not
responding.
OFF-LINE
the disk device previously returned status, but
currently does not respond to any queries. Either
the device has been physically removed or the
device has failed and is not responding.
BUSY The device is unable to return status information,
typically when the device is performing self-
diagnostics, or when a tape cartridge is initially
inserted.
Capacity
The capacity is displayed only if the device is a hard
disk, an optical disk device, WORM drive or CD-ROM
drive. The capacity is calculated using a base of 1K
bytes = 1000, and therefore 1MB = 1000000 bytes and 1GB
= 1MB x 1KB. The utility polls all SCSI ID's to
determine what devices are connected. If a device
initially has no power, has a bad connection, or has a
duplicate SCSI ID, it does not show up on the list.
Device Information
The information contained in this area includes the
product manufacturer's name as well as identifying
version numbers.
ProLiant Storage System LED Map
The ProLiant Storage System provides support for up to 7 SCSI
hard drives with hot-plug capability. Hot-plug capability
means that you do not need to remove power from the SCSI
cabinet or the PC Server when removing, replacing or
installing hard drives. In most cases you do not have to shut
down the Operating System on the PC Server. However, you must
Copyright 1994 Novell, Inc. Page 7
cpqsmu(1M) cpqsmu(1M)
make sure that the PC Server is not currently using a drive
which you are about to remove or replace.
Each removable drive tray in the ProLiant Storage System
cabinet has three LED indicators. These LEDs indicate when a
drive is being used or when a drive may require replacement.
When the ProLiant Storage System is not connected to a Compaq
SCSI array controller, fault tolerance features and LED
indicator control must be provided by operating system
software. The ProLiant Storage System Driver provided for
UnixWare provides the LED control. It does not provide fault
tolerance features for hard drives.
The ProLiant LED Map selection allows you to select a host
adapter for display. The display of each host adapter
includes detailed information concerning the LED activity
lights on the ProLiant Storage System product. Also, support
is provided to simulate the LED activity lights for any Compaq
Fast-SCSI-2 Controller adapter and attached SCSI devices.
Each ProLiant Storage System entry displayed is labeled with
the adapter name and host adapter number (for example, c0).
The SCSI ID is displayed vertically with ID=6 in the topmost
slot corresponding to the manner in which the SCSI devices are
configured in the ProLiant Storage System product.
The column labeled On is representative of the ONLINE LED
indicator on each drive in the unit. The column labeled Fail
is representative of the FAIL LED indicator on each drive.
When an entry changes from ``-'' to ``*'' then the LED is
active.
The ONLINE LED is turned on when the device has been opened,
and is turned off when the last close on the device occurs.
The ONLINE indicator means that the drive cannot be removed
safely at this time. Removing a drive while it is ONLINE may
corrupt the data contained on the drive. When the ONLINE
indicator is off, the drive may be removed safely.
NOTE: SCSI drives which contain the root file system or the
swap area are always ONLINE and cannot be removed while the
UnixWare operating system is running.
Copyright 1994 Novell, Inc. Page 8
cpqsmu(1M) cpqsmu(1M)
The FAIL LED indicator, when on, means that the drive is not
ONLINE and that the drive failed to successfully complete the
final read or write request immediately before the operating
system closed or unmounted the drive. This may or may not be
an indication that the drive has failed permanently. If you
suspect that a drive may have failed permanently, run the
Compaq Diagnostics.
The ACTIVITY LED indicator is not displayed by this utility
because its state is too dynamic.
Configuration
The Configuration menu selection provides you with the ability
to set up the parameters associated with the SCSI Detail and
Activity display screens. The Configuration screen is shown
and described below.
Configuration
Enter refresh frequency for SCSI Detail display screen(s) (0=disabled)
Fri Feb 12 09:27 1993
[SCSI Detail screen parameter selections]
SCSI Detail screen(s) periodic refresh frequency in seconds [0 ]
[Request Activity screen parameter selections]
Activity screen shows SCSI request activity during the period since
[B]oot, [S]tart of Activity screen, or [L]ast refresh? [B]
Automatic refresh in seconds (0 = no refresh) [0 ]
SCSI Detail screen periodic refresh frequency (seconds)
This entry is used to determine the number of seconds
between status checks on the SCSI devices currently
displayed. Any change in status is updated only when
the periodic refresh is performed. For example, if the
refresh period was for 30 seconds, then every 30
seconds the current status of the selected adapter and
attached SCSI devices would be updated. A value of 0
disables the refresh and no update is performed.
screen, or [L]ast refresh?
Activity screen shows SCSI request . . . [B]oot, [S]tart of Activity
This entry determines the starting time for the data to
Copyright 1994 Novell, Inc. Page 9
cpqsmu(1M) cpqsmu(1M)
be displayed on the Activity menu selections. If the
[S]tart of Activity screen startup [S] option is chosen,
the data is zeroed when the adapter is chosen and the
Activity screen is displayed. If the [B]oot option is
chosen, the data is displayed beginning with the last
time the system was booted. If the [L]ast refresh
option is chosen, the screen data is cleared upon each
periodic update of the screen. The refresh rate is
determined by the next selection.
Automatic refresh period in seconds (0 = no refresh)
This entry determines the number of seconds between
updates of the data for the Activity menu selection.
For example, if the refresh period was 30 seconds, every
30 seconds the activity data from the selected
adapter(s) and attached SCSI devices would be updated.
A value of 0 disables the refresh and no update to the
displayed data is performed.
SCSI-2 Management Utility Command-Line Mode
To execute the SCSI-2 Management Utility in the command line
mode, complete the following steps:
1. Login as root.
2. Enter the following commands:
cd /usr/bin/compaq/diags/cpqscsi
cpqsmu [c] [-h] -ttype -nhanum -op
The available options are the following:
c specifies command line mode
-h displays help information for the command line
mode.
-ttype
specifies the host adapter type, where type is
cpqsc.
-nhanum
specifies the host adapter number, where hanum is
the host adapter number. The hanum argument has a
maximum range of 0 through 7. Each adapter type
(for example, cpqsc), begins with host adapter
Copyright 1994 Novell, Inc. Page 10
cpqsmu(1M) cpqsmu(1M)
number 0, then increases without skipping a
sequence number. Note that the total number of
SCSI controllers/adapters can not exceed 8,
including all types.
op specifies the operation to perform, where
a means display the activities information since boot for the
specified host adapter.
m means display the SCSI device map for the specified host adapter.
s means display the current SCSI bus speed for the specified host
adapter.
NOTE: All command lines must contain the -n hanum
and the -t type options.
EXAMPLES
cpqsmu c -m -tcpqsc -n0 - display the SCSI device map for host adapter
number 0 of type cpqsc.
cpqsmu c -h - display command line help information for the c
set of options.
The cpqsmu utility returns a value of 0 or 1. A value of 0
indicates that the command completed successfully, and a value
of 1 indicates that the command did not complete successfully.
The utility sends information out to stdout and stderr
depending on whether or not the utility is in terse (-t) mode.
The utility performs as follows:
-t Option Error Type of output from cpqsmu
OFF NO verbose text information to stdout
OFF YES verbose text information to stdout/stderr
ON NO return 0 - no other indication is issued
ON YES return 1 - no other indication is issued
FILES
/usr/bin/compaq/diags/cpqscsi/cpqsmu
REFERENCES
cled(7), cpqsc(7), cpqscsimon(1M)
NOTICES
This command is only supported on applicable Compaq systems.
Copyright 1994 Novell, Inc. Page 11