Using VADIAG on HP-UX This document describes the VADIAG (Virtual Array) commands supported in the offline diagnostic environment (ODE) for HP-UX systems. Using VADIAG on HP-UX 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.
Command Description 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.
ARRAYINDEX Selects the array to be tested Syntax arrayindex [arrayindex] 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.
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.
CREATELUN Creates a Logical Unit Number (LUN). Syntax createlun Using VADIAG on HP-UX 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 MB or GB: 10MB LUN 7 was successfully created.
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.
DESCRIBE Displays configuration information for an array. Syntax describe [-c [FruLocation] | -d [FruLocation] | -e [FruLocation] | -f | -l [LUN] | -s | -m | -?] Using VADIAG on HP-UX 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.
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 LUN
DISPFILES Displays firmware information. Syntax dispfiles Using VADIAG on HP-UX 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.
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.
DISPVOLSET Displays internal disk volume set serial number. Syntax dispvolset This command displays a table that includes the internal disk’s FRU, storage type, state, firmware revision, capacity, and volume set serial number. The storage type (Map/User column) indicates if the disk is used for user data storage (US), meta data storage (MS) (Map Disk), or both.
DISKINFO Returns device revision information. Syntax diskinfo Description This command returns basic revision information about the controller and all recognized disks within the selected array. Additional revision information might be available using the inquiry command. The storage type (Map/User column) indicates if the disk is used for user data storage (US), meta data storage (MS) (Map Disk), or both. The EID column shows the enclosure ID.
DISKSTATE Displays the physical disk drive map. Syntax diskstate This command displays the state of the selected controller and the state of the disk drives located in the main enclosure. The storage type (Map/User column) indicates if the disk is used for user data storage (US), meta data storage (MS) (Map Disk), or both. The EID column shows the enclosure ID. An asterisk (*) in the Disk Slot column indicates the selected disk slot.
DOWNLOAD Downloads firmware to the array controller or the disk drive. Syntax download Description This command transfers the image contained in the selected firmware file to either the array controller or internal disk. The fru command selects which device is issued the download. This command warns you if the firmware file is not compatible with the selected array.
ENCLOSURE Sets the enclosure ID. Syntax enclosure [enclosure ID] This command sets the ENCLOSURE variable which is used to access JBOD LCCs and disks. The ENCLOSURE variable along with the LOOPPAIR and SLOT variables identify the component of interest. The ENCLOSURE variable should always be set to a value of 0.
FORMAT Formats the array subsystem or an internal disk. Syntax format Description This command formats the entire array subsystem or an internal disk. A subsystem format is rejected if any LUNs exist.
FRU Selects components for testing. Syntax fru [fru] This command selects a component (for example, disk or controller) for testing. For the selected component, it sets the correct values for the LOOPPAIR, ENCLOSURE, SLOT, and TESTDEVICE variables. You can manually set these variables, but it is much easier and less error prone to use the fru command.
INQUIRY Returns SCSI Inquiry data (all pages). Syntax inquiry Description This command returns SCSI Inquiry data on the selected FRU. You can select a controller, a disk, or a JBOD LCC with the testdevice or fru command.
LCCINFO Displays information about the JBOD LCCs connected to the array. Syntax lccinfo This command displays information about the JBOD LCCs connected to the array. The EID column shows the enclosure ID. A value of 0xFF in the Slot column indicates that the lccinfo command could not determine the LCC’s slot location. An asterisk (*) in the Slot column indicates the selected LCC.
LOOPPAIR Sets the controller loop pair. Syntax looppair [loop pair] Description This command sets the LOOPPAIR variable which is used to access JBOD LCCs and disks. The LOOPPAIR variable along with the ENCLOSURE and SLOT variables identify the component of interest. The LOOPPAIR variable should always be set to a value of 255.
RANGE Selects blocks for testing by the ROMT and WRTMT commands. Syntax range [start_block/[end_block]],[start_block/[end_block]],... This command selects multiple blocks for testing by the romt and wrtmt commands. The value of the RANGE variable identifies the selected blocks.
READLOG Reads device logs. Syntax readlog Description This command returns the selected internal device logs. You can select controller logs or disk logs using the testdevice or fru command.
RECOVER Reconstructs data mapping and array configuration. Syntax recover This command instructs the target to attempt to reconstruct data mapping and array configuration information from the physical drives after the loss of NVRAM contents. The recover operation also performs a parity scan to correct any drive parity inconsistencies. This command is typically used when the subsystem is in the No Map state. The readlog command can be used to help evaluate the results after using the recover command.
REQSENSE Returns SCSI Sense data. Syntax reqsense Description This command returns SCSI Sense data on the selected FRU. You can select a controller, a disk, or a JBOD LCC with the testdevice or fru command.
RESETARRAY Issues a hard reset to the array. Syntax resetarray Using VADIAG on HP-UX Description This command causes the array to perform a hard reset.
ROMT Performs a read test. Syntax romt Description This command performs a read-only test on the selected disk. It is designed to test only internal disks and not the array itself. Use either the enclosure, looppair, and slot commands or the fru command to select the disk for testing. Pressing either Ctrl-c or Ctrl-y causes the test to abort.
SETOPTIONS View and modify SCSI Mode parameters. Syntax setoptions Using VADIAG on HP-UX Description This command returns SCSI mode sense parameters on the selected array and enables you to modify changeable parameters.
SHOWENV Displays the current environment variable settings. Syntax showenv Description This command displays the current value of these environment variables: ARRAYINDEX, TESTDEVICE, LOOPPAIR, ENCLOSURE, SLOT, RANGE, and FRU.
SHUTDOWN Puts the array into the shutdown state. Syntax shutdown Using VADIAG on HP-UX Description This command requests that the array stop normal I/O operation and save all map information to physical drive storage.
SLOT Sets the disk slot. Syntax slot [slot] Description This command sets the SLOT variable which is used to access the main enclosure disks. The SLOT variable along with the LOOPPAIR and ENCLOSURE variables identify the component of interest. It might be easier to use the fru command to identify the component because it automatically sets the LOOPPAIR, ENCLOSURE, and SLOT variables. In ODE, the main enclosure disk slots (1-15) are in the range of 16 through 30.
TESTDEVICE Selects devices for testing. Syntax testdevice [controller | disk | lcc] This command selects either the controller, disk, or JBOD LCC as the device to test and where the command can be executed by any one of the devices. If only the controller can execute the command, then the TESTDEVICE variable will not have any meaning because the command will still go to the controller even if TESTDEVICE is set to the disk.
UNSETVARS Unsets all environment variables. Syntax unsetvars Description This command lets you unset (or clear) the following environment variables: TESTDEVICE, LOOPPAIR, ENCLOSURE, SLOT, RANGE, and FRU. The variables are changed to a NOT SET condition.
UTILINFO Utility Information. Syntax utilinfo Using VADIAG on HP-UX Description This command describes how to run VADIAG in some scenarios.
WRTMT Performs a write/read test. Syntax wrtmt Description This command performs a write-then-read test on the selected disk. It is designed to test only internal disks and not the array itself. Use either the enclosure, looppair, and slot commands or the fru command to select the disk for testing. Pressing either Ctrl-c or Ctrl-y causes the test to abort. WARNING! This is a destructive command and can cause data loss.
