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's
user name and chap to discover 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.
Showing 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
Showing target discovery from I/O group 3 using
an IPv6 address with a target iSCSI controller and source port ID 1
detectiscsistorageportcandidate –srcportid 3 -targetip6 IP3 -iogrp 3 –username delluser –chapsecret password1
The
detailed resulting output:
No feedback