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 Internet Small Computer Systems Interface (iSCSI) controller.
Syntax
>>- addiscsistorageport -- --+----------------------------+-----> '- -iogrp --+- iogrp_id ---+-' '- iogrp_name -' >-- --+---------------------------------+-- --------------------> '- -username -- target_user_name -' >--+------------------------------+-- --------------------------> '- -chapsecret -- target_chap -' >--+--------------------------+-- -- candidate_id ------------->< '- -site --+- site_id ---+-' '- site_name -'
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 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.
- -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.
- 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.
A detailed invocation example
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
addiscsistorageport 0
The detailed resulting output:
No feedback