NAME
arrayscan — search system for disk arrays
DESCRIPTION
arrayscan
searches the system I/O buses to locate the address(es)
of attached
HP
disk array devices.
The utility can also be
used to determine which logical units are configured on a disk array.
arrayscan
performs several functions, including:
Ensuring device special files exist.
arrayscan
verifies that block and character device special files exist for all
LUNs
configured. On Series 700 systems, device files are created for
all possible
LUNs.
Ensuring disk array software was downloaded.
arrayscan
verifies that the disk array software has been downloaded for each
disk array it encounters. If
arrayscan
encounters a disk array that does not have
disk array software loaded,
it automatically downloads the array software.
Updating
monitor,
and
pscan
device lists.
Two files,
/etc/hpC2400/hparray.devs,
and
/etc/hpC2400/hparray.luns
are updated by
arrayscan.
/etc/hpC2400/hparray.devs
is used by the monitor daemon
(/usr/lbin/hpC2400/arraymond)
to determine which devices to monitor.
/etc/hpC2400/hparray.luns
is used by the parity scan utilities
(pscan, scn,
and rpr)
to determine which
LUNs
to monitor.
RETURN VALUE
arrayscan
returns the following values:
- 0
Successful completion
- -1
Command failed (an error occurred).
DIAGNOSTICS AND ERRORS
Errors can originate from problems with:
SCSI
(device level) communications
Error messages generated by arrayscan:
- arrayscan: Cannot access lock file. Create an empty file <FILE>
Two semaphore files are used by
arrayscan,
/etc/hpC2400/pscan.lock,
and
/etc/hpC2400/monitor.lock.
If these files do not exist when
arrayscan
begins, it assumes that the monitor daemon
is executing.
If the period of time required for the monitor daemon to execute expires,
and the files still do not exist,
it is assumed that they need to be created.
You can create these files, if necessary, using the
touch
command (see
touch(1));
- arrayscan: Unable to open Array Parity Scan list <FILE>
arrayscan
updates
/etc/hpC2400/hparray.luns,
and
/etc/hpC2400/hparray.devs.
arrayscan
was unable to write to this file.
- arrayscan: Error from process insf.
An error occurred while executing
insf
(see
insf(1M)).
insf
is used by
arrayscan
on Series 800
systems to create device files for newly configured disk array devices.
- arrayscan: Error from process ioscan.
An error occurred while executing
ioscan.
ioscan
is used by
arrayscan
to scan for all devices.
Disk array devices are filtered from the ioscan output.
- arrayscan: No SCSI devices identified. Check SCSI connections.
No
SCSI
devices were identified. Check
SCSI
cables and power connections and retry the command.
- arrayscan: Unable to create char device special file for path <FILE>
arrayscan
will create character, and block device files
for all disk array devices it encounters.
arrayscan
was unable to create the device file.
- arrayscan: Insufficient dynamic memory
An attempt to allocate dynamic memory failed.
DEPENDENCIES
This utility is supported only on
HP C2425D, HP C2430D, HP C3595A
and
HP C3596A
disk array devices.
AUTHOR
arrayscan
was developed by HP.
FILES
- /etc/hpC2400/hparray.luns
- /etc/hpC2400/hparray.devs
- /etc/hpC2400/pscan.lock
- /etc/hpC2400/monitor.lock
Printable version
