unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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



 arraymgr(1M)							arraymgr(1M)




 NAME
      arraymgr - manages the operating environment of the disk array.

 SYNOPSIS
      arraymgr -s  { shut | start } [-V] [-?] array-id

      arraymgr -R [-V] [-?] array-id

      arraymgr -D alias_name [-V] [-?] array-id

      arraymgr -J  { SingleController | Secure | Normal | HighPerformance }
	   [-V] [-?] array-id

      arraymgr [Options] [-V] [-?] array-id

 DESCRIPTION
      arraymgr manages the operating environment of the disk array by
      providing access to the settings used to control disk array operation.
      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.	arraymgr also allows you shutdown,
      restart, and reset the disk array.

      The array-id used to address the disk array can be the disk array
      serial number, the character device file name of any LUN on the array
      (LUN 0 if no LUNs are created), or the alias text string assigned to
      the disk array.

      Changing some of the disk array settings may require that the disk
      array be reset using the -R option. You will be prompted to initiate a
      reset if the setting you changed requires this action.

      NOTE: Several of the arraymgr options are used to set the disk array
      SCSI operating parameters.  These parameters control the transfer of
      data over the SCSI channel connecting the host and the disk array and
      typically do not need to be changed. Before changing a SCSI setting,
      make sure you understand what affect it will have on disk array
      operation. Selecting an incorrect setting may make it impossible for
      the host to access the disk array.

    Options
      arraymgr supports the following options:

      -a { on | off }	  Set Auto Rebuild on or off. On allows the disk
			  array to automatically begin a rebuild in the
			  event of a disk failure. Off requires a rebuild to
			  be started manually. In either case, the disk
			  array must have enough available capacity to
			  perform the rebuild.





				    - 1 -	  Formatted:  August 2, 2006






 arraymgr(1M)							arraymgr(1M)




      -c { X | Y }	  Set controller X or controller Y as the active
			  controller for the disk array. This option is only
			  available if there are two controllers installed
			  in the disk array.

      -C { X | Y } addr	  Set the SCSI address of the specified controller
			  (X or Y) to the value of addr.  The address must
			  be a value from 0 to 15 and must not conflict with
			  any other SCSI devices connected to the same SCSI
			  channel.

      -D alias_name	  Assigns the text string specified by alias_name as
			  the alias for the disk array. The alias is another
			  mechanism for identifying the disk array when
			  executing a command. The alias name can be up to
			  12 characters in length and can include upper case
			  letters, numbers, spaces, number sign (#),
			  underscore (_), and period (.).

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

      -e { on | off }	  Change the apparent state of read cache on or off.
			  This switch only changes the read cache setting
			  presented to the operating system and does not
			  affect the operation of the disk array, which
			  always has read cache enabled. This switch is
			  provided for operating system interoperability.

      -f { on | off }	  Set Format Pattern Fill on or off. This feature
			  impacts the performance of the disk array. When
			  disabled the disk array does not write a format
			  pattern to the unused portion of each 64K data
			  block. This improves the write performance of the
			  disk array, but leaves invalid data in the unused
			  portion of the block. Enabling the format pattern
			  fill causes the disk array to fill the unused
			  portion of each block with a known data pattern.
			  This increases the amount of time required to
			  perform each write, but it   ensures that any
			  unused portions of the disk contain a recognizable
			  data pattern. The need to use this feature depends
			  on how well your OS can detect unwritten portions



				    - 2 -	  Formatted:  August 2, 2006






 arraymgr(1M)							arraymgr(1M)




			  of the disk. If your OS requires a known format
			  pattern to distinguish areas of the disk that do
			  not contain valid data, then enable write pattern
			  fill.

      -F		  Force server lock. Used in multi-host
			  configurations, this option allows a host to take
			  immediate ownership of the disk array lock. This
			  lock gives the owner exclusive ability to perform
			  destructive operations, such as reading and
			  clearing the disk array logs.

      -g { start | stop } Starts and stops background disk integrity
			  testing. When starting, the testing will begin
			  within 60 seconds of issuing the command. Disk
			  integrity testing checks the condition of the disk
			  media, looking for potential problems and data
			  errors.

      -G value		  Controls the interval at which disk integrity
			  testing is performed.	 A value of 1 to 365
			  specifies the number of days between testing. If a
			  value of 0 is specified, testing is disabled and
			  will not be performed. The default value is 9
			  days. If the disk array is reset or power cycled,
			  the default value of 9 days will be restored.

      -h { on | off }	  Set Active Spare on or off. On enables the disk
			  array to allocate enough capacity to rebuild a
			  failed disk. Off disables Active Spare.

      -i { on | off }	  Set Auto Include on or off. On allows the disk
			  array to automatically include any disk when it is
			  installed in the disk array cabinet.	Off requires
			  that a disk be manually included after it is
			  installed.

      -J		  This option sets the level of protection offered
			  by data resiliency.  It determines how often the
			  content of the controller maps are copied to the
			  disk. Keeping the map information on the disks
			  protect against controller map loss.

			  SingleController is used if the disk array is
			  operating with only one controller.  This
			  suppresses the single controller warning messages
			  that are normally generated when the disk array is
			  operating with one controller.

			  Secure continually updates the disks with any
			  changes in the controller maps.  This is the



				    - 3 -	  Formatted:  August 2, 2006






 arraymgr(1M)							arraymgr(1M)




			  highest level of data protection, but it may
			  result in decreased I/O performance.

			  Normal updates the maps on the disks at regular
			  intervals (typically 4 seconds).  This option
			  offers both data protection and good performance.

			  HighPerformance updates the disk maps only during
			  shutdown of the disk array. This is the lowest
			  level of data protection, but it offers the
			  highest level of performance.

      -l		  Flush current server logs to disk. The contents of
			  the server log are copied to a disk file.

      -m { on | off }	  Set Terminator Power on or off.

      -o { on | off }	  Set Secondary Controller Offline. When set on,
			  this option causes the secondary controller to
			  remove itself from the SCSI bus. The secondary
			  controller no longer responds to host commands and
			  appears to be disconnected from the SCSI bus. This
			  allows the secondary controller to be set to the
			  same SCSI ID as the primary controller. If the
			  primary controller fails, the secondary controller
			  takes over and the host driver does not have to
			  contend with a change in SCSI ID. This is useful
			  for systems that do not use a driver that can
			  gracefully handle a change in SCSI ID on the disk
			  array.

      -p { high | low }	  Set Rebuild Priority high or low. High sets the
			  rebuild to the same priority as host I/Os. This
			  allows the rebuild to complete as quickly as
			  possible, but slows down the servicing of I/Os.
			  Low sets the rebuild priority lower than host
			  I/Os. This ensures that host I/Os are serviced
			  more quickly, but it delays the completion of the
			  rebuild.

      -P { on | off }	  Set SCSI Parity Checking on or off.

      -r { on | off }	  Set Disable Remote Reset on or off. On disables
			  Remote Reset, and off enables it. Remote Reset is
			  useful when the disk array controllers are
			  connected to separate SCSI buses. In some
			  situations, a reset on one SCSI bus can cause the
			  clearing of all commands on the other bus. When
			  this occurs, the host would typically have to wait
			  for a timeout before realizing that commands had
			  been lost. If Remote Reset is enabled (Disable



				    - 4 -	  Formatted:  August 2, 2006






 arraymgr(1M)							arraymgr(1M)




			  Remote Reset off), the other controller will
			  automatically reset its own SCSI bus, thus
			  alerting the host that commands have been lost.
			  This allows the host to respond quickly and
			  reissue any lost commands.

      -R		  Reset the disk array. This operation performs a
			  reset of the disk array.

      -s { shut | start } Shutdown (shut) or restart (start) the disk array.
			  A shutdown takes the disk array offline, making
			  all data on the array unavailable to the host. A
			  restart brings the disk array back online.

      -t value		  Set the capacity threshold warning to the
			  percentage specified by value.  The capacity
			  threshold warning generates an alert when the
			  percentage of disk array capacity specified by
			  value is in use.

      -T { on | off }	  Set SDTR on or off.

      -V		  Verbose mode displays additional command
			  execution, state, and/or status messages.

      -w { on | off }	  Change the apparent state of write cache on or
			  off. This switch only changes the write cache
			  setting presented to the operating system and does
			  not affect the operation of the disk array, which
			  always has write cache enabled. The disk array
			  write cache is stored in NVRAM which eliminates
			  the need to disable write cache for protection
			  against power loss. This switch is provided for
			  interoperability with those operating systems that
			  require write cache be turned off.

      -W { on | off }	  Set WDTR on or off.

      -?		  Display extended usage message. This option
			  overrides all others.

 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
      arraymgr returns the following values:

	   0  Successful completion.




				    - 5 -	  Formatted:  August 2, 2006






 arraymgr(1M)							arraymgr(1M)




	   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 ARMServer is
	      not running.

 DIAGNOSTICS
      The following messages can be generated by arraymgr:

      Usage: arraymgr {[-s shut|start] | [-D alias_name] | -R | -F}
      [-V] [-?] <&lt&lt&lt;array-id>&gt&gt&gt;
	   An error in command syntax has occurred.  Re-enter the command
	   with all necessary arguments.

      Usage: arraymgr {[-c X|Y] [-C X|Y addr] [-i on|off]
      [-t value] [-e on|off] [-w on|off] [-h on|off]
      [-a on|off] [-p high|low] [-P on|off] [-T on|off]
      [-W on|off] [-m on|off] [-f on|off] [-r on|off]
      [-q value] [-n value] [-o on|off] [-b on|off]
      [-g start|stop] [-G value] [-l] [-L]}
      [-S] [-V] [-?] [-E num] <&lt&lt&lt;array-id>&gt&gt&gt;
	   An error in command syntax has occurred.  Re-enter the command
	   with all necessary arguments.

      Usage: arraymgr -J SingleController|Secure|Normal|HighPerformance
      [-V] [-?] <&lt&lt&lt;array-id>&gt&gt&gt;
	   An error in command syntax has occurred. Re-enter the command
	   with all necessary arguments.

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

      arraymgr: Unknown argument
	   An invalid argument was specified. Check command usage.

      arraymgr: No such file or directory
	   The specified array-id does not exist or does not identify a disk
	   array LUN that is communicating with the system. Verify the
	   correct array-id with ioscan(1M).

      arraymgr: 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 More Error Info and Error Info Decode fields
	   will hold specifics about the failure and its cause.

      arraymgr: The array did not start up following the reset.
	   The disk array has been reset, but it did not start up again.
	   Check the control panel for possible hardware failure.



				    - 6 -	  Formatted:  August 2, 2006






 arraymgr(1M)							arraymgr(1M)




      arraymgr: The array is not shutdown, no restart performed.
	   An attempt was made to restart a disk array that was not
	   shutdown.

      arraymgr: The array did not restart in the expected time.
	   Following a restart command, the disk array took too long to come
	   back on line.

      arraymgr: The array is already shutdown.
	   An attempt was made to shutdown a disk array that was already
	   shutdown.

      arraymgr: The specified controller is not physically installed.
	   An attempt was made to perform an operation on a controller that
	   is not installed in the disk array.

      arraymgr: The specified controller is already active.
	   An attempt was made to make the currently active controller
	   active again.

      arraymgr: Active Spare Desired flag has been set, however the
      array is reporting the Active Spare is not available.
	   The Active Spare feature has been enabled, but the disk array
	   does not have enough unallocated capacity to create the Active
	   Spare. Add another disk or delete an existing LUN to increase the
	   amount of unallocated capacity so the Active Spare can be
	   created.

      arraymgr: Array was just powered-on or reset.
	   The command failed because the disk array has been powered-on or
	   reset.  Reissue the command and it should succeed.

 EXAMPLES
      Shutdown the disk array identified by device file /dev/rdsk/c2t0d0:

	   arraymgr -s shut /dev/rdsk/c2t0d0

      Restart disk array serial number 00786b5c0000:

	   arraymgr -s start 00786b5c0000

      Set Y as the active controller on disk array serial number
      00786b5c0000:

	   arraymgr -C Y 00786b5c0000

      Assign an alias to the disk array identified by device file
      /dev/rdsk/c2t0d0.	 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):




				    - 7 -	  Formatted:  August 2, 2006






 arraymgr(1M)							arraymgr(1M)




	   arraymgr -D RACK_51_03 /dev/rdsk/c2t0d0

      Set the data resiliency protection level to the highest level of
      protection on the disk array identified by alias AUTORAID2.

	   arraymgr -J Secure AUTORAID2

 DEPENDENCIES
      ARMServer must be running to execute this command. See ARMServer(1M).

 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.

 AUTHOR
      arraymgr was developed by HP.

 SEE ALSO
      ARMServer(1M), arraycfg(1M), arraydsp(1M), arrayfmt(1M), arraylog(1M),
      arrayrbld(1M), arrayrecover(1M), download(1M), drivetest(1M),
      dteststat(1M), logprint(1M).



				    - 8 -	  Formatted:  August 2, 2006