saconfig(1M)															      saconfig(1M)

NAME

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

SYNOPSIS

       <device_file>

       <device_file> -N

       <device_file>  -R <RAID_level> [-S <stripe_size>] -p <physical_drive_id> [-p <physical_drive_id> ...]  [-s <physical_drive_id>] [-c <capac-
	      ity>]

       <device_file> -e <low|medium|high>

       <device_file> -r <low|medium|high>

       <device_file> -P <default|shortest|longest>

       <device_file> -A <logical_drive_num> -s <physical_drive_id>

       <device_file> -D <logical_drive_num> -s <physical_drive_id>

       <device_file> -D <logical_drive_num> -s all

       <device_file> -D <logical_drive_num>

       <device_file> -D all

       <device_file> -C <read_caching_percentage>

       <device_file> -F on

       <device_file> -F off

       <device_file> -I -p <physical_drive_id> [-p <physical_drive_id> ...]

       <device_file> -I -l <logical_drive_num>

       <device_file> -E <logical_drive_num> -c <capacity>

       <device_file> -E <logical_drive_num> -p <physical_drive_id> [-p <physical_drive_id> ...]

       <device_file> -M <logical_drive_num> -R <RAID_level> [-S <stripe_size>]

       <device_file> -M <logical_drive_num> -S <stripe_size>

DESCRIPTION

       The 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 fea-
       ture can be enabled or disabled using this command.

   Prerequisites
       needs to be able to create the /tmp/saconfig.lock file when it starts executing.  This prevents multiple users from running This lock  file
       is removed when exits.

   Security Restrictions
       requires  either the superuser privilege or and privileges.  See privileges(5) for more information about privileged access on systems that
       support fine-grained privileges.

   Options
       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 as displayed by the command  for
				the appropriate SmartArray RAID Controller.

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

				With the option saconfig displays size and status for all physical drives and RAID level, size, and status for all
				logical drives. But the persistent device files (see intro(7)) will be displayed as against legacy device files in
				the absence of this option.

       -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 command. The logical drives are dis-
				played in the same order as in the 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 <physical_drive_id>	To specify the SCSI physical disk. It can be represented as <channel_id>:<target_id> (e.g., 4:12).  Valid  channel
				numbers are between 1 and 4. Valid target numbers are between 0 and 15.

				To  specify  the  SAS/SATA  physical  disk.  It  can be represented as either <connector>:<enclosure>:<bay> (e.g.,
				2I:1:10) or <wwid> (e.g., 0x500000e010f16432).

       -s <physical_drive_id>	To specify a spare drive to be included in the	logical  drive	configuration.	Refer  <physical_drive_id>  to	-p
				option.

       -c <capacity>		To specify the size in GB of a logical drive to be created.

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

       -e <low | medium | high> To  change the expand priority of controller to one of Low, Medium, High. When there are no logical drives, expand
				priority cannot be changed. When the configuration is cleared, or the last logical drive is  deleted,  the  subse-
				quent logical drive creation will change the expand priority value of the controller to medium.

       -r <low | medium | high> To  change  the  rebuild  priority  of	controller  to one of Low, Medium, High. When there are no logical drives,
				rebuild priority cannot be changed. When the configuration is cleared, or the last logical drive is  deleted,  the
				subsequent logical drive creation will change the rebuild priority value of the controller to high.

       -P <default | shortest | longest>
				To  change the path selection method by the controller firmware. If it is set to default, firmware will select the
				Active path on its own. If the selection method is set to shortest, firmware will select the shortest path as  the
				Active	Path.  If  the path selection method is longest, firmware will select the longest path as the Active Path.
				All multi path configurations are Active-Standby configurations.

       -D <logical_drive_num> -s <physical_drive_id>
				To delete the spare drive from the specified logical drive.

       -D <logical_drive_num> -s all
				To delete all of spare drives from the specified logical drive.

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

       -I -p <physical_drive_id> [-p <physical_drive_id> ...]
				To identify SAS/SATA physical drive(s) by LED.

       -I -l <logical_drive_num>
				To identify a SAS/SATA logical drive by LED.

       -E <logical_drive_num> -c <capacity>
				To extend the capacity of the specified logical drive up to larger capacity. The capacity is in GB.

       -E <logical_drive_num> -p <physical_drive_id> [-p <physical_drive_id> ...]
				To expand the specified logical drive and others in an array by physical drive(s).

       -M <logical_drive_num> -R <RAID_level> [-S <stripe_size>]
				To perform RAID level [with stripe size] migration on the specified logical drive. The stripe size is in KB.

       -M <logical_drive_num> -S <stripe_size>
				To perform stripe size migration on the specified logical drive. The stripe size is in KB.

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

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

       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.

       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.

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

       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.

       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.

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

       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.

       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
       The physical disk is configured in one or more logical drives and is
		   operational.

       The physical disk is configured as a spare disk.

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

       The configured physical disk has failed.

   Return Value
       returns the following values:

	      Successful completion.
	      Command line syntax error.
	      Incompatible CISS driver API.
	      Failure opening a file.
	      Other error.

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

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

	      -R -p -p -s

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

	      -R -S -p -p -p -p

       To create a RAID 5 logical drive with capacity 45 GB to include SAS physical drives 1I:1:16, 1I:1:15, and 1I:1:14 -

	      -R -c -p -p -p

       To set the expand priority of logical drives on a controller to medium

	      -e

       To set the rebuild priority of logical drives on a controller to high

	      -r

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

	      -A -s

       To delete spare drive 1:0 from logical drive 1 -

	      -D -s

       To delete all spare drives from logical drive 1 -

	      -D -s

       To delete logical drive 0 -

	      -D

       To clear configuration -

	      -D

       To change read caching percentage to 75% -

	      -C

       To extend logical drive 2 upto 45 GB in capacity -

	      -E -c

       To expand logical drive 0 with 2 SAS physical drives -

	      -E -p -p

       To migrate logical drive 2 with stripe 32 -

	      -M -S

       To migrate logical drive 2 to RAID level 5 with stripe 64 -

	      -M -R -S

AUTHOR

       was developed by HP.

FILES

       Executable file.

       saconfig lock file.

       Device files.

SEE ALSO

       sautil(1M), privileges(5), intro(7).

																      saconfig(1M)