lsiscsistorageportcandidate

Use the lsiscsistorageportcandidate command to display a concise or detailed list of 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  ] [ {  -node  {  node_id  |  node_name  }   } ] [  lsiscsistorageportcandidate-rowid   ]

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 no data is available to be displayed, headings are not displayed.
-node node_name | node_id
(Optional)

Specifies the ID or name of a node in the system. The value must be an alphanumeric string.

-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.
lsiscsistorageportcandidate-rowid
(Optional) Specifies a row ID shown in the concise view to provide a detailed view of information about discovered portal IPs.

Description

This command lists information about the last invocation of the detectiscsistorageportcandidate command. This command can also display two types of lists:
  • A concise list of information about 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.
  • The detailed information about all the Target Controller Portal IPs discovered during the last invocation of the detectiscsistorageportcandidate command.
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. Enter the detectiscsistorageportcandidate command before you use the lsiscsistorageportcandidate command. Display the concise view first to show one row per IQN. Use a row ID from the concise view to specify the detailed view of the lsiscsistorageportcandidatelsiscsistorageportcandidate-rowid command. The detailed view displays the list of discovered target IP addresses for the IQN.
src_port_id Indicates the source port ID. The value is a number 1 - 8.
target_ipv4 Indicates the target IPv4 address.
target_ipv6 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 status is one of the following values:
  • 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 attribute applies to HyperSwap systems.
site_name Indicates the site name (if the nodes that are being discovered belong to a site). This attribute applies to HyperSwap systems.
SendTargets Portal IPs Provides list of all the (Maximum 32) discovered Target Portal IPs by using the detectiscsistorageportcandidate command.

A concise 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 10.10.10.1

To view the output, specify the following command:

lsiscsistorageportcandidate

The following concise resulting output is displayed:

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

A concise 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. This system has only two I/O groups, 0 and 3.

To view the output, specify the following command:

lsiscsistorageportcandidate

The following concise resulting output is displayed:

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

A detailed 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 and a target IP address.
detectiscsistorageportcandidate –srcportid 1 -targetip 10.10.10.1

The concise view has one row per IQN as shown in the first concise view example. Each row ID from the concise view identifies an iSCSI qualified name (IQN). To view detailed information for the IQN, specify the row ID (id):

lsiscsistorageportcandidate 0

The resulting output lists details of the discovered portal IP addresses for the IQN:

SendTargets Portal IPs
10.10.10.1
10.10.10.2
fe:65::00:01
fe:65::00:02