addiscsistorageport

Use the addiscsistorageport command to establish Internet Small Computer Systems Interface (iSCSI) login sessions from any (or all) nodes in a specified I/O group (or the entire clustered system) to a discovered backend target iSCSI controller.

Syntax

Parameters

-iogrp iogrp_id | iogrp_name

(Optional) Specifies I/O group ID or name that is added. The iogrp_id value must be 0, 1, 2, or 3. The iogrp_name value must be an alphanumeric string.

Specifying this parameter triggers discovery through both nodes for the specified I/O group. The port number on each node (used to establish a session) is displayed in the selected row of discovery results from specifying detectiscsistorageportcandidate.

-username target_user_name

(Optional) Specifies the target controller user name that is added. 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, the user name for the target controller must be specified.

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 Challenge-Handshake Authentication Protocol (CHAP) secret, target_chap, that is required for discovery of the target iSCSI controller that is being added. The value must be an alphanumeric string (case-sensitive) up to 79 characters. This keyword is required if -username is specified.

-site site_id | site_name

(Optional) Specifies the site ID or site name of the host that is being detected. The site ID must be 1 (the default) or 2. The site name must be an alphanumeric value.

candidate_id

(Required) Indicates the row ID indicating the selected row in the lsiscsistorageportcandidate output.

Description

This command establishes iSCSI login sessions from a specified I/O group (or, if I/O group is not specified, the entire clustered system) to a discovered backend iSCSI target controller.

To use this command, you must first:

Specify detectiscsistorageportcandidate to detect or discover the backend controller target ports.
Specify lsiscsistorageportcandidate to display the discovery output and locate a unique IQN and Internet Protocol (IP) combination on the discovered iSCSI storage controller.
Specify addiscsistorageport. You can establish sessions (from all nodes in a single I/O group) to the iSCSI controller port by specifying the I/O group number of the source port that the iSCSI sessions are initiated from.

If you do not specify an I/O group, sessions are established from all nodes in the system. The source port identifier is in the discovery results. Because some iSCSI controllers represent logical unit numbers (LUNs) as IQNs and might require a different target_user_name and target_chap for every IQN, these values can also specified for authentication when establishing the session.

Note: You can use the chiscsistorageport command to add more initiator node authentication credentials.

A detailed invocation example

This example shows target discovery that uses an IPv4 IP address for a target iSCSI controller through source port ID 0. For example, first you might specify:

detectiscsistorageportcandidate -targetip 192.168.81.91  -srcportid 3 -chapsecret Vardy -site 1

You would then specify lsiscsistorageportcandidate to list iSCSI port information:


id src_port_id target_ipv4    target_ipv6 target_iscsiname   iogroup_list configured status
0  4           192.168.213.33             IQN1                1:1:1:1      yes        full

Then establish a session using addiscsistorageport for discovery output row 0.

Note: If you specify -username or -chapsecret with detectiscsistorageportcandidate during discovery, you must specify -username or-chapsecret for session establishment.

addiscsistorageport 0

The detailed resulting output:

No feedback