lsiscsistorageportcandidate

Use the lsiscsistorageportcandidate command to list information about the candidate Internet Small Computer Systems Interface (iSCSI) target controller iSCSI Qualified Name (IQN) that is specified with the target IP from the specified initiator source ports.

Syntax

 lsiscsistorageportcandidate    [  -nohdr  ]   [  -delim  delimiter  ]  

Parameters

-nohdr
(Optional) By default, headings are displayed for each column of data in a concise style view, and for each item of data in a detailed style view. The -nohdr parameter suppresses the display of these headings.
Note: If there is no data to be displayed, headings are not displayed.
-delim delimiter
(Optional) By default in a concise view, all columns of data are space-separated. The width of each column is set to the maximum width of each item of data. In a detailed view, each item of data has its own row, and if the headers are displayed, the data is separated from the header by a space. The -delim parameter overrides this behavior. Valid input for the -delim parameter is a 1-byte character. If you enter -delim : on the command line, the colon character (:) separates all items of data in a concise view; for example, the spacing of columns does not occur. In a detailed view, the data is separated from its header by the specified delimiter.

Description

This command lists information about the last invocation of the detectiscsistorageportcandidate command. This command also lists the candidate iSCSI target controller IQNs that are visible at the specified target IP from the specified initiator ports along with indication of which initiator ports can see each discovered iSCSI target IQN.

This table provides the attribute values that can be displayed as output view data.
Table 1. lsiscsistorageportcandidate output
Attribute Description
id Indicates the row ID for the discovery output. There is one row per iSCSI qualified name (IQN) that you can view by using the target IP address that is specified in detectiscsistorageportcandidate.
src_port_id Indicates the source port ID. The value is a number 1 - 8.
target_ip Indicates the target IPv4 address.
target_ip6 Indicates the target IPv6 address.
target_iscsiname Indicates the (discovered) IQN that uses the target controller. The value is an alphanumeric string that is 256 characters long.
iogroup_list Indicates a colon-separated list of discovery result codes: The value must be an alphanumeric string of up to 32 characters. This field cannot be blank. The values are 0 and 1:
  • 0 indicates that the I/O group is available in the system, but discovery is either not triggered through the I/O group or discovery through the I/O group fails.
  • 1 indicates that the I/O group is present and discovery is successful through the I/O group.
Note: The value - (dash) indicates that the I/O group is not valid or is not present in the system.
status Indicates whether discovery was successful. The values are:
  • full
  • partial
  • none
configured Indicates whether the discovered target IQN has any established sessions with source ports or target ports. The values are yes and no (default).
site_id Indicates the site ID (if the nodes that are being discovered belong to a site). This applies to HyperSwap® systems.
site_name Indicates the site name (if the nodes that are being discovered belong to a site). This applies to HyperSwap® systems.

An invocation example

First you must specify target discovery by using an IPv4 IP address for a target ISCSI controller through the source port ID 1. No tgt_user_name or target_chap value is required.
detectiscsistorageportcandidate –srcportid 1 -targetip IP1

To view the output specify:

lsiscsistorageportcandidate

The detailed resulting output:

id  src_port_id target_ipv4 target_ipv6 target_iscsiname  iogroup_list configured status site_id site_name
0   1            IP1                            IQN1       1:1:1:1        no       Full

An invocation example

This example shows target discovery by using an IPv4 IP address for a target ISCSI controller through I/O group 0 and source port ID 0:
detectiscsistorageportcandidate -iogrp 0 –srcportid 1 -targetip IP2  –username superuser –chapsecret password2
A tgt_user_name and target_chap value are used. There are only two I/O groups in this system, 0 and 3.

To view the output specify:

lsiscsistorageportcandidate

The detailed resulting output:

id  src_port_id target_ipv4 target_ipv6 target_iscsiname  iogroup_list configured status site_id site_name
0   1       IP2                                 IQN1       1:-:-:0        no       Full
1   1       IP2                                 IQN2       1:-:-:0        no       Full
2   1       IP2                                 IQN3       1:-:-:0        no       Full