[an error occurred while processing this directive]

HP OpenVMS Systems Documentation

Content starts here

HP OpenVMS Version 8.3--1H1
for Integrity Servers
New Features and Release Notes


Previous Contents

SET UNIT

Modifies the attributes of existing units.

Format

SET UNIT <unit_n> / <qualifiers>


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.

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

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 to 64 KB.

#6

MSA> SET UNIT 0/ID=100
      

This command sets the identifier for unit 0 to 100.

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.

SHOW CONTROLLER

Displays information about the specified controller. If the controller name is not provided, then information of all the connected controllers is displayed.

The SHOW CONTROLLER command is synonymous with the SHOW ADAPTER command.

Note

If the context is set to a specific controller and the controller name is not provided, then SHOW CONTROLLER displays information about only the controller to which the context is set.

Format

SHOW CONTROLLER (controller_name:) / <qualifiers>


Parameters

controller_name:


Qualifiers

/BUS

Displays the bus number of the controller.

/BRIEF

Displays limited information about the controller.

/DEFAULT

Displays information about the default controller.

/NODEFAULT

Displays information about all the controllers.

/FULL

Displays extensive information about the controller.

/REVISION

Displays the firmware version of the controller, along with the default information for the controller.

/SUBSYSTEM

Displays the subsystem ID of the controller.

/VERBOSE

Provides logging that can be interpreted by engineering.

Example


                MSA> SHOW CONTROLLER

                A default controller is not set.  All matching controllers
                displayed

                Controller: _$1$GGA201:
                MSA1000     (c) COMPAQ      P56350B9IN2021 Software 4.42
                Controller Identifer: 201
                NODE_ID = 500805f3-0001b660
                SCSI_VERSION = SCSI-3
                Supported Redundancy Mode: Active/Standby
                Current Redundancy mode: Active/Standby
                Current Role: Standby
                Device Port SCSI address 6
                Host Port_1:
                     REPORTED PORT_ID = 500805f3-0001b669
                     PORT_1_TOPOLOGY = Not available to this program
                Cache:
                    102 megabyte read cache   154 megabyte write cache
                    Cache is GOOD, and Cache is enabled.
                    No unflushed data in cache.
                Battery:
                    Battery is fully charged.


                Controller: _$1$GGA300:
                MSA CONTROLLER   (c) HP      P56350GX3QN152 Software 6.72
                Controller Identifier: 300
                NODE_ID = 500508b3-00905ed0
                SCSI_VERSION = SCSI-3
                Supported Redundancy Mode: Asym Active/Active  Active/Standby
                    Current Redundancy mode: Asymmetrical Active/Active
                    Current Role: Active
                    Device Port SCSI address 7
                Host Port_1:
                    REPORTED PORT_ID = 500508b3-00905ed1
                    PORT_1_TOPOLOGY = Not available to this program
                Cache:
                    128 megabyte read cache   128 megabyte write cache
                    Cache is GOOD, and Cache is enabled.
                    No unflushed data in cache.
                Battery:
                    Battery is fully charged.


                Controller: _$1$GGA301:
                MSA CONTROLLER   (c) HP      P56350GX3QN0FS Software 6.72
                Controller Identifier: 301
                NODE_ID = 500508b3-00905ed0
                SCSI_VERSION = SCSI-3
                Supported Redundancy Mode: Asym Active/Active  Active/Standby
                   Current Redundancy mode: Asymmetrical Active/Active
                   Current Role: Active
                   Device Port SCSI address 6
                Host Port_1:
                   REPORTED PORT_ID = 500508b3-00905ed9
                   PORT_1_TOPOLOGY = Not available to this program
                Cache:
                   128 megabyte read cache   128 megabyte write cache
                   Cache is GOOD, and Cache is enabled.
                   No unflushed data in cache.
                Battery:
                   Battery is fully charged.


                Controller: _$1$GGA1002:
                MSA1000    (c) COMPAQ       P56350A9IMN06M Software 4.42
                Controller Identifier: 1002
                NODE_ID = 500805f3-0001b660
                SCSI_VERSION = SCSI-3
                Supported Redundancy Mode: Active/Standby
                   Current Redundancy mode: Active/Standby
                   Current Role: Active
                   Device Port SCSI address 7
                Host Port_1:
                   REPORTED PORT_ID = 500805f3-0001b661
                   PORT_1_TOPOLOGY = Not available to this program
                Cache:
                   102 megabyte read cache   154 megabyte write cache
                   Cache is GOOD, and Cache is enabled.
                   No unflushed data in cache.
                Battery:
                   Battery is fully charged.


                Adapter: _PKD0:
                SA6400      (c) HP       P57820FDAPHJE7 Software 1.92
                SCSI_VERSION = X3.131:1994 (SCSI-2)
                Not currently Redundant
                Current Role: Active
                (No redundant controller installed)
                Cache:
                   128 megabyte read/write cache
                   Cache is not configured, and Cache is disabled.
                   No unflushed data in cache.
                Battery:
                    Battery is not fully charged.

                Adapter: _PKE0:
                SA6400 EM     (c) HP      P577C0EDAPH3JK Software 1.92
                SCSI_VERSION = X3.131:1994 (SCSI-2)
                Not currently Redundant
                Current Role: Active
                (No redundant controller installed)
                Cache:
                    128 megabyte read/write cache
                    Cache is not configured, and Cache is disabled.
                    No unflushed data in cache.
                Battery:
                    Battery is not fully charged.
      

This command displays information about all the controllers because a default controller has not been set.

SHOW DISKS

Displays the following information on all available physical disks: disk number, enclosure bus number and ID, disk size, unit created on the disk, and disks assigned as spares.

Note

This command can be used to view information about a particular disk.

For the Smart Array P400 series of controllers, the target ID, connector, and bay are also displayed.

Format

SHOW DISKS / <qualifiers>


Parameters

None

Qualifiers

/AVAILABLE

Lists all the disks on which there are no units configured.

/FULL

Displays the drive model and the drive serial number in addition to the disk information.

Note

For the Smart Array P400 series of controllers, the following information is displayed:


Connector Location
Connector
Enclosure
Bay
WWID
Device Type
Disk Capacity
Device Status
Device Vendor ID
Device Product ID
Device Serial Number
Device Firmware Version
Reserved Area (cfg/status information)
Block Size (bytes/sector)
M&P Data Stamped
Last Failure Reason
Physical Disk Flags

/MEMBER

Displays the disks on which the units are configured.

/SPARE

Displays the disks that are configured as spares for logical units.

/VERBOSE

Provides logging that can be interpreted by engineering.

Examples

#1

MSA> SHOW DISKS
      

This command displays information about all available disks.

#2

MSA> SHOW DISK/SPARE
MSA> SHOW DISK/AVAILABLE
      

These commands display information about designated spare disks and all available disks on which no units are configured.

SHOW GLOBALS

Displays the following global parameters for the specified controller: system name, rebuild and expand-priority settings, and read and write cache settings.

Format

SHOW GLOBALS / <qualifiers>


Parameters

None

Qualifiers

/BRIEF

Displays the global parameters information about the controller.

/FULL

Displays the WWID information in addition to the global parameters.

/VERBOSE

Provides logging that can be interpreted by engineering.

Examples

#1

MSA> SHOW GLOBALS
Global Parameters:
System Name: ABC
Rebuild Priority: high
Expand Priority: high
Total Cache: 256MB
50% Read Cache: 128 MB
50% Write Cache: 128 MB
      

This command displays the global parameters for the controller.

#2

MSA> SHOW GLOBALS/FULL
MSA> SHOW GLOBALS/BRIEF
      

These commands display the WWID parameters and the global parameters for the controller.

SHOW PROFILE

Displays all the profile names.

Format

SHOW PROFILE [profile_name] / <qualifiers>


Parameters

profile_name

Displays the specifed profile name.

Qualifiers

/VERBOSE

Provides logging that can be interpreted by engineering.

Example


MSA> SHOW PROFILE
      

This command displays all profile names.


Previous Next Contents