NAME
ammgr — manages the operating characteristics of the disk array
SYNOPSIS
ammgr
-D
ArrayAlias
[-V]
[-?]
ArrayID
ammgr
[Options]
[-V]
[-?]
ArrayID
DESCRIPTION
ammgr
manages the operating characteristics of the disk array by providing access
to the settings used to control disk array operation. In most cases, 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. The exception is a parity scan, which impacts only the
specified LUN.
The
ArrayID
used to address the disk array can be the disk array serial number or name,
if one has been assigned to the disk array.
Identifying Disk Modules
Disk modules are identified within Array Manager 60 using a numbered pair
of the form
n:n.
The first number identifies the SCSI channel (or bus) connecting the array
controller to the enclosure containing the disk module. The channel number
is indicated on the back of the array controller enclosure. The second
number is the disk module SCSI ID. The SCSI ID is determined by the slot
in which the disk module is installed, but is not the same as the physical
slot number (0-9).
For example, the numbered pair
2:1
identifies the disk module on channel 2
with a SCSI ID of 1. Refer to the
Disk Array FC/60 User's Guide
for more information on disk module addressing.
Options
ammgr
supports the following options:
- -b
Reset battery age to zero. This should be done when the battery is replaced.
- -c AA
Set the controller mode to dual-active.
- -d channel:ID
Remove the role of hot spare for the disk at address
channel:ID.
The disk is identified by channel number (1-6) and SCSI ID (0-4, 8-12).
- -D ArrayAlias
Assigns the text string specified by
ArrayAlias
to the disk array. This name is another mechanism for identifying the disk
array when executing a command. The name can be up to 16 characters in
length and can include letters, numbers, number sign (#), underscore (_),
and period (.).
Disk names 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.
- -h channel:ID
Assign the role of hot spare to the disk at address
channel:ID.
The disk is identified by channel number (1-6) and SCSI ID (0-4, 8-12).
- -H LUN
Halt a parity scan currently in progress on the specified LUN. If a parity
scan is not in progress on the specified LUN, clear the status of the last
completed parity scan for the LUN.
- -L cntrlrID:percent
Sets the cache flush limit for the controller identified by
cntrlrID
to the value specified by
percent.
When flushing write cache pages to the disk media, the flush operation will
stop when the indicated percentage is reached. The value is expressed as a
percentage of the current cache flush threshold.
- -p {4|16}
Set the cache page size to 4 KB or 16 KB. The cache page size is set for both
disk array controllers. NOTE: The cache page size may not be set to 16 KB
unless the segment sizes of all existing LUNs are multiples of 16 KB.
- -P LUN
Perform a parity scan on the specified LUN.
NOTE: If errors are detected during a parity scan, it is recommended that
you contact your Hewlett-Packard service representative immediately. The
occurrence of parity errors may indicate a potential problem with the disk
array hardware.
- -s LUN
Show the status of the parity scan in progress on the specified LUN. The
final status continues to be displayed until cleared using the
-H
option.
- -t
Set the date and time stamp for both disk array controllers to match that
of the host.
- -T cntrlrID:percent
Sets the cache flush threshold for the controller identified by
cntrlrID
to the value specified by
percent.
When the contents of the write cache reaches the indicated percentage, pages
are flushed (written) to the disk media.
- -V
Verbose mode displays additional command execution, state, and/or status
messages.
- -?
Display extended usage message. This option overrides all others.
SECURITY CONFIGURATION
This command is modified for all security configurations.
Security Behavior/Restrictions
Use of this command is restricted to authorized users only.
Command Authorizations
This command requires the
sysadmin
authorization to successfully execute.
Privileges
The command has been modified to support least privilege. The potential
privileges possessed by the command and their uses include:
- allowdacread
This privilege is raised to provide discretionary read access to the devices.
- allowdacwrite
This privilege is raised to provide discretionary write access to the devices.
- allowmacread
This privilege is raised to provide mandatory read access to the devices.
- allowmacwrite
This privilege is raised to provide mandatory write access to the devices.
- filesysops
This privilege is raised to allow the
mknod(2)
system call to succeed.
- writeaudit
The command generates its own audit records and submits these directly
to the system audit trail. This privilege is raised whenever the command needs
to write an audit record.
EXTERNAL INFLUENCES
Environment Variables
LC_MESSAGES
determines the language in which messages are displayed. The current
language settings can be checked with
locale(1).
RETURN VALUE
ammgr
returns the following values:
- 0
Successful completion.
- 1
An error in execution (I/O, subsystem, security, etc.) occurred.
- 2
An error in command syntax occurred: for example, an unknown command-line
option was passed.
- 3
Timeout in communication to server. May indicate
AM60Srvr
is not running.
DIAGNOSTICS
The following messages can be generated by
ammgr:
Usage: ammgr {-D <ArrayAlias> | -b | -c AA |
-h <Channel:ID> | -d <Channel:ID> |
-T <CntrlrID>:<percent> |
-L <CntrlrID>:<percent> |
-p <pagesize> | -P <LUN> |
-H <LUN> | -s <LUN> | -t }
Extended help: ammgr -?
An error in command syntax has occurred. Re-enter the command with all
necessary arguments.
ammgr: Arg out of range
One of the arguments has exceeded its maximum or minimum size, or is
incorrect in form. Check the size and form of each argument.
ammgr: The <ArrayID> entered does not identify a known, supported array
The specified
ArrayID
does not exist or does not identify a device that is communicating with the
system. Verify the array exists and is operational.
ammgr: The specified controller is not physically installed.
A controller-specific command was issued to a non-existent or inaccessible
controller.
ammgr: The specified LUN does not exist in this array.
The specified LUN does not exist.
ammgr: Invalid Array alias. Alias name characters must be
alphanumeric, pound (#), underscore (_), or dot (.)
Illegal syntax for <ArrayID>.
ammgr: Invalid array alias. Another array already has the specified alias.
Another array on the host already has the specified alias. Duplicate aliases
are not allowed.
ammgr: Invalid array alias. Alias name cannot be longer
An attempt was made to set an array alias with more than the maximum allowed
number of characters.
ammgr: A parity scan is already in progress on the specified LUN.
An attempt was made to initiate a parity scan on a LUN which already has a
parity scan in progress.
ammgr: No parity scan in progress on the specified LUN.
An attempt was made to halt a parity scan on a LUN which has no parity
scan in progress.
ammgr: Cache page size may not be set to 16 KB unless the segment
sizes of all existing LUNs are multiples of 16 KB.
Illegal cache page size requested. Segment sizes of existing LUNs must
be multiples of the requested cache page size.
ammgr: Error in command execution, <Additional Error Info>:
The command failed due to a device error, an internal error, or a system
error. The
Additional Error Info
and
Error Info Decode
fields will hold specifics about the failure and its cause.
EXAMPLES
Assign a name to the disk array identified with ID 0000005EBD20. Use an alias
that identifies the rack the disk array is installed in (51 for this
example), and the shelf position the disk array is on (03 for this example):
ammgr -D RACK_51 0000005EBD20
Add a hot spare to disk array RACK_51 using the disk on channel 3 with
SCSI ID 4:
Initiate a parity scan of LUN 1 on disk array RACK_51:
Set the cache flush threshold to 80% for controller A on disk array RACK_51:
DEPENDENCIES
AM60Srvr
must be running to execute this command. See
AM60Srvr(1M).
AUTHOR
ammgr
was developed by HP.