HP StorageWorks 7110 - Virtual Array Guide

Using VADIAG on HP-UX
1
Using VADIAG on HP-UX
This document describes the VADIAG (Virtual Array) commands supported in the offline
diagnostic environment (ODE) for HP-UX systems.
VADIAG Command Summary
The following table lists the VADIAG commands and their brief descriptions.
Command Description
ARRAYINDEX Selects the specified array for testing.
CLRLOG Clears the logs of either the selected controller or disk.
CREATELUN Adds a LUN to the selected array.
DELETELUN Removes a LUN from the selected array.
DESCRIBE Displays configuration information for the selected array.
DISPFILES Displays the firmware images found on the ODE media.
DISPMAP Displays the arrays connected to the specified bus.
DISPVOLSET Displays the disk volume set serial number.
DISKINFO Displays revision information for the selected array and disks installed in each
JBOD enclosure.
DISKSTATE Displays the state of the disks installed in the array enclosures (including the
Map disks).
DOWNLOAD Downloads the image file to the specified array controller, disk, or JOBOD LCC.
ENCLOSURE Selects the JBOD enclosure connected to the selected array.
FRU Selects the specified component either for testing or to get information from.
FORMAT Formats either the array subsystem or a disk.
HELP Lists either all VADIAG commands or detailed information for a specified
command.
INQUIRY Displays SCSI Inquiry data for the selected array controller, disk, or JBOD
controller.
LCCINFO Displays information about the JBOD LCCs connected to the array.
LOOPPAIR Selects the controller loop pair.
RANGE Selects a range of blocks to be tested by ROMT and WRTMT.
READLOG Reads the logs of the specified controller or disk.

2VADIAG Command Summary
RECOVER Reconstructs data mapping and array configurations.
REQSENSE Displays SCSI Sense data for the selected array controller, disk, or JBOD
controller.
RESETARRAY Resets the selected array.
ROMT Performs a read only test on the selected disk.
SETOPTIONS Displays and modifies SCSI mode parameters for the selected array controller.
SHOWENV Displays the current settings for these variables: CONTROLLER, ENCLOSURE,
LOOPPAIR, RANGE, SLOT, and TESTDEVICE.
SHUTDOWN Puts the selected array in the shutdown state.
SLOT Selects the specified disk for testing.
TESTDEVICE Selects the specified controller, disk, or JBOD LCC for testing.
UNSETVARS Unsets these variables: DISK, ENCLOSURE, LOOPPAIR, SLOT, and
TESTDEVICE.
UTILINFO Displays an example of VADIAG commands.
WRTMT Performs a destructive write/read test on the selected disk.
Command Description

ARRAYINDEX 3
Using VADIAG on HP-UX
ARRAYINDEX
Selects the array to be tested
Syntax
arrayindex [arrayindex]
Description
This command sets the ARRAYINDEX variable to an array controller’s device index number. The
array controller is chosen from the numbers displayed by the dispmap command. The
ARRAYINDEX variable is an index to the array to be tested, while the LOOPPAIR,
ENCLOSURE, and SLOT variables select the appropriate component within the array.
Changing the value of ARRAYINDEX causes the value of LOOPPAIR, ENCLOSURE, and SLOT
to be set to NOT SET. You must set these variables to an appropriate value.
Options
arrayindex – A device index number returned by the dispmap command.
Examples
To display the current value of ARRAYINDEX:
VADIAG> arrayindex
ArrayIndex: 0
To set the value of ARRAYINDEX to the array controller whose device index number is 1.
VADIAG> arrayindex 1

4CLRLOG
CLRLOG
Clears device logs.
Syntax
clrlog
Description
This command clears the selected device logs. Use either the testdevice or fru command to select
controller or disk logs within the array.
Example
VADIAG> clrlog

CREATELUN 5
Using VADIAG on HP-UX
CREATELUN
Creates a Logical Unit Number (LUN).
Syntax
createlun
Description
This command creates a LUN on the selected array, which provides a virtual disk to the host.
Examples
To create a LUN:
VADIAG> createlun
Do you want to create a Snapshot LUN (y/[n])? n
Enter the number of the LUN to create: 7
Enter the LUN size in the form <capacity>MB or <capacity>GB: 10MB
LUN 7 was successfully created.
To create a snapshot LUN:
VADIAG> createlun
Do you want to create a Snapshot LUN (y/[n])? y
Enter the number of the Snapshot LUN to create: 8
Enter the number of the Snapshot Parent LUN: 7
LUN 8 was successfully created.

6DELETELUN
DELETELUN
Deletes a Logical Unit Number (LUN).
Syntax
deletelun
Description
This command deletes a LUN on the selected array. All information stored on the LUN is lost and
the previously used physical storage is freed.
Example
VADIAG> deletelun
Enter the number of the LUN to delete: 8
*************************************************************************
* D A T A L O S S W A R N I N G!
*************************************************************************
* Continuing with DELETELUN WILL DEFINITELY RESULT IN DATA LOSS. All
* information stored on the LUN to be deleted will be lost and the
* physical storage previously used will be freed.
***********************************************************************
LUN 8 Selected.
Delete selected LUN (y/[n])? y
LUN 8 was successfully deleted.

DESCRIBE 7
Using VADIAG on HP-UX
DESCRIBE
Displays configuration information for an array.
Syntax
describe [-c [FruLocation] | -d [FruLocation] | -e [FruLocation] | -f | -l [LUN] | -s | -m | -?]
Description
This command displays configuration information for the selected array. Use the arrayindex
command to select the array.
Options
This command supports the following options:
-c FruLocation Display controller information, or display information for the controller
identified by FruLocation.
-d FruLocation Display disk information, or display information for the disk identified by
FruLocation.
-e FruLocation Display enclosure information, or display information for the enclosure
identified by FruLocation.
-f Display a summary of all elements in the array.
-l LUN Display the current LUN information, or display information for the LUN
identified by LUN.
-m Display the missing disks (use -v for verbose mode).
-s Display miscellaneous subsystem settings.
-? Display expanded usage message.
Examples
To display information for the array controllers:
VADIAG> describe -c
To display information for disk 2 in the main enclosure:
VADIAG> describe -d m/d2

8DESCRIBE
To display configuration information for the selected array:
VADIAG> describe
ARRAY INFORMATION
Vendor ID: HP
Product ID: A6188A
Array WWN: 0x50060B0000000000
Array Serial Number: 00usp1001027
Alias: daveg_cass
ARRAY INFORMATION
Array State: System Warning
Firmware Version: 38370HP01P0330010935
Product Revision: IJMTU00004
CAPACITY USAGE (MB=2^20):
Total Disk Enclosures: 1
Total Disks 7
Total Physical Size: 170893 MB
Allocated to Non-SnapShot LUNs: 15360 MB
Configured as SnapShot LUNs: 15360 MB
Used as Active Hot Spare: 68359 MB
Used by Non-Included Disks: 0 MB
Used for Redundancy: 61880 MB
Unallocated (avail for LUNs): 9934 MB
THE FOLLOWING WARNING(S) EXIST:
GBIC Problem

DISPFILES 9
Using VADIAG on HP-UX
DISPFILES
Displays firmware information.
Syntax
dispfiles
Description
This command displays a list of all the firmware files found on the LIF (Logical Interchange
Format) volume. The list contains the following information:
•File name. Firmware file’s name.
•Intended Product ID. Firmware file's intended product.
•Rev. New revision contained in the firmware file.
•Size. Exact byte size of the firmware image.
Example
VADIAG> dispfiles

10 DISPMAP
DISPMAP
Displays the device map.
Syntax
dispmap
Description
This command displays a list of all the array controllers found on the system. The list includes the
following fields:
•Array Indx. Device index number which is used by other VADIAG commands to reference a
specific array controller. An asterisk (*) next to this field indicates this controller is selected for
testing.
•Path. Logical path to each array. The path construct is the same as the PDC and MAPPER's
path. An array with dual controllers has two different logical paths. Therefore, two different
device index numbers will access the same array.
•Product ID. Product identification. This is what MAPPER displays as the product string.
•Rev. The disk drive’s firmware revision.
•Size. The approximate size of the LUN in either megabytes (MB), gigabytes (GB), or terabytes
(TB). The size of the LUN might not match the information specified by the vendor because of
differences in calculation methods.
Example
VADIAG> dispmap
Array
Indx Path Product ID Rev Size
---- --------------------- --------------------------- ----- ------
* 0 8/4.8.0.108.0.0.0 HP A6188A Disk Array (Ctrl) HP01 10 GB