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.
Attribute | Description |
---|---|
id | Indicates the row ID for the discovery output. There is one row per iSCSI qualified name (IQN) that can be viewed using the target IP address 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:
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:
|
configured | Indicates whether the discovered target IQN has any established sessions with source ports or target ports. The values are yes and no (default). |
An invocation example
First you must specify target discovery using an IPv4 IP address for a target ISCSI controller
through the source port ID 1. No tgt_user_name or
target_chap value are 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