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 Internet Small Computer Systems Interface (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 target_chap 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 requred 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 the session that the attempts to establish a session are made from
nodes in the same site as the 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 discovery output and locate a
unique iSCSI Qualified Name (IQN) and Internet Protocol (IP) combination on the discovered backend
storage controller.
- Specify addiscsistorageport. You can establish sessions (from all nodes in a
single I/O group) to the backend 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.
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