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

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

A target discovery invocation example with user name and CHAP secret

This example shows target discovery using initiator node user name and CHAP secret.

detectiscsistorageportcandidate –srcportid 2 -targetip 192.168.54.13 -node node1 -username xmen1 -chapsecret vd1

The resulting output:

No feedback