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 } ] [ -username target_user_name ] [ -chapsecret target_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