detectiscsistorageportcandidate
Use the detectiscsistorageportcandidate command to establish Internet Small Computer Systems Interface (iSCSI) login sessions from any nodes in a specified I/O group to a discovered backend iSCSI target controller.
Syntax
Parameters
- -srcportid source_port_id
- (Required) Specifies the source Ethernet port ID (indicated in the lsportethernet output) used to complete target controller discovery. The value must be a
number 1 - 8.
- If you also specify -iogrp, you trigger discovery through the Ethernet port by using the source_port_id specified on all nodes in the I/O group.
- If you do not specify -iogrp, you trigger discovery through the Ethernet port by using the source_port_id specified on all nodes in the system.
- -iogrp iogrp_id | iogrp_name
- (Optional) Specifies I/O group ID or name being detected. The iogrp_id
value must be
0
,1
,2
, or3
. The iogrp_name value must be an alphanumeric string.If you specify this parameter, you trigger discovery through the source_port_id of both nodes for the specified I/O group. If no value is specified, discovery is triggered by using the source_port_id of all nodes in the system.
- -targetip ipv4_addr
- (Required if you do not specify -targetip6) Specifies the target iSCSI controller IPv4 address being detected that receives target discovery requests by using the source_port_id for all nodes in the specified I/O group.
- -targetip6 ipv6_addr
- (Required if you do not specify -targetip) Specifies the target iSCSI controller IPv6 address being detected that receives target discovery requests by using the source_port_id for all nodes in the specified I/O group.
- -username target_user_name
- (Optional) Specifies the target controller user name being detected. The value must be an
alphanumeric string up to 256 characters.
If the target controller requires a target_user_name and target_chap for discovery, use the target user name and Challenge-Handshake Authentication Protocol (CHAP) secret to discover the iSCSI target controller.
Some controllers might require that you use the iSCSI qualified name (IQN) user name for discovery. Each nodes IQN is picked up automatically and used if required.
- -chapsecret target_chap
- (Optional) Specifies the target_chap required for discovery of the target iSCSI controller that is being detected. The value must be an alphanumeric string (case-sensitive) up to 79 characters.
- -site site_id | site_name
- (Optional) Specifies the site ID or site name of the target iSCSI controller that is being
detected or discovered. If no I/O group is specified, discovery is done from all nodes present in
the specified site and if an I/O group is specified discovery is done only from a node that is part
of the specified site and I/O group. The site ID must be
1
(the default) or2
. The site name must be an alphanumeric value.
Description
This command detects iSCSI backend storage controllers for migration and virtualization. This command helps with target iSCSI controller discovery. Use the lsiscsistorageportcandidate command to list information about the discovered candidate iSCSI target controller(s).
The target data is available until either another discovery is completed or the system undergoes a recovery procedure, which clears the previous discovery data. The command completes when either discovery from all source nodes completes or the command fails.
Use the addiscsistorageport command to establish sessions from any nodes in a specified I/O group to a discovered backend iSCSI controller. Use the lsiscsistorageportcandidate command to list information about the candidate iSCSI target controller.
A target discovery invocation example with IP address
This example shows
target discovery using an IPv4 IP address with a target ISCSI controller and source port ID
1
.
detectiscsistorageportcandidate -srcportid 1 -targetip IP1
The detailed resulting output:
No feedback