unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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



 arraycfg(1M)							arraycfg(1M)




 NAME
      arraycfg - configures LUNs (logical drives) and physical disks.

 SYNOPSIS
      arraycfg -L LUN { -a capacity | -d | -r newLUN } [-V] [-?] array-id

      arraycfg -D slot { -a | -d [-v] [-R|-Z] } [-V] [-?] array-id

 DESCRIPTION
      arraycfg is used to manage both the logical and physical configuration
      of the disk array identified by array-id.	 Logical configuration
      involves creating, deleting, and renumbering LUNS (logical drives) on
      the disk array. Physical configuration involves including or downing
      disks from the array configuration.

      WARNING: Deleting a LUN will destroy all the data on the LUN. Backup
      all vital data before deleting a LUN.

      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.

    Options
      arraycfg supports the following options:

	   -a capacity	  If -L is specified, create the indicated LUN. The
			  capacity parameter indicates the size of the LUN.
			  By default, the size is specified in Mbytes. The
			  size can also be specified in Gbytes by appending
			  a "G" to the value, or in Kbytes by appending a
			  "K" to the value.

			  If -D is specified, include the indicated disk in
			  the array configuration.  When performing this
			  operation, capacity is not included.

	   -d [ -v ] [ -R | -Z ]
			  If -L is specified, delete the indicated LUN. The
			  remaining options are not used.

			  If -D is specified, bring down the indicated disk.
			  When downing a disk, the following supplemental
			  options are used

			  -v   Specifies whether the down operation is
			       destructive or nondestructive.  This
			       determines whether or not the disk array will
			       assume there is any valid data on the disk
			       when it is returned to the array
			       configuration. If the -v option is included,



				    - 1 -	  Formatted:  August 2, 2006






 arraycfg(1M)							arraycfg(1M)




			       the down is nondestructive and the array
			       assumes any data on the disk that was not
			       updated in the disk's absence is valid.	By
			       default, the array performs a destructive
			       down and assumes no valid data remains on the
			       disk when it is returned to the array
			       configuration.

			  -R   Allows the disk to be downed even if a loss
			       of redundancy would result, but not data
			       unavailability. When using this option, the
			       disk array will continue to offer full data
			       availability but the disk array is not
			       protected against another disk failure. If -R
			       is not included, the command to down a disk
			       will fail if it would result in a loss of
			       redundancy.

			  -Z   Allows the disk to be downed even if data
			       unavailability would occur. If -Z is not
			       included, the command to down a disk will
			       fail if it would result in data
			       unavailability.

			       WARNING: Specifying the -Z option could cause
			       the disk array to become unavailable.

	   -D slot	  Perform a physical configuration operation on the
			  disk installed in the cabinet slot identified by
			  slot. Slot numbers must be of the form An or Bn,
			  where A or B correspond to a cabinet column, and n
			  corresponds to a shelf position (1-6).

	   -L LUN	  Perform a logical configuration operation on the
			  LUN identified by LUN.

	   -r newLUN	  Renumber the LUN specified by LUN to the value
			  specified by newLUN.	This option is only used
			  with the -L option.

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

	   -?		  Display expanded 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).




				    - 2 -	  Formatted:  August 2, 2006






 arraycfg(1M)							arraycfg(1M)




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

 DIAGNOSTICS
      The following messages can be generated by arraycfg:

      Usage: arraycfg -L LUN {-a capacity | -d | -r newLUN}
      [-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: arraycfg -D slot {-a | -d [-v] [-R | -Z]}
      [-V] [-?] <&lt&lt&lt;array-id>&gt&gt&gt;
	   An error in command syntax has occurred. Re-enter the command
	   with all necessary arguments.

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

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

      arraycfg: 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) or arraydsp(1M).

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

      arraycfg: The disk is already included.
	   An attempt was made to include a disk that is already included in
	   the array configuration.

      arraycfg: Previously downed disk has been downed.
	   A down command was issued to a disk that was already downed.	 The
	   type of down (destructive or nondestructive) specified by the
	   latest command will be implemented.




				    - 3 -	  Formatted:  August 2, 2006






 arraycfg(1M)							arraycfg(1M)




      arraycfg: LUN nn does not exist in the array.
	   An attempt was made to perform an operation on a nonexistent LUN.

      arraycfg: Not enough space to create LUN.
	   An attempt was made to create a LUN that was larger than the
	   available unallocated capacity. Reduce the size of the LUN, or
	   make more capacity available by adding a disk or deleting an
	   existing LUN.

      arraycfg: The specified LUN exists, cannot create.
	   An attempt was made to create a LUN that already exists. Use a
	   different number to create the LUN.

      arraycfg: The specified LUN does not exist or is invalid.
	   An attempt was made to perform an operation on a LUN that does
	   not exist.

      arraycfg: The specified LUN is invalid.
	   An attempt was made to perform an operation on an invalid LUN.

      arraycfg: The specified newLUN already exists, cannot renumber.
	   An attempt was made to renumber a LUN using the number of an
	   existing LUN.  Select an unused number for the LUN being
	   renumbered.

      arraycfg: Disk was not downed, redundancy or data would be lost.
	   The specified operation cannot be performed because it would
	   result in loss of data availability or data redundancy. The -R
	   and -Z options can be used to override this error.

      arraycfg: Disk was not downed, data would be lost.
	   The specified operation cannot be performed because it would
	   result in loss of data. The -Z option can be used to override
	   this error.

      arraycfg: A diagnostic is currently running on this disk, cannot
      include disk until the diagnostic completes.
	   An attempt was made to include a disk that is currently
	   undergoing diagnostic testing. Wait until the diagnostic
	   completes, or cancel the diagnostic using the dteststat utility.

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

      arraycfg: The array is in a state that cannot process this command.
	   The disk array is unable to execute the command. This typically
	   occurs because the disk array is shutdown. Check disk array
	   status.





				    - 4 -	  Formatted:  August 2, 2006






 arraycfg(1M)							arraycfg(1M)




      arraycfg: 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
      Create LUN 6 with a size of 500 Mbytes on the disk array identified by
      device file /dev/rdsk/c2t0d0:

	   arraycfg -L 6 -a 500 /dev/rdsk/c2t0d0

      Renumber LUN 1 to LUN 2 on disk array serial number 00786b5c0000:

	   arraycfg -L 1 -r 2 00786b5c0000

      Delete LUN 3 on the disk array identified by device file
      /dev/rdsk/c2t0d0:

	   arraycfg -L 3 -d /dev/rdsk/c2t0d0

      Include the disk in slot B4 in the configuration of disk array serial
      number 00786b5c0000:

	   arraycfg -D B4 -a 00786b5c0000

      Down the disk in slot A3 on disk array serial number 00786b5c0000.
      Allow the command to execute even if redundancy will be lost:

	   arraycfg -D A3 -d -R 00786b5c0000

 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.



				    - 5 -	  Formatted:  August 2, 2006






 arraycfg(1M)							arraycfg(1M)




      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
      arraycfg was developed by HP.

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

































				    - 6 -	  Formatted:  August 2, 2006