network port reachability show

Display Reachability Status

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

Description

Display broadcast domain reachability information for the specified port. If the port is discovered, via a layer 2 reachability scan, to have reachability to broadcast domains other than the one on which it is expected, the command will list the reachable broadcast domains and an appropriate reachability status message. If the reachable broadcast domain matches the expected one, the reachability status is displayed as Ok.

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.
| [-detail ]
When true, additional details regarding which broadcast domains have been found to be reachable from the specified network port are displayed.
| [-instance ]}
If you specify the -instance parameter, the command displays detailed information about all fields.
[-node {<nodename>|local}] - Node
Selects the node on which the port resides.
[-port <netport>] - Port
Selects the port for which to display broadcast domain reachability information.
[-expected-broadcast-domain <<IPspace>:<Broadcast Domain>>] - Expected Broadcast Domain
The IPspace and broadcast domain currently assigned to the network port. If the specified port is an ifgrp member, the expected broadcast domain is the IPspace and broadcast domain currerntly assigned to the parent ifgrp.
[-reachable-broadcast-domains <<IPspace>:<Broadcast Domain>>, ...] - Reachable Broadcast Domains
The name of the IPspaces and broadcast domains that have reachability to the specified port, as discovered by a layer 2 reachability scan.
[-reachability-status {unknown|ok|no-reachability|misconfigured-reachability|multi-domain-reachability|internal-error}] - Reachability Status
The status of the broadcast domain reachability for the specified port. "Ok" if the expected broadcast domain matches the reachable broadcast domains, i.e., the port can reach other ports in the expected broadcast domain, but no ports configured in other broadcast domains. "No-reachability" if the port cannot reach any ports in the expected broadcast domain, and also cannot reach any ports in any other broadcast domains. "Misconfigured-reachability" if the port cannot reach any ports in the expected broadcast domain, but can reach ports in one other broadcast domain. "Multi-domain-reachability" if the port can reach other ports configured in multiple broadcast domains. "Unknown" if the port has not been link-up long enough for reachability to be determined.
[-unreachable-ports <<node>:<port>>, ...] - Unreachable Ports
The list of network ports that are expected in the same broadcast domain as the specified port but cannot be reached, either because those ports are down or because there is no network connectivity to those ports.
[-unexpected-ports <<node>:<port>>, ...] - Unexpected Ports
The list of network ports that are not expected in the same broadcast domain yet have network connectivity to the specified port.

Examples

The following example displays the broadcast domain reachability for the specified port.

 cluster1::> network port reachability show -node node1 -port e0d
(network port reachability show)
Node         Port     Expected Reachability        Reachability Status
------------ -------- ---------------------------- --------------------------
node1        e0d      Default:Default              ok

The following example displays the detailed reachability for the 'e0d' port when it has misconfigured-reachability, i.e., it cannot reach the other 'e0d' port in the expected broadcast domain 'Default:Default', but can reach the 'e0c' ports configured in the 'Default:Default-3' broadcast domain.

 cluster1::> network port reachability show -node node1 -port e0d -detail
(network port reachability show)
Node         Port     Expected Reachability        Reachability Status
------------ -------- ---------------------------- --------------------------
node1        e0d      Default:Default              misconfigured-reachability
 Actual Reachability: Default:Default-3
 Unreachable Ports: node2:e0d
  Unexpected Ports: node2:e0c, node1:e0c

The following example displays the detailed reachability for the 'e0d' port when it has multi-domain-reachability, i.e., it can reach the other 'e0d' port in the expected broadcast domain 'Default:Default', but can also reach the 'e0c' ports configured in the 'Default:Default-3' broadcast domain.

 cluster1::> network port reachability show -node node1 -port e0d -detail
(network port reachability show)
Node         Port     Expected Reachability        Reachability Status
------------ -------- ---------------------------- --------------------------
node1        e0d      Default:Default              multi-domain-reachability
 Actual Reachability: Default:Default,
                      Default:Default-3
 Unreachable Ports: -
  Unexpected Ports: node2:e0c, node1:e0c

The following example displays the detailed reachability for the 'e0d' port when it has no-reachability, i.e., it cannot reach the other 'e0d' port in the expected broadcast domain 'Default:Default', and also cannot reach any other ports configured in broadcast domains.

 cluster1::> network port reachability show -node node1 -port e0d -detail
(network port reachability show)
Node         Port     Expected Reachability        Reachability Status
------------ -------- ---------------------------- --------------------------
node1        e0d      Default:Default              no-reachability
 Actual Reachability: -
 Unreachable Ports: node2:e0d
  Unexpected Ports: -