HP OpenVMS System Management Utilities Reference Manual


Previous Contents Index

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 
      

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:

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.

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.


Previous Next Contents Index