Diagnose controller iSCSI host cable

The diagnose controller iscsiHostPort command runs diagnostic tests on the copper cables between iSCSI host interface cards and a controller.

Supported Arrays

This command applies to an individual DE2000H, DE4000H, DE4000F, DE6000H, or DE6000F storage array.

Roles

To execute this command on an storage array, you must have the Storage Admin role.

Context

You can run diagnostics on a selected port or all ports. The ports must be able to support the cable diagnostics. If the ports do not support cable diagnostics, an error is returned.

Syntax

diagnose controller [(a|b)] 
iscsiHostPort ([all] | [portLabel]) 
testID=cableDiagnostics

Parameters

Parameter Description
controller The controller on which you want to run the cable diagnostic test. Valid controller identifiers are a or b , where a is the controller in slot A , and b is the controller in slot B . Enclose the controller identifier in square brackets ([ ]). If you do not specify a controller, the storage management software returns a syntax error.
iscsiHostPort

The iSCSI host port on which you want to run the diagnostic tests. You can run the diagnostics on all iSCSI host ports, or you can run the diagnostics on a specific iSCSI host port.

See the following for more information:

Identifying an iSCSI host port label
testID The identifier for the diagnostic test that you want to run. For this diagnostic test, the only choice is cableDiagnostics .

Identifying an iSCSI host port label

You must specify a label for the host port. Follow these steps to specify the host port label:

  1. If you do not know the port label for the iSCSI host port, run the

    show controller command.
  2. In the Host interface section of the results, locate the host port you want to select.

    Note: The port label is the complete value returned for the Port field.
  3. Enclose the entire value of the port label in both quotes and square brackets: ["

    portLabel "]. For example, if the port label is Ch 2 , specify the iSCSI host port as follows:
    
    						iscsiHostPort[\"ch 2\"]
    					
    Note: If you are using a Windows command line and the label contains a pipe (|), the character should be escaped (using ^); otherwise, it will be interpreted as a command. For example, if the port label is e0b|0b , specify the iSCSI host port as follows:
    
    						iscsiHostPort[\"e0b^|0b\"]
    					

Notes

When you run the cable diagnostic test, the firmware returns the following information: