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.
| 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 lsiscsistorageportcandidate lsiscsistorageportcandidate-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:
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:
|
| 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 stretched and HyperSwap® systems. |
| site_name | Indicates the site name (if the nodes that are being discovered belong to a site). This attribute applies to stretched and HyperSwap systems. |
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.1To view the output, specify the following command:
lsiscsistorageportcandidateThe 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 FullA 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 password2To view the output, specify the following command:
lsiscsistorageportcandidateThe 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 FullA 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.1The 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 0The 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