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
detectiscsistorageportcandidate -–srcportid source_port_id [ -iogrp { iogrp_id | iogrp_name } ] { -targetip ipv4_addr | -targetip6 ipv6_addr } [ -username target_user_name ] [ -chapsecret target_chap ] [ -site { site_id } site_name ]
Parameters
- -srcportidsource_port_id
- (Required) Specifies the source Ethernet port ID (indicated in the
lsportip 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
clustered system (system).
- -iogrpiogrp_id | iogrp_name
- (Optional) Specifies I/O group ID or name being detected. The iogrp_id
value must be 0, 1, 2, or
3. 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.
- -targetipipv4_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.
- -targetip6ipv6_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.
- -usernametarget_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.
- -chapsecrettarget_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.
- -sitesite_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) or 2. The site name must be an alphanumeric value.
Important: This parameter must be specified
for a HyperSwap
system.
In a HyperSwap topology,
configured I/O groups at each site require a license to the use mirroring functions.
Additionally, storage controller discovery can be accomplished only from nodes within the
same site.
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
A target discovery invocation example with source port ID and
I/O group
This example shows target discovery from I/O group 3 using
an IPv4 address with a target iSCSI controller and source port ID
3.
detectiscsistorageportcandidate –srcportid 3 -targetip IP3 -iogrp 3 –username delluser –chapsecret password1
The
detailed resulting output:
No feedback