Skip to main content

vserver iscsi interface show

Contributors
Suggest changes
PDFs

Show network interfaces used for iSCSI connectivity

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

This command shows the iSCSI logical interfaces for a specified Vserver. If you do not specify any of the parameters, the command displays all of the interfaces on a Vserver.

Parameters

{ [-fields <fieldname>,…​]

If you specify the -fields <fieldname>, …​ parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.

| [-instance ] }

If you specify the -instance parameter, the command displays detailed information about all fields.

[-vserver <Vserver Name>] - Vserver

Use this parameter to display iSCSI logical interfaces that match the Vserver that you specify.

[-lif <lif-name>] - Logical Interface

Use this parameter to display iSCSI logical interfaces that that you specify.

[-status-admin {up|down}] - Administrative Status

Specifies the configured status of the logical interface. If you set this parameter to up, the command displays all iSCSI logical interfaces with the administrative status of up. If you set this parameter to down, the command displays all the iSCSI logical interfaces with the administrative status of down.

[-status-oper {up|down}] - Operational Status

Specifies the current status of the logical interface. If you set this parameter to up, the command displays all the iSCSI logical interfaces with the operational status of up. If you set this parameter to down, the command displays all the iSCSI logical interfaces with the operational status of down.

[-enabled {true|false}] - Enabled

Specifies if this logical unit is enabled for iSCSI service. If you enter this command without a parameter, its effective value is true, and the command displays all the enabled iSCSI logical interfaces.

[-address <IP Address>] - IP Address

Use this parameter to display iSCSI logical interfaces that match the IP address that you specify.

[-ip-port <integer>] - IP Port Number

Use this parameter to display iSCSI logical interfaces that match IP port number for the logical interface that you specify.

[-curr-node <nodename>] - Current Node

Use this parameter to display iSCSI logical interfaces that match current node that you specify.

[-curr-port {<netport>|<ifgrp>}] - Current Port

Use this parameter to display iSCSI logical interfaces that match specified current physical port that you specify.

[-is-home {true|false}] - Is Home

Specifies if the node hosting the logical interface is the initially configured node. If you use this command without using this parameter, it is set to true, and the command displays all iSCSI interfaces that are on the initially configured node.

[-tpgroup <text>] - TPGroup Name

Use this parameter to display iSCSI logical interfaces that match the target portal group name that you specify.

[-t, -tpgroup-tag <integer>] - TPGroup Tag

Use this parameter to display iSCSI logical interfaces that match the target portal group tag that you specify.

[-relative-port-id <integer>] - Relative Port ID

Use this parameter to display the iSCSI logical interface that matches the relative target port ID that you specify. The system assigns each logical interfaces and target portal group a relative target port ID that is Vserver unique. You cannot change this ID.

[-sendtargets-fqdn <text>] - iSCSI Discovery SendTargets FQDN (privilege: advanced)

Use this parameter to display the iSCSI logical interfaces that match the iSCSI Discovery SendTargets Fully Qualified Domain Name (FQDN) that you specify.

[-home-node <nodename>] - Home Node

Use this parameter to display iSCSI logical interfaces that match home node that you specify.

[-home-port {<netport>|<ifgrp>}] - Home Port

Use this parameter to display iSCSI logical interfaces that match specified home physical port that you specify.

Examples

The following example displays information for logical interfaces on Vserver vs_1.

cluster1::> vserver iscsi interface show -vserver vs_1
           Logical         Status     IP              Curr        Curr
Vserver    Interface  TPGT Admin/Oper Address         Node        Port Enabled
---------- ---------- ---- ---------- --------------- ----------- ---- -------
vs_1       vs_1.iscsi 1027   up/up    10.63.8.165     node1       e0c  true
vs_1       vs_1.iscsi2
                      1028   up/up    10.63.8.166     node1       e0c  true
2 entries were displayed.

The following example displays the logical interface vs_1.iscsi with the relative target port ID of 1.

cluster1::> vserver iscsi interface show -vserver vs_1 -relative-port-id 1
           Logical         Status     IP              Curr        Curr
Vserver    Interface  TPGT Admin/Oper Address         Node        Port Enabled
---------- ---------- ---- ---------- --------------- ----------- ---- -------
vs_1       vs_1.iscsi 1027   up/up    10.63.8.165     node1       e0c  true