lshostiplogin

Use the lshostiplogin command to list the login session type such as associated host object, login counts login protocol and other details for hosts that are identified by their iSCSI Qualified Name (IQN) and logged in to Ethernet ports that are configured with IP addresses.

Syntax

Read syntax diagramSkip visual syntax diagram svcinfo lshostiplogin idname

Parameters

-delim delimiter
(Optional) Specify a delimiter to separate data in the output.
-nohdr
(Optional) Suppress the headings in the output.
-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.
-filtervalue?
(Optional) Displays a list of valid filter attributes.
id
(Optional) Object identifier that indicates a configured host IQN, for which login details are to be displayed. This value must be a number in the range 0 - 2047 (Max number of configured iSCSI IQNs per SVC cluster [512 x 4 = 2048]).
name
(Optional) Object name that indicates a configured host IQN name, for which login details are to be displayed.
Note:
Following are added as ownership rules:
  • Global user is allowed to view login information of all host objects.
  • Restricted users can view login information only for owned host objects and global host objects.
When using the partition IP address to run this command, consider the following:
  • The user must identify objects using the name or UUID. Short IDs cannot be specified when using the partition IP address.
  • Views will be filtered to display only objects related to the partition associated with the IP address. An error will be displayed if the user requests a detailed view for an object that is not related to the partition.

Description

This command lists the login session type and other details.

This table provides the attribute values that can be displayed as output view data.
Table 1. svcinfo lshostiplogin output
Attribute Description
id Object identifier that indicates a configured host IQN for which login details are displayed.
name Unique IQN for an iSCSI host. This IQN must belong to a configured host object.
host_id Host object ID to which this IQN belongs.
host_name Host name corresponding to host_id.
login_count Total number of login sessions that are established by the host to cluster ports to all I/O groups.
login_protocol Specifies the connection protocol that is used by the configured host to establish sessions with Ethernet ports configured with IP addresses. This value can be one of the following values:
  • iSCSI
  • mixed
login An integer that refers to a single session from the host to any node in the cluster. This value is a number in the range of 0 - 31.
node_id Node ID of the node to which a login session, referred by login field, is established by host IQN. This value is an integer in the range of 1 - 32.
node_name Node name of the node to which a login session, referred by login field, is established by host IQN. This value is a string with a maximum of 16 characters.
port_id Port identifier that indicates the Ethernet port that is displayed by the lsportethernet view to which login is established. This value is a number in the range of 1 - 12.
protocol Indicates the connection protocol that is used by the configured IP host IQN to establish a login session referred by the login field. This value can be one of the following values:
  • iSCSI
ip_version Indicates the IP addressing version. The value that is displayed is either IPv4 or IPv6.
failover Identifies whether the session refers to the local or failover IP address. The value that is displayed is either yes or no.
Note: Individual IQNs within a host object may be associated with different ownership. This command will display host objects' login information based on ownership.
When using the partition IP address to run this command, consider the following:
  • The user must identify objects using the name or UUID. Short IDs cannot be specified when using the partition IP address.
  • Views will be filtered to display only objects related to the partition associated with the IP address. An error will be displayed if the user requests a detailed view for an object that is not related to the partition.