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