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
addiscsistorageport [ -iogrp { iogrp_id | iogrp_name } ] [ -usernametarget_user_name ] [ -chapsecrettarget_chap ] [ -site { site_id | site_name } ] candidate_id
Parameters
- -iogrpiogrp_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.
- -usernametarget_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.
- -chapsecrettarget_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.
- -sitesite_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.
Important: This parameter
must be specified for a HyperSwap
system.
For a HyperSwap system topology,
the site ID must be specified to make sure that attempts to establish a session are made from
nodes in the same site as the iSCSI storage controller.
- 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