ammgr(1M) ammgr(1M)
NAME [Toc] [Back]
ammgr - manages the operating characteristics of the disk array
SYNOPSIS [Toc] [Back]
ammgr -D ArrayAlias [-V] [-?] ArrayID
ammgr [Options] [-V] [-?] ArrayID
DESCRIPTION [Toc] [Back]
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 [Toc] [Back]
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 [Toc] [Back]
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 (.).
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: August 2003
ammgr(1M) ammgr(1M)
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 HewlettPackard
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.
Hewlett-Packard Company - 2 - HP-UX 11i Version 2: August 2003
ammgr(1M) ammgr(1M)
-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 [Toc] [Back]
This command is modified for all security configurations.
Security Behavior/Restrictions
Use of this command is restricted to authorized users only.
Command Authorizations [Toc] [Back]
This command requires the sysadmin authorization to successfully
execute.
Privileges [Toc] [Back]
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 [Toc] [Back]
Environment Variables
LC_MESSAGES determines the language in which messages are displayed.
The current language settings can be checked with locale(1).
Hewlett-Packard Company - 3 - HP-UX 11i Version 2: August 2003
ammgr(1M) ammgr(1M)
RETURN VALUE [Toc] [Back]
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 [Toc] [Back]
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 }
[-V] [-S] <ArrayID>
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.
Hewlett-Packard Company - 4 - HP-UX 11i Version 2: August 2003
ammgr(1M) ammgr(1M)
ammgr: Invalid array alias. Alias name cannot be longer
than 16 characters.
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>:
<Error Info Decode>
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 [Toc] [Back]
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:
ammgr -h 3:4 RACK_51
Initiate a parity scan of LUN 1 on disk array RACK_51:
ammgr -P 1 RACK_51
Set the cache flush threshold to 80% for controller A on disk array
RACK_51:
ammgr -T A:80 RACK_51
DEPENDENCIES [Toc] [Back]
AM60Srvr must be running to execute this command. See AM60Srvr(1M).
AUTHOR [Toc] [Back]
ammgr was developed by HP.
Hewlett-Packard Company - 5 - HP-UX 11i Version 2: August 2003
ammgr(1M) ammgr(1M)
SEE ALSO [Toc] [Back]
amdsp(1M), amcfg(1M), amutil(1M), amlog(1M), AM60Srvr(1M).
Hewlett-Packard Company - 6 - HP-UX 11i Version 2: August 2003 [ Back ] |
