network interface show

Display logical interfaces

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

Description

The network interface show command displays information about logical interfaces.

Running the command with the -failover parameter displays information relevant to logical interface failover rules.

Running the command with the -status parameter displays information relevant to logical interface operational status.

Running the command with the -by-ipspace parameter displays information relevant to logical interfaces on a specific IPspace.

See the examples for more information.

You can specify additional parameters to display only information that matches those parameters. For example, to display information only about logical interfaces whose operational status is down, run the command with the -status-oper down parameter.

Parameters

{ [-fields <fieldname>, ...]
If you specify the -fields <fieldname>,... parameter, the command displays only the fields that you specify.
| [-by-ipspace ]
Use this parameter to display logical-interfaces sorted by IPspace and Vserver.
| [-dns-zones ]
Use this parameter to display logical-interfaces and whether the interface is associated with a Domain Name System (DNS) load balancing zone.
| [-failover ]
Use this parameter to display logical-interface failover information.
| [-status ]
Use this parameter to display detailed logical-interface status information.
| [-instance ]}
Use this parameter to display all the fields for the specified logical-interfaces.
[-vserver <vserver>] - Vserver Name
Use this parameter to display information only about logical interfaces on the Vserver you specify.

Use this parameter plus the -lif parameter to display detailed information only about the logical interface you specify.

[-lif <lif-name>] - Logical Interface Name
Use this parameter to display information only about logical interfaces that match the name you specify.

Use this parameter with the -vserver parameter to display detailed information only about the logical interface you specify.

[-role {cluster|data|node-mgmt|intercluster|cluster-mgmt}] - Role
Use this parameter to display information only about logical interfaces that are associated with network ports that have the role you specify.
[-data-protocol {nfs|cifs|iscsi|fcp|fcache|none}, ...] - Data Protocol
Use this parameter to display information only about logical interfaces that have the enabled data protocols you specify.
[-home-node <nodename>] - Home Node
Use this parameter to display information only about logical interfaces that have the home node you specify.
[-home-port {<netport>|<ifgrp>}] - Home Port
Use this parameter to display information only about logical interfaces that have the home port or interface group you specify.
[-curr-node <nodename>] - Current Node
Use this parameter to display information only about logical interfaces that are currently located on the node you specify.
[-curr-port {<netport>|<ifgrp>}] - Current Port
Use this parameter to display information only about logical interfaces that are currently located on the port or interface group you specify.
[-status-oper {up|down}] - Operational Status
Use this parameter to display information only about logical interfaces that have the operational status you specify.
[-status-extended <text>] - Extended Status
Use this parameter to display information only about logical interfaces that match the extended status that you specify.
[-numeric-id <integer>] - Numeric ID (privilege: advanced)
Use this parameter to display information only about logical interfaces with the numeric ID (or range of IDs) you specify. The numeric ID is an integer that identifies the logical interface in the cluster.
[-is-home {true|false}] - Is Home
Use this parameter to display information only about logical interfaces that are (true) or are not (false) currently located on their home node and port.
[-address <IP Address>] - Network Address
Use this parameter to display information only about logical interfaces that match the IP address or address range you specify.
[-netmask <IP Address>] - Netmask
Use this parameter to display information only about logical interfaces that have the netmask you specify.
[-netmask-length <integer>] - Bits in the Netmask
Use this parameter to display information only about logical interfaces with a netmask that has the number of bits you specify.
[-subnet-name <subnet name>] - Subnet Name
Use this parameter to display the logical interfaces that matches the subnet name.
[-status-admin {up|down}] - Administrative Status
Use this parameter to display information only about logical interfaces that have the administrative status you specify.
[-failover-policy {system-defined|local-only|sfo-partner-only|disabled|broadcast-domain-wide}] - Failover Policy
Use this parameter to display information only about logical interfaces that use the failover policy you specify.
[-firewall-policy <policy>] - Firewall Policy
Use this parameter to display information only about logical interfaces that use the firewall policies you specify.
[-auto-revert {true|false}] - Auto Revert
Use this parameter to display information only about logical interfaces that have auto-revert setting you specify.
[-sticky {true|false}] - Sticky Flag (privilege: advanced)
Use this parameter to display information only about logical interfaces that are "sticky". A sticky logical interface is one that has been manually migrated to another node and is not subject to auto-revert settings. A sticky logical interface remains at the migrated location until it is manually reverted or until it fails over to another node.
[-dns-zone {<zone-name>|none}] - Fully Qualified DNS Zone Name
Use this parameter to display information only about logical interfaces in the specified DNS zone.
[-listen-for-dns-query {true|false}] - DNS Query Listen Enable
Use this parameter to display information only about logical interfaces that have the DNS query listen value you specify.
[-allow-lb-migrate {true|false}] - (DEPRECATED)-Load Balancing Migrate Allowed (privilege: advanced)
Note: This parameter has been deprecated and may be removed in a future version of Data ONTAP.
Use this parameter to display information only about logical interfaces for which load balancing migration is activated (true) or not activated (false).
[-lb-weight {load|0..100}] - Load Balanced Weight (privilege: advanced)
Use this parameter to display information only about logical interfaces that have the load balancing weight you specify.
[-failover-group <failover-group>] - Failover Group Name
Use this parameter to display information only about logical interfaces that are in the failover group you specify. Logical interfaces in the same failover group are capable of failing over to the same set of ports.
[-wwpn <text>] - FCP WWPN
Use this parameter to display information only about logical interfaces that have the Fibre Channel Protocol port identifier (World Wide Port Name) you specify.
[-address-family {ipv4|ipv6|ipv6z}] - Address family
Use this parameter to view the address family that is in use on the interface. Only IPv4 and IPv6 non-zoned addresses can be configured. Configuration of IPv6z addresses is not allowed.
[-comment <text>] - Comment
Use this parameter to display information only about logical interfaces that have the comment you specify.
[-ipspace <IPspace>] - IPspace of LIF
Use this parameter to display information only about logical interfaces on the IPspace you specify.
[-is-dns-update-enabled {true|false}] - Is Dynamic DNS Update Enabled?
Use this parameter to display information only about logical interfaces that have (true) or do not have (false) dynamic DNS updates enabled for them.

Examples

The following example displays general information about all logical interfaces.

cluster1::> network interface show
            Logical    Status     Network            Current       Current Is
Vserver     Interface  Admin/Oper Address/Mask       Node          Port    Home
----------- ---------- ---------- ------------------ ------------- ------- ----
cluster1
            cluster_mgmt
                       up/up      192.0.2.1/192      node0         e0M     true
            node0_mgmt1
                       up/up      192.0.2.2/192      node0         e0M     true
            node1_mgmt1
                       up/up      192.0.2.3/192      node1         e0M     true
Cluster
            node0_clus1
                       up/up      192.0.2.66/192     node0         e0a     true
            node0_clus2
                       up/up      192.0.2.67/192     node0         e0b     true
            node1_clus1
                       up/up      192.0.2.68/192     node1         e0a     true
            node1_clus2
                       up/up      192.0.2.69/192     node1         e0b     true

The following example displays failover information about all logical interfaces.

cluster1::> network interface show -failover
         Logical         Home                  Failover        Failover
Vserver  Interface       Node:Port             Policy          Group
-------- --------------- --------------------- --------------- ---------------
cluster1
         cluster_mgmt    node0:e0M             broadcast-domain-wide
                                                               Default
                         Failover Targets: node0:e0M,
                                           node0:e0d,
                                           node0:e0e,
                                           node0:e0f,
                                           node1:e0M,
                                           node1:e0d,
                                           node1:e0e,
                                           node1:e0f
         node0_mgmt1     node0:e0M             local-only      Default
                         Failover Targets: node0:e0M,
                                           node0:e0d,
                                           node0:e0e,
                                           node0:e0f
         node1_mgmt1     node1:e0M             local-only      Default
                         Failover Targets: node1:e0M,
                                           node1:e0d,
                                           node1:e0e,
                                           node1:e0f
Cluster
         node0_clus1     node0:e0a             local-only      Cluster
                         Failover Targets: node0:e0a,
                                           node0:e0b
         node0_clus2     node0:e0a             local-only      Cluster
                         Failover Targets: node0:e0b,
                                           node0:e0a
         node1_clus1     node1:e0a             local-only      Cluster
                         Failover Targets: node1:e0a,
                                           node1:e0b
         node1_clus2     node1:e0a             local-only      Cluster
                         Failover Targets: node1:e0b,
                                           node1:e0a