unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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



 saconfig(1M)							saconfig(1M)




 NAME
      saconfig - Command Line Configuration Utility for the HP SmartArray
      RAID Controller Family

 SYNOPSIS
      /opt/raidsa/bin/saconfig <device_file>

      /opt/raidsa/bin/saconfig <device_file> -R <RAID_level> [-S
	   <stripe_size>] -p <channel>:<target> [-p <channel>:<target> ...]
	   [-s <channel>:<target>]

      /opt/raidsa/bin/saconfig <device_file> -A <logical_drive_num> -s
	   <channel>:<target>

      /opt/raidsa/bin/saconfig <device_file> -D <logical_drive_num>

      /opt/raidsa/bin/saconfig <device_file> -D all

      /opt/raidsa/bin/saconfig <device_file> -C <read_caching_percentage>

      /opt/raidsa/bin/saconfig <device_file> -F on

      /opt/raidsa/bin/saconfig <device_file> -F off


 DESCRIPTION
      The saconfig command is a command line configuration tool for the HP
      SmartArray RAID Controller Family. This command provides the ability
      to create a logical drive, add a spare drive to existing logical
      drive, display configuration, delete a logical drive, and clear
      configuration. This command also enables the cache when it is used to
      create the first logical drive on the SmartArray RAID Controller.
      Furthermore it allows the option of changing the percentage of total
      cache size used for read caching and write caching. The auto-fail
      missing disks at boot feature can be enabled or disabled using this
      command.

    Prerequisites
      An effective user ID of 0 (superuser) is required in order to run the
      saconfig command. In addition, saconfig needs to be able to create the
      /tmp/saconfig.lock file when it starts executing.	 This prevents
      multiple users from running saconfig.  This lock file is removed when
      saconfig exits.

    Options
      saconfig recognizes the following options and parameters as indicated
      in the SYNOPSIS section above.

      <device_file>	       To specify the device file for the SmartArray
			       RAID Controller. The device file is
			       /dev/ciss<&lt&lt&lt;X>&gt&gt&gt;, as displayed by the ioscan -kfn



 Hewlett-Packard Company	    - 1 -	  Formatted:  August 2, 2006






 saconfig(1M)							saconfig(1M)




			       command for the appropriate SmartArray RAID
			       Controller.

			       With no other options, saconfig displays size
			       and status for all physical drives and RAID
			       level, size, and status for all logical
			       drives.

      -R <RAID_level>	       To create a logical drive with the specified
			       RAID level. The supported RAID levels are 0,
			       1, 1+0, 5, and ADG. The lowest logical drive
			       number not already in use will be given to
			       the newly created logical drive, starting
			       from 0. To determine the hardware path and
			       device file for the logical drive, use the
			       ioscan -kfn command. The logical drives are
			       displayed in the same order as in the
			       saconfig output.

			       RAID 1+0 logical drive requires even number
			       of physical drives (minimum of 2). To achieve
			       optimal fault tolerance, it is best to
			       specify the same number of physical drives
			       per channel if possible when creating a RAID
			       1+0 logical drive. This ensures the physical
			       drives in each mirrored pairs would be on
			       different channels.

      -S <stripe_size>	       To specify the stripe size for the logical
			       drive to be created. The supported stripe
			       sizes are 8, 16, 32, 64, 128, and 256 (KB).
			       128 and 256 stripe sizes are not available
			       for RAID 5 or ADG logical drive. If this
			       option is not used to specify the stripe
			       size, default stripe size will be used to
			       create the logical drive. For RAID 0 and 1+0
			       logical drive, the default size is 128. For
			       RAID 5 and ADG logical drive, the default
			       size is 16.

      -p <channel>:<target>    To specify each physical drive to be included
			       in the logical drive configuration. Valid
			       channel numbers are between 1 and 4. Valid
			       target numbers are between 0 and 15.

      -s <channel>:<target>    To specify a spare drive to be included in
			       the logical drive configuration. Valid
			       channel numbers are between 1 and 4. Valid
			       target numbers are between 0 and 15.





 Hewlett-Packard Company	    - 2 -	  Formatted:  August 2, 2006






 saconfig(1M)							saconfig(1M)




      -A <logical_drive_num>   To specify which logical drive to add spare
			       drive to.

      -D <logical_drive_num>   To delete the specified logical drive.

      -D all		       To clear configuration.

      -C <read_caching_percentage>
			       To specify the percentage of total cache size
			       to be used for read caching. The remaining
			       percentage will be used for write caching.
			       Valid read caching percentage numbers are 0,
			       25, 50, 75, and 100 (%).

      -F on		       To enable auto-fail missing disks at boot
			       feature.

      -F off		       To disable auto-fail missing disks at boot
			       feature.

    Logical Drive State Definitions
      OK	  All physical disks in the logical drive are operational.

      FAILED	  Some possible causes:
		  1) Multiple physical disks in a fault-tolerant (RAID 1,
		     1+0, 5, ADG) logical drive have failed.
		  2) One or more disks in a RAID 0 logical drive have
		     failed.
		  3) Cache data loss has occurred.
		  4) Array expansion was aborted.
		  5) The logical drive is temporarily disabled because
		     another logical drive on the controller had a missing
		     disk at power-up.

      USING INTERIM RECOVERY MODE
		  Also known as "degraded" state. A physical disk in a fault
		  tolerant logical drive has failed. For RAID 1, 1+0 or 5,
		  data loss may result if a second disk should fail. For
		  RAID ADG, data loss may result if two additional disks
		  should fail.

      READY FOR RECOVERY OPERATION
		  A replacement disk is present, but rebuild hasn't started
		  yet (another logical drive may be currently rebuilding).
		  The logical drive will also return to this state if the
		  rebuild had been aborted due to unrecoverable read errors
		  from another disk.

      RECOVERING  One or more physical disks in this logical drive are being
		  rebuilt.




 Hewlett-Packard Company	    - 3 -	  Formatted:  August 2, 2006






 saconfig(1M)							saconfig(1M)




      WRONG PHYSICAL DISK WAS REPLACED
		  While the logical drive was in a degraded state, the
		  system was powered off and a disk other than the failed
		  disk was replaced. Shut off the system and replace the
		  correct (failed) disk.

      PHYSICAL DISK(S) NOT PROPERLY CONNECTED
		  While the system was off, one or more disks were removed.
		  Note: the other logical drives are held in a temporary
		  "failed" state when this occurs.

      EXPANDING	  The data in the logical drive is being reorganized
		  because:
		  1) Physical disks have been added to the array (capacity
		     expansion).
		  2) The stripe size is being changed (stripe-size
		     migration).
		  3) The RAID level is being changed (RAID-level migration).

      NOT YET AVAILABLE
		  A capacity expansion operation is in progress (or is
		  queued up) that will make room on the disks for this new
		  logical drive.  Until room has been made on the physical
		  disks, this newly configured logical drive cannot be read
		  or written.

      QUEUED FOR EXPANSION
		  The logical drive is waiting to undergo data
		  reorganization (see EXPANDING above).	 Possible causes for
		  the delay are a rebuild or expansion operation may already
		  be in progress.

    Physical Disk State Definitions
      OK	  The physical disk is configured in one or more logical
		  drives and is operational.

      SPARE	  The physical disk is configured as a spare disk.

      UNASSIGNED  The physical disk has not been configured in any logical
		  drives.

      FAILED	  The configured physical disk has failed.

    Return Value
      saconfig returns the following values:

	   0	Successful completion.
	   1	Command line syntax error.
	   2	Incompatible CISS driver API.
	   3	Failure opening a file.




 Hewlett-Packard Company	    - 4 -	  Formatted:  August 2, 2006






 saconfig(1M)							saconfig(1M)




	   4	Other error.

    Examples
      To display configuration on the SmartArray RAID Controller /dev/ciss5
      -

	   /opt/raidsa/bin/saconfig /dev/ciss5

      To create a RAID 1+0 logical drive to include physical drives 4:0 and
      4:1 and spare drive 4:2 -

	   /opt/raidsa/bin/saconfig /dev/ciss5 -R 1+0 -p 4:0 -p 4:1 -s 4:2

      To create a RAID ADG logical drive with stripe size 64 to include
      physical drives 1:2, 2:2, 3:2 and 4:2 -

	   /opt/raidsa/bin/saconfig /dev/ciss5 -R ADG -S 64 -p 1:2 -p 2:2 -p
	   3:2 -p 4:2

      To add spare drive 1:0 to logical drive 1 -

	   /opt/raidsa/bin/saconfig /dev/ciss5 -A 1 -s 1:0

      To delete logical drive 0 -

	   /opt/raidsa/bin/saconfig /dev/ciss5 -D 0

      To clear configuration -

	   /opt/raidsa/bin/saconfig /dev/ciss5 -D all

      To change read caching percentage to 75% -

	   /opt/raidsa/bin/saconfig /dev/ciss5 -C 75

 AUTHOR
      saconfig was developed by HP.

 FILES
      /opt/raidsa/bin/saconfig Executable file.

      /tmp/saconfig.lock       saconfig lock file.

      /dev/ciss<&lt&lt&lt;X>&gt&gt&gt;	       Device files.

 SEE ALSO
      sautil(1M).

      HP A7143A RAID160 SA Controller Support Guide
      HP Smart Array 6400 Series Controller Support Guide




 Hewlett-Packard Company	    - 5 -	  Formatted:  August 2, 2006