lsiscsistorageport
Use the lsiscsistorageport command to display the details of the iSCSI login session(s) that are established from the Initiator's Internet Small Computer Systems Interface (iSCSI) source ports to iSCSI backend target controller ports.
Syntax
>>- lsiscsistorageport -- --+----------+-- ---------------------> '- -nohdr -' >--+-----------------------------------+-- ---------------------> '- -filtervalue -- attribute_value -' >--+-----------------+--+-----------------------+-- ------------> '- -filtervalue? -' '- -delim -- delimiter -' >--+----------+------------------------------------------------>< '- row_id -'
Parameters
- -nohdr
- (Optional) By default, headings are displayed for each column of data in a concise style view,
and for each item of data in a detailed style view. The -nohdr parameter
suppresses the display of these headings.Note: If there is no data to be displayed, headings are not displayed.
- -filtervalue attribute=value
- (Optional) Specifies a list of one or more filters. Only objects with a value that matches the
filter attribute value are displayed. Note: Some filters allow the use of a wildcard when you enter the command. The following rules apply to the use of wildcards:
- The wildcard character is the asterisk (*).
- The command can contain a maximum of one wildcard.
- When you use a wildcard, enclose the filter entry within double quotation marks (""): lsiscsistorageport -filtervalue id="1*"
- -filtervalue?
- (Optional) Displays the valid filter attributes for the -filtervalue
parameter:
- id
- status
- -delim delimiter
- (Optional) By default in a concise view, all columns of data are space-separated. The width of each column is set to the maximum width of each item of data. In a detailed view, each item of data has its own row, and if the headers are displayed, the data is separated from the header by a space. The -delim parameter overrides this behavior. Valid input for the -delim parameter is a 1-byte character. If you enter -delim : on the command line, the colon character (:) separates all items of data in a concise view; for example, the spacing of columns does not occur. In a detailed view, the data is separated from its header by the specified delimiter.
- row_id
- (Optional) Specifies the row ID view and denotes the sessions that are established from the specified initiator node ports to a backend controller target iSCSI qualified name (IQN) through a target Internet Protocol (IP) address. The value must be a number 0 - 1024.
Description
This command displays the details of sessions that are established from the Initiator's iSCSI source ports to iSCSI backend target controller ports.
Attribute | Description |
---|---|
id | Indicates the object identifier for any sessions from any clustered system (system) nodes to the iSCSI backend controller iSCSI qualified name (IQN) through an iSCSI backend controller target IP. The value must be a number 0 - 1023. |
src_port_id | Indicates the source port identifier for the node Ethernet port number that is displayed in the lsportip output. The value is a number 0 - 7. |
target_ipv4 | Indicates the IPv4 address of the iSCSI backend controller target port that establishes a session from the initiator source port that is identified by the source port ID. The default value is blank. |
target_ipv6 | Indicates the IPv6 address of the iSCSI backend controller target port that establishes a session from the initiator source port that is identified by the source port ID. The default value is blank. |
target_iscsiname | Indicates the IQN of the iSCSI backend controller target that establishes a session. The value must be an alphanumeric string of no more than 256 characters. The default value is blank. |
controller_id | Indicates the controller ID that is displayed in the lscontroller output. The value must be a number 0 - 1023. The default value is 1024. |
iogroup_list | Indicates a colon-separated list of discovery result codes:
The value must be an alphanumeric string of up to 32 characters. This field cannot be blank. The
values are 0 and 1:
Note: The value - (dash) indicates that the I/O group is not valid or is not
present in the system.
|
status | Indicates the connectivity status from all nodes in the system to the target
port. The values are:
|
connected | Indicates whether the established connection is from a specified Ethernet port of a target IQN and IP address. The values are yes and no. |
node_id | Indicates the node ID of the initiator node that establishes the session. The value must be a numeric value. |
node_name | Indicates the node name of the initiator node that establishes the session. The value must be an alphanumeric string of no more than 16 characters (the default value is blank). |
src_ipv4 | Indicates the IPv4 IP address of the source port ID on a specified node. The default value is blank. |
src_ipv6 | Indicates the IPv6 IP address of the source port ID on a specified node. The default value is blank. |
src_iscsiname | Indicates the IQN of the source node for which connectivity is being displayed for the target port. The value must be an alphanumeric string of no more than 256 characters (the default value is blank). |
- complete target discovery by using an IPv4 IP address of a target ISCSI controller through
source port ID 0:
detectiscsistorageportcandidate -targetip IP1 –srcportid 2
- You would then specify session establishment by using addiscsistorageport for
discovery output row 0 through I/O group 1:
addiscsistorageport -iogrp 1 0
- Specify lsiscsistorageport to view the output (no tgt_user_name or target_chap is required for discovery or session establishment).
Specify rmiscsistorageport to remove a session.
A concise invocation example
lsiscsistorageport
The resulting output:
id src_port_id target_ipv4 target_ipv6 target_iscsiname controller_id controller_name iogroup_list status site_id site_name
0 4 192.168.82.90 iqn.1986-03.com.ibm:2145.temp.node1 3 controller3 0:1:-:- partial
A detailed invocation example
lsiscsistorageport 0
The resulting output:
id 0
src_port_id 4
target_ipv4 192.168.82.90
target_ipv6
target_iscsiname iqn.1986-03.com.ibm:2145.temp.node1
controller_id 0
iogroup_list 1:1:-:-
status full
site_id
site_name
node_id 17
node_name node1
src_ipv4 192.168.82.80
src_ipv6
src_iscsiname iqn.1986-03.com.ibm:2145.iscsicluster.node1
connected yes
node_id 20
node_name node2
src_ipv4 192.168.82.81
src_ipv6
src_iscsiname iqn.1986-03.com.ibm:2145.iscsicluster.node2
connected yes
node_id 16
node_name node3
src_ipv4 192.168.82.82
src_ipv6
src_iscsiname iqn.1986-03.com.ibm:2145.iscsicluster.node3
connected yes
node_id 18
node_name node4
src_ipv4 192.168.82.83
src_ipv6
src_iscsiname iqn.1986-03.com.ibm:2145.iscsicluster.node4
connected yes