*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> amutil (1m)              


 amutil(1M)                                                       amutil(1M)

 NAME    [Toc]    [Back]
      amutil - controls various disk array management functions

 SYNOPSIS    [Toc]    [Back]
      amutil { [ -f channel:ID,channel:ID... ] | [ -F ] | [ -s ] |
           [ -R LUN -f Freq -a Amt ] | [ -p ] | [ -l ] }
           [ -V ] ArrayID

      amutil -?

 DESCRIPTION    [Toc]    [Back]
      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    [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]
      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

           -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

 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003

 amutil(1M)                                                       amutil(1M)

                          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.

      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

    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.

 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003

 amutil(1M)                                                       amutil(1M)

      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.

    Environment Variables
      LC_MESSAGES determines the language in which messages are displayed.
      The current language settings can be checked with locale(1).

 RETURN VALUE    [Toc]    [Back]
      amutil returns the following values:

           0    Successful completion.
           1    An error in execution (I/O, subsystem, security, etc.)
           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    [Toc]    [Back]
      The following messages can be generated by amutil:

      Usage: amutil {-f <Channel:ID>[,<Channel:ID>...] |
           -F | -l | -s |
           -R <LUN> -f <Freq> -a <Amt>}
           [-V] <ArrayID>}

       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.

 Hewlett-Packard Company            - 3 -   HP-UX 11i Version 2: August 2003

 amutil(1M)                                                       amutil(1M)

      amutil: The <ArrayID> entered does not identify a known, supported
           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>:
           <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]
      Flash the amber LEDs on all the disks in disk array RACK_51:

           amutil -F RACK_51

      Stop flashing the amber LEDs on disk array RACK_51:

           amutil -s 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    [Toc]    [Back]
      AM60Srvr must be running to execute this command. See AM60Srvr(1M).

 AUTHOR    [Toc]    [Back]
      amutil was developed by HP.

 SEE ALSO    [Toc]    [Back]
      ammgr(1M), amcfg(1M), amdsp(1M), amlog(1M), AM60Srvr(1M).

 Hewlett-Packard Company            - 4 -   HP-UX 11i Version 2: August 2003
[ Back ]
 Similar pages
Name OS Title
amdload HP-UX downloads new firmware to the disk array controllers, the disk system BCC controllers, and disks
AM60Srvr HP-UX disk array server daemon
format HP-UX format an HP SCSI disk array LUN
ammgr HP-UX manages the operating characteristics of the disk array
amcfg HP-UX manages LUN (logical drive) configuration on the disk array
amdsp HP-UX display the status and operating configuration of the disk array
readdisklabel NetBSD disk label management routines
bounds_check_with_label OpenBSD disk label management routines
disklabel OpenBSD disk label management routines
disklabel NetBSD disk label management routines
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service