unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 ammgr(1M)							   ammgr(1M)




 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 (.).




				    - 1 -	  Formatted:  August 2, 2006






 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 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.





				    - 2 -	  Formatted:  August 2, 2006






 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
      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).



				    - 3 -	  Formatted:  August 2, 2006






 ammgr(1M)							   ammgr(1M)




 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 <&lt&lt&lt;ArrayAlias>&gt&gt&gt; | -b | -c AA |
	   -h <&lt&lt&lt;Channel:ID>&gt&gt&gt; | -d <&lt&lt&lt;Channel:ID>&gt&gt&gt; |
	   -T <&lt&lt&lt;CntrlrID>&gt&gt&gt;:<&lt&lt&lt;percent>&gt&gt&gt; |
	   -L <&lt&lt&lt;CntrlrID>&gt&gt&gt;:<&lt&lt&lt;percent>&gt&gt&gt; |
	   -p <&lt&lt&lt;pagesize>&gt&gt&gt; | -P <&lt&lt&lt;LUN>&gt&gt&gt; |
	   -H <&lt&lt&lt;LUN>&gt&gt&gt; | -s <&lt&lt&lt;LUN>&gt&gt&gt; | -t }
	   [-V] [-S] <&lt&lt&lt;ArrayID>&gt&gt&gt;

       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 <&lt&lt&lt;ArrayID>&gt&gt&gt; 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.



				    - 4 -	  Formatted:  August 2, 2006






 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, <&lt&lt&lt;Additional Error Info>&gt&gt&gt;:
	   <&lt&lt&lt;Error Info Decode>&gt&gt&gt;
	   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:

	   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
      AM60Srvr must be running to execute this command.	 See AM60Srvr(1M).

 AUTHOR
      ammgr was developed by HP.



				    - 5 -	  Formatted:  August 2, 2006






 ammgr(1M)							   ammgr(1M)




 SEE ALSO
      amdsp(1M), amcfg(1M), amutil(1M), amlog(1M), AM60Srvr(1M).




















































				    - 6 -	  Formatted:  August 2, 2006