•
Parameters surrounded by
{ }
must be entered one or more times, as appropriate for the
executed command.
•
Command line definition characters (
< >
,
[ ]
, and
{ }
) cannot be entered on the command
line.
The program name, controller number, command, and parameters fields must be separated by
the ASCII space character. The format of the parameters is command-specific.
The program return value is returned to the user when the program exits. A value of
0
is returned
if the command is successful. Otherwise, a value of
1
is returned.
Rules for creating IM volumes and hot spare disks
When creating IM volumes and hot spare disks, the following rules apply:
•
All disks that are part of an IM volume or a hot spare for an IM volume must be on the same
SAS controller.
•
IM volumes are supported.
•
Only two IM volumes (plus a global hot spare) per controller can be created.
•
An IM array must have two disks.
•
A hot spare disk cannot be created without at least one IM volume already created.
•
The utility does not allow adding a hot spare disk type different from disk types in the
volume.
•
With the
AUTO
command all drives used are the same type as the first available disk found,
and the size is limited to the size of the smallest disk.
CFGGEN Utility Commands
Following are the commands available for the
cfggen
utility.
CREATE Command
The
CREATE
command creates IM volumes on the SAS controller. Firmware and hardware
limitations for this family of cards limit the number of configurations that are possible.
Syntax
cfggen <controller #> create <volume type> <size> [qsync] [noprompt]
Parameters
<volume type>
Volume type for the volume to be created. Valid value is IM.
<size>
Size of the IM volume in megabytes, or “MAX” for the maximum size
available.
[qsync]
Quick synchronization of the volume created.
[noprompt]
Eliminates warnings and prompts.
Operation
After a disk is added to an IM volume, its storage capacity might or might not be used depending
on drive capacity and volume capacity. For example, if you add a 36 GB disk to a volume that
only uses 9 GB of capacity on each disk, the remaining 27 GB of capacity on the disk is unusable.
The disk identified by the first SCSI ID on the command line is assigned as the primary disk
when creating an IM volume. If the SAS controller is allowed to resynchronize the disks, the data
on the primary disk is available by accessing the newly created volume.
AUTO Command
The
AUTO
command automatically creates an IM volume on the SAS controllers. The volume
is created with the maximum number of disks available for use in the specified volume type.
The main difference between the
AUTO
command and the
CREATE
command is that with
AUTO
command, you do not specify SCSI ID values for disks to use in the volume. The
cfggen
CFGGEN Utility
237
