-C H A P T E R

C H A P T E R 6

Sun Fire

V880 FC-AL Disk Backplane Test (dpmtest)

dpmtest exercises and verifies the Fibre-Channel Mass Storage Subsystem in Sun Fire V880 product line platforms. dpmtest exercises various tests in the Fibre-Channel Backplane firmware for validating the mass storage system.

No special hardware is required to run the dpmtest test.

dpmtest Options

To reach the dialog box below, right-click on the test name in the System Map and select Test Parameter Options. If you do not see this test in the System Map, you might need to expand the collapsed groups, or your system may not include the device appropriate to this test. Refer to the SunVTS User's Guide for more details.

FIGURE 6-1 dpmtest Test Parameter Options Dialog Box

Screenshot of the dpmtest Test Parameter Options dialog box.

TABLE 6-1 `dpmtest` Test Options
Option	Description
Firmware Test	When enabled, the subtest runs the system friendly firmware tests on each of the selected SES/SSC100 devices. By default it is enabled.
Loopback Test	When Enabled, the subtest will cause the SES device to loop packets around the fiber loop with varying data patterns. The device reads the packet after the packet is received, and verifies that the data payload is correct. By default it is enabled.Note: This test will run only on SES/SSC100 devices which are in the base backplane.
Devices to Test	The SES/SSC100 devices being tested. Users have an option to select or deselect each device for being tested. By default all the devices are selected for testing.Note: At least one device has to be selected for testing. If the user tries to deselect all of the devices, then an error message will be popped up.Note: If the device has both fibre and i2c paths, only the fibre path is listed under 'Devices to Test'. When you perform the tests on this device, the tests are run on both fibre and i2c paths.

dpmtest Test Modes

TABLE 6-2 `dpmtest` Supported Test Modes
Test Mode	Description
Connection	The test opens each selected device, extracts information about the device (wwn/wwpn, firmware revision, drives installed, temperatures, etc.) and displays the information for the user. If the device has both fibre and i2c paths, then information will be extracted from both the paths. After the test is performed on all the selected devices, the test closes the devices and exists.
Functional	The test opens each selected device and runs the selected subtests against the device. When fully run, the test closes the device and reports the results.Note: When no subtests are selected and you try to perform the functional testing, then just a configuration check will be performed.

dpmtest Command-Line Syntax

/opt/SUNWvts/bin/dpmtest standard_arguments -0 dev=[device name],
dpmdev=[device1+device2+...], fwtest=[Enable|Disable], lb=[Enable|Disable]

TABLE 6-3 `dpmtest` Command-Line Syntax
Argument	Description
`-o dev=`[device name]	[device name] is the path name of the device being tested. The default value is ses. Since the current SunVTS infrastructure doesn't allow specifying multiple devices under the `dev` suboption, this suboption is not used in `dpmtest`. A new suboption dpmdev has been introduced to satisy this requirement.
`dpmdev=`[device1+device2...]	device1, device2,... represent the SES/SSC100 devices being tested. The default value is all the SSC100s present in the system.Note: The values for the `dpmdev` suboption can be device names such as `ses0`, `ses1`, `ssc100@16`, `ssc100@1a`, etc. Multiple values can be specified with a '+' (plus sign) seperator. An absolute path through fibre paths to devices are allowed (for expample, `/dev/es/ses0`) as `dpmdev` suboption values. However, absolute paths through a i2c path to devices are not allowed because commas are not allowed as part of a suboption value. Commas delimit suboptions in the options string (for example, `/devices/pci@9`, `700000/ebus@1/i2c@1`, `30/controller@0`, `16:ssc100`). Note: The following devices may be specified for the `dpmdev` suboption values in the Sun Fire V880 product line platforms: Fibre Path: `ses0` - fibre path to base backplane's SSC100 (`/dev/es/ses0`) device on loopA. `ses1` - fibre path to base backplane's SSC100 (`/dev/es/ses1`) device on loopB. This is valid only when a PCI FC Network Adapter is connected to loopB. I2C Path: `ssc100@16` - base backplane's SSC100 device on loopA through a `i2c` path. `ssc1001a` - base backplane's SSC100 device on loopB through a `i2c` path. `ssc1001e` - expansion backplane's SSC100 device on loopB through a `i2c` path. Note: The exact fibre path device node names (`ses0`, `ses1`, etc..) may vary depending on device nodes created in the system. The valid fibre path device nodes, that `dpmtest` found during probing, can be found under 'Devices to Test' in the `dpmtest` Test Parameter Options dialog box.
`lb=`[Enable\|Disable]	Enable or Disable loopback test. The default value is Enable. Note: The loopback test will run only on SES/SSC100 devices that are in the base backplane.
`fwtest=`[Enable\|Disable]	Enable or Disable firmware tests. The default value is Enable.