NAME
amutil — controls various disk array management functions
SYNOPSIS
amutil
{ [ -f
channel:ID,channel:ID... ]
| [ -F ] | [ -s ] |
[ -R
LUN -f Freq -a
Amt ] |
[ -p ] |
[ -l ] }
[ -V ]
ArrayID
amutil -?
DESCRIPTION
amutil
controls a variety of management operations on the disk array identified by
ArrayID.
Locating hardware components and managing the rebuild process are done using
amutil.
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
amutil
supports the following options:
- -f channel:ID,channel:ID...
Flash the amber LED on the specified disks. Each disk is identified by
channel:ID.
Channel:ID
is determined by the disk enclosure channel number (1-6) and disk SCSI
ID (0-4, 8-12).
- -F
Flash the amber LEDs on all the disks in the disk array.
- -l
Flush server log file. This will retrieve the current log entries from
the disk array controller. The controller logs will be cleared.
- -p
Purge the oldest log file (delete the log file and remove its entry from
the log file catalog). Always use this option to delete log files.
Using a system command such as
rm
to delete log files will cause log catalog errors.
- -R LUN -f req -a Amt
Set the rebuild priority settings of the specified LUN. The
freq
value identifies the rate at which the disk array attempts to execute rebuild
commands. Specified in tenths of a second, this value can be 1 to 50,
or 0.1 seconds to 5.0 seconds. A low setting increases the frequency at which
rebuild commands are issued, giving higher priority to the rebuild but
reducing I/O performance. A high value reduces the rebuild command frequency,
giving higher priority to host I/Os. The default value for this setting is
1, or 0.1 seconds.
The
Amt
value identifies the number of blocks to rebuild at a time. This value can
be from 1 to 64K and specifies the number of 512-byte blocks processed
during each rebuild command. The higher the setting the more blocks which
will be processed, thus reducing I/O performance. A lower setting gives
priority to host I/Os, delaying the completion of the rebuild. The default
value for this setting is 64 blocks, or 32 Kbytes of data.
- -s
Stop flashing disk activity lights. This option is used to stop the flashing
on all disks.
- -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
amutil
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 the
AM60Srvr
is not running.
DIAGNOSTICS
The following messages can be generated by
amutil:
Usage: amutil {-f <Channel:ID>[,<Channel:ID>...] |
-R <LUN> -f <Freq> -a <Amt>}
amutil -p [-V]
Extended help: amutil -?
An error in command syntax has occurred. Reenter the command with all
necessary arguments.
amutil: 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.
amutil: 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.
amutil: The specified controller is not physically installed.
A controller-specific command was issued to a non-existent or inaccessible
controller.
amutil: The specified LUN does not exist in this array.
The specified LUN does not exist.
amutil: 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
Flash the amber LEDs on all the disks in disk array RACK_51:
Stop flashing the amber LEDs on disk array RACK_51:
The following example alters the rebuild priority settings. It assigns a
value of 5 seconds to the rebuild command rate, and sets the data block
amount to 16 blocks on LUN 4 on disk array RACK_51. This gives host I/Os
higher priority than the default settings.
amutil -R 4 -f 50 -a 16 RACK_51
DEPENDENCIES
AM60Srvr
must be running to execute this command. See
AM60Srvr(1M).
AUTHOR
amutil
was developed by HP.