lsiscsistorageport

Use the lsiscsistorageport command to display the details of the iSCSI login sessionsthat 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.
-filtervalueattribute=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.

This table provides the attribute values that can be displayed as output view data.
Table 1. lsiscsistorageport output
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:
  • 0 indicates that the I/O group is available in the system, but discovery is either not triggered through the I/O group or discovery through the I/O group fails.
  • 1 indicates that the I/O group is present and discovery is successful through the I/O group.
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:
  • full

    If you specify a single I/O group by using the addiscsistorageport command and you establish the session from all nodes in the specified I/O group, the status is full.

  • partial

    If you specify a single I/O group by using the addiscsistorageport command and you establish the session from a single node in the specified I/O group, the status is partial.

  • none

    If you specify a single I/O group by using the addiscsistorageport command and you do not establish the session from any node in the specified I/O group, the status is none.

There is no default value. This field cannot be blank.
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.
site_id Indicates the site ID (if the nodes that are being discovered belong to a site). This applies to HyperSwap systems.
site_name Indicates the site name (if the nodes that are being discovered belong to a site). This applies to HyperSwap systems.
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).
Before you specify lsiscsistorageport such as in the examples below, you must:
  1. Complete target discovery by using an IPv4 IP address of a target ISCSI controller through source port ID 0:
    detectiscsistorageportcandidate -targetip IP1 –srcportid 2 
  2. You would then specify session establishment by using addiscsistorageport for discovery output row 0 through I/O group 1:
    addiscsistorageport -iogrp 1 0
  3. 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