HP-UX Reference (11i v1 05/09) - 1M System Administration Commands A-M (vol 3)

a
arraymgr(1M) arraymgr(1M)
NAME
arraymgr - manages the operating environment of the disk array.
SYNOPSIS
arraymgr -s { shut | start }[
-V][-?] array-id
arraymgr -R [-V][-?
] array-id
arraymgr -D alias_name [-V][-?
] array-id
arraymgr -J { SingleController
| Secure | Normal |
HighPerformance }
[
-V][-?] array-id
arraymgr [Options][-V][
-?] array-id
DESCRIPTION
arraymgr manages the operating environment of the disk array by providing access to the settings used
to control disk array operation. These settings control the operation of the entire disk array; consequently,
every LUN on the disk array will be affected by any changes made using this command.
arraymgr also
allows you shutdown, restart, and reset the disk array.
The array-id used to address the disk array can be the disk array serial number, the character device file
name of any LUN on the array (LUN 0 if no LUNs are created), or the alias text string assigned to the disk
array.
Changing some of the disk array settings may require that the disk array be reset using the
-R option. You
will be prompted to initiate a reset if the setting you changed requires this action.
NOTE: Several of the
arraymgr options are used to set the disk array SCSI operating parameters. These
parameters control the transfer of data over the SCSI channel connecting the host and the disk array and
typically do not need to be changed. Before changing a SCSI setting, make sure you understand what affect
it will have on disk array operation. Selecting an incorrect setting may make it impossible for the host to
access the disk array.
Options
arraymgr supports the following options:
-a { on | off } Set Auto Rebuild on or off. On allows the disk array to automatically begin a rebuild
in the event of a disk failure. Off requires a rebuild to be started manually. In either
case, the disk array must have enough available capacity to perform the rebuild.
-c { X | Y } Set controller X or controller Y as the active controller for the disk array. This option
is only available if there are two controllers installed in the disk array.
-C { X | Y } addr Set the SCSI address of the specified controller (X or Y) to the value of addr. The
address must be a value from 0 to 15 and must not conflict with any other SCSI dev-
ices connected to the same SCSI channel.
-D alias_name Assigns the text string specified by alias_name as the alias for the disk array. The
alias is another mechanism for identifying the disk array when executing a command.
The alias name can be up to 12 characters in length and can include upper case
letters, numbers, spaces, number sign (#), underscore (_), and period (.).
Aliasing can be used in a variety of ways to help identify disk arrays in large systems.
For example, by assigning numbers to racks and to the shelf positions within the
racks, each disk array can be uniquely identified using an appropriate alias. If a rack
is assigned number 12, the disk array installed on shelf 3 of the rack could be
identified using an alias of 12_03. This technique simplifies locating the disk array
should it need service.
-e { on | off } Change the apparent state of read cache on or off. This switch only changes the read
cache setting presented to the operating system and does not affect the operation of
the disk array, which always has read cache enabled. This switch is provided for
operating system interoperability.
-f { on | off } Set Format Pattern Fill on or off. This feature impacts the performance of the disk
array. When disabled the disk array does not write a format pattern to the unused
portion of each 64K data block. This improves the write performance of the disk
array, but leaves invalid data in the unused portion of the block. Enabling the format
HP-UX 11i Version 1: September 2005 − 1 − Hewlett-Packard Company Section 1M−−63