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


MSA> SCAN ALL

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

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
#1
MSA> SET UNIT 0/CACHE
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.

#1
MSA> SET UNIT 0/CACHE

#2
SET UNIT 0/EXPAND/DISK=(0,1,2,3)

#3
MSA> SET UNIT 0/SPARE=(100,101)

#4
MSA> SET UNIT 0/MIGRATE/RAID_LEVEL=1/STRIPE_SIZE=64

#5
MSA> SET UNIT 0/EXTEND/SIZE=6GB

#6
MSA> SET UNIT 0/ID=100

#7
MSA> SET UNIT 0/DEL_SPARE=(1,2)

#8
MSA> SET UNIT 0/DEL_SPARE=(1,2,3)

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

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.

Contents

Index

HP OpenVMS System Management Utilities Reference Manual

READ FIRMWARE

Format

Parameters

firmware file name

Qualifiers

/VERBOSE

RESET THIS_CONTROLLER

Format

Parameters

CONTROLLER_TYPE

Qualifiers

/VERBOSE

Example

RESET OTHER_CONTROLLER

Format

Parameters

CONTROLLER_TYPE

Qualifiers

/VERBOSE

Example

SCAN ALL

Format

Parameters

Qualifiers

Example

SET CONTROLLER

Format

Parameters

Qualifiers

/DEFAULT

/VERBOSE

Example

SET GLOBALS

Format

Parameters

Qualifiers

/EXPAND_PRIORITY=(LOW | MEDIUM | HIGH)

/READ_CACHE=value

/REBUILD_PRIORITY=(LOW | MEDIUM | HIGH)

/WRITE_CACHE=value

/SYSTEM_NAME=name

/VERBOSE

Example

SET UNIT

Format

Parameters

unit_n

Qualifiers

/ADG

/CACHE

/DEL_SPARE

/DISK

/EXPAND

/EXTEND

/IDENTIFIER

/JBOD

/MIGRATE

/RAID_LEVEL=level

/SIZE=size

/SPARE

/STRIPE_SIZE=size

/VERBOSE

restrictions

Examples

SHOW CONNECTIONS

Format

Parameters

Qualifiers

/VERBOSE

Example