 |
HP OpenVMS System Management Utilities Reference
Manual
READ FIRMWARE
Reads the firmware image on the controller.
Note
Supported only for Smart Array 5300 and Smart Array 6400 series
controllers.
|
Format
READ FIRMWARE <firmware file-name> / <qualifiers> firmware
file name
Parameters
firmware file name
Specifies the file name of the firmware image.
Qualifiers
/VERBOSE
Provides logging that can be interpreted by engineering.
RESET THIS_CONTROLLER
Issues a controller reset to the specified controller.
Format
RESET THIS_CONTROLLER <parameters> / <qualifiers>
CONTROLLER_TYPE
Parameters
CONTROLLER_TYPE
Issues a controller reset to the specified controller.
Note
Applicable only for MSA1000/1500 controllers.
|
Qualifiers
/VERBOSE
Provides logging that can be interpreted by engineering.
Example
|
MSA> RESET THIS_CONTROLLER
|
RESET OTHER_CONTROLLER
Issues a reset to the controller. The state of this controller can be
either ACTIVE or STANDBY.
Format
RESET OTHER_CONTROLLER / <qualifiers> CONTROLLER_TYPE
Parameters
CONTROLLER_TYPE
Issues a controller reset to the specified controller.
Note
Applicable only for MSA1000/1500 controllers.
|
Qualifiers
/VERBOSE
Provides logging that can be interpreted by engineering.
Example
|
MSA> RESET OTHER_CONTROLLER
|
SCAN ALL
Sends a scan message to the Smart Array controller instructing it to
scan SCSI buses and discover new or replaced disks. After the scan is
complete, the rebuild operation for the logical volumes is initiated
for all the units configured in the disk group.
This command is applicable only for the internal disk enclosure
connected to the Smart Array on Integrity server platforms.
Note
For additional information on rebuild of volumes, see the START RECOVER
command.
|
Format
SCAN ALL
Parameters
None
Qualifiers
None
Example
SET CONTROLLER
Selects the controller device-name as the default controller. The
device name has the format ddcu:, where:
dd is the device code.
c is the controller designation (A through Z).
u is the unit number (0 through 9999).
This command is required before entering all SAS utility commands
except SHOW CONTROLLER and SHOW VERSION.
Note
SET CONTROLLER command is synonymous with the SET ADAPTER command.
|
Format
SET CONTROLLER [ddcu:] / <qualifiers>
Parameters
None
Qualifiers
/DEFAULT
Specifies the default controller.
/VERBOSE
Provides logging that can be interpreted by engineering.
Example
|
MSA> SET CONTROLLER $1$GGA105:
|
This command sets controller $1$GGA105 as the default controller.
SET GLOBALS
Set the expand priority, the read/write ratio, and the system name.
Format
SET GLOBALS / <qualifiers>
Parameters
None
Qualifiers
/EXPAND_PRIORITY=(LOW | MEDIUM | HIGH)
Sets the default controller.
Specifies the expand priority. Use when expanding an array to set the
priority of array expansions in relation to input/output (I/O)
operations. Use in the following format:
/EXPAND_PRIORITY=(LOW | MEDIUM | HIGH)
|
/READ_CACHE=value
Specifies the percentage of cache to be used with the READ command.
This value must be between 0 and 100. Use the following format:
/READ_CACHE=(AUTOMATIC | percent)
|
Note
Combined, the values of the /READ_CACHE and the /WRITE_CACHE qualifiers
must equal 100.
|
/REBUILD_PRIORITY=(LOW | MEDIUM | HIGH)
Specifies the rebuild priority of the RAID volume.
Use when rebuilding an array to set the priority of an array rebuild in
relation to input/output (I/O) operations. Low expansion or rebuild
applies only when the array controller is not busy handling normal I/O
requests. This setting has minimal effect on normal I/O operations.
However, there is an increased risk that data will be lost if another
physical drive fails while the rebuild is in progress. Use the
following format:
/REBUILD_PRIORITY=(LOW | MEDIUM | HIGH)
|
/WRITE_CACHE=value
Specifies the percentage of cache to be used with the WRITE command.
The value must be between 0 and 100.
Note
Combined, the values of the /READ_CACHE and the /WRITE_CACHE qualifiers
must equal 100.
|
/SYSTEM_NAME=name
Specifies the name to be assigned to the controller.
The name represents any-user defined phrase, up to 20 alphanumeric
characters long.
Note
The /SYSTEM_NAME qualifier is not supported for Smart Array
controllers.
|
/VERBOSE
Provides logging that can be interpreted by engineering.
Example
|
MSA> SET GLOBALS/EXPAND_PRIORITY=HIGH/REBUILD_
PRIORITY=HIGH/SYSTEM_NAME="XXX"/READ_CACHE=50/
WRITE_CACHE=50
Example MSA$UTIL response for SHOW GLOBALS:
Controller: _$1$GGA1002: (DEFAULT)
Global Parameters:
System Name: ITA8.2-1
Rebuild Priority: high
Expand Priority: low
Total Cache: 256MB
25% Read Cache: 64MB
75% Write Cache: 192MB
|
SET UNIT
Modifies the attributes of existing units.
Format
SET UNIT <unit_n> / <qualifiers> unit_n
Parameters
unit_n
The unit number can be in the range of 0-31.
Qualifiers
/ADG
Specifies that the RAID type for the existing unit is Advanced Data
Guard (ADG). Use only with the /MIGRATE qualifier to migrate from any
existing RAID level to ADG.
/CACHE
Specifies whether to use the controller's cache for the unit. Caching
is On by default. To disable caching, use the /NOCACHE qualifier to the
SET UNIT or ADD UNIT command.
/DEL_SPARE
Specifies the spare disks to be removed from use for a unit. Multiple
disks must be enclosed in parentheses. Use the following format:
/DEL_SPARE=(disk numbers[,...])
|
Note
If you delete a spare disk (that is assigned to more than one LUNs)
from one unit, the disk specified in the DEL_SPARE qualifier will be
deleted from all the units in a disk group.
|
/DISK
Specifies the disks to be used to form the unit. Multiple disks must be
enclosed in parentheses. Use only with the /EXPAND qualifier to expand
the disks used by the existing unit, as shown in the following format:
/DISKS=(disk-numbers[,...])
|
Note
The /DISK qualifier can only be used with the /EXPAND qualifier.
|
/EXPAND
Allows the specified logical unit and all units in the disk/disk group
to utilize more disks. The /EXPAND qualifier does not increase the size
of the logical unit; rather, it adds more disks and increases space on
individual disks.
To increase the size of the logical unit use the /EXTEND qualifier
after you expand the unit.
During expansion of units in a drive group, the RAID level of certain
units might change. For example, if a RAID 1 unit with 2 disks is
expanded to 3 disks, then the RAID level must change to RAID 5 because
the RAID 1 unit does not support an odd number of disks.
When you expand a unit with other units present on the same set of
drives, all units undergo volume expansion. Use the following format:
SET UNIT <unit_n>/EXPAND/DISKS=<disk range>
|
Note
The value for disk range must include both pre-expansion disks and the
additional disks, for example 101, (101,112,314, ...).
Only the /DISK qualifier should be used with the /EXPAND qualifier.
|
Note
The /EXTEND, /EXPAND, and /MIGRATE qualifiers can be used only with the
SET UNIT command to change the attributes of an existing unit.
|
/EXTEND
Increases the size of an existing logical unit. To specify a new size
for the unit, use the /SIZE qualifier along with the /EXTEND qualifier.
The size specified must be greater than the current unit size. When
extending a unit with other units present on the same set of drives,
some units might be moved (that is, undergo volume expansion) to make
space for the additional size required.
Note that even though the SET UNIT/EXTEND command increases the unit
size, you complete other command completing successfully, the increased
size takes effect only after you complete other steps (such as SET
VOLUME/EXTENSION) successfully at the DCL prompt. For more information,
see the HP OpenVMS System Manager's Volume 1: Essentials
manual.
Use the following format:
SET UNIT <unit_n> /EXTEND/SIZE=value
|
Note
The /EXTEND, /EXPAND, and /MIGRATE qualifiers can be used only with the
SET UNIT command to change the attributes of an existing unit.
|
/IDENTIFIER
Specifies the unit number to be used by OpenVMS. The value of the
identifier is between 0 and 9999.
Note
The /IDENTIFIER qualifier is not required for Smart Array controllers.
|
/JBOD
Specifies the RAID type to be JBOD. This is synonymous with RAID 0.
/MIGRATE
Migrates the fault tolerance (RAID) level or stripe size, or both, of
an existing logical unit. When migrating a unit with other units
present on the same set of drives, some units might undergo volume
expansion.
SET UNIT <unit_n>/MIGRATE [/RAID_LEVEL=R] [/STRIPE_SIZE=S]
|
where unit_n = (0-31), R=(0,1,5), and S
=(8,16,32,64,128,256)
Note
The /ADG or /JBOD qualifier can also be used instead of the /RAID_LEVEL
qualifier.
Only RAID level and stripe size can be modified using the /MIGRATE
qualifier.
Cannot migrate any RAID units (RAID 1, RAID 5 and so on) that have
spare disks to RAID 0 or JBOD units.
|
Note
The /EXTEND, /EXPAND, and /MIGRATE qualifiers can be used only with the
SET UNIT command to change the attributes of an existing unit.
|
/RAID_LEVEL=level
Specifies the RAID type of the unit. The supported values for this
qualifier are 0 (data stripe), 1 (disk memory), and 5 (data striping
with striped parity).
Note
The /RAID_LEVEL qualifier can be used only with the /MIGRATE qualifier.
|
See the following example for the correct format:
/RAID_LEVEL=[(0 | 1 | 5 )]
|
/SIZE=size
Specifies the new size of a unit.
Use the following format:
/SIZE=size (GB | MB | KB | %)
|
Note
The /SIZE qualifier can only be used with the /EXTEND qualifier.
|
/SPARE
/SPARE specifies the disks to be designated as the spare disks.
Multiple disks must be enclosed in parentheses. Assigning a spare disk
to an unit in a drive group will assign the spare disk to all the
configured units in the drive group. If an unit is created on a disk
group to which a spare disk is assigned, then the spare disk will be
configured to the new unit (if it is not a RAID 0 unit). One spare disk
can be assigned to multiple drive groups. Ensure that the size of the
spare disk is at least equal to the size of the smallest drive in the
drive group.
See the following example for the correct format:
/SPARE=(disk_number[,...])
|
/STRIPE_SIZE=size
Specifies the new stripe size for a given RAID volume. Stripe size must
be one of the following values: 8, 16, 32, 64, 128, and 256. Raid 5 and
ADG are limited to a maximum 64 KB stripes.
Note
The /STRIPE_SIZE qualifier can be used only with the /MIGRATE
qualifier.
|
/VERBOSE
Provides logging that can be interpreted by engineering.
restrictions
The following restrictions are there for the MSA utility SET UNIT
command:
- The /RAID_LEVEL and /STRIPE_SIZE qualifiers can be used only with
the /MIGRATE qualifier.
- The /DISK qualifier can be used only with the /EXPAND qualifier.
- The /SIZE qualifier can be used only with the /EXTEND qualifier.
Note
The /EXTEND, /EXPAND, and /MIGRATE qualifiers can be used only with SET
UNIT command to change the attributes of an existing unit.
|
Examples
This command modifies unit 0 and enables the use of the array
accelerator for unit 0.
| #2 |
SET UNIT 0/EXPAND/DISK=(0,1,2,3)
|
This command increases the number of disks used by unit 0 and all the
other units on the disk group.
| #3 |
MSA> SET UNIT 0/SPARE=(100,101)
|
This command specifies that unit 0 and all the other units on the disk
group are spares.
| #4 |
MSA> SET UNIT 0/MIGRATE/RAID_LEVEL=1/STRIPE_SIZE=64
|
This command migrates the RAID level and the stripe size to 64 KB.
| #5 |
MSA> SET UNIT 0/EXTEND/SIZE=6GB
|
This command increases the size of Unit 0. The other units on the disk
group may go into volume expansion state.
Note
The size of a UNIT cannot be decreased using the SET UNIT command.
|
| #6 |
MSA> SET UNIT 0/ID=100
|
This command sets the identifier for unit 0 to 100.
| #7 |
MSA> SET UNIT 0/DEL_SPARE=(1,2)
|
If unit 0 has spare disks 1, 2, and 3, then this command removes the
disks 1 and 2 from the spare disk list. Hence, unit 0 will have only
disk 3 as spare disk.
| #8 |
MSA> SET UNIT 0/DEL_SPARE=(1,2,3)
|
If unit 0 has spare disks 1, 2, and 3, then this command removes all
the specified disks 1, 2 and 3 from the spare disk list in a disk group.
SHOW CONNECTIONS
Format
SHOW CONNECTIONS / <qualifiers>
Displays the worldwide name, connection name, and profile of each host
bus adapter (HBA) attached to the controller. If connections between
the HBAs and the MSA utility have been given user-defined names, these
names are also displayed.
Note
The SHOW CONNECTIONS command is applicable only to the MSA utility and
not Smart Array controllers.
Use the SHOW CONNECTIONS command to verify that all connections to the
MSA utility are recognized and defined.
|
Parameters
None
Qualifiers
/VERBOSE
Provides logging that can be interpreted by engineering.
Example
|
MSA> SHOW CONNECTIONS
Connection Name: abc
Host WWNN = 50060b00-001d25b5
Host WWPN = 50060b00-001d25b4
Profile Name = Default
Unit Offset = 0
Controller 1 Port 1 Status = Online
Controller 2 Port 1 Status = Online
|
This command shows the name of a specific connection to display.
|
