To specify packet
flow and payload information in hexadecimal string format, use the
packet
command in FabricPath OAM profile flow configuration mode. To remove the packet
information, use the
no form of
this command.
packethex-string
nopacket
Syntax Description
hex-string
Packet
flow and payload information in hexadecimal string format. The maximum limit is
256 characters.
Note
Enter
the packet information starting with the Ethernet header in hexadecimal string
format. For example:
00156dc4274b5404a63ced2b810000010800450000283e8a400080069bd2c0a80260e
Command Default
Packet flow and
payload information is not specified.
You can specify a
string value up to the maximum length of 256 characters. The string value is
converted to a hex-string value. All characters beyond the maximum limit are
treated as 0.
Examples
The following
example shows how specify the value for packet flow and payload.
Configures the direction FabricPath OAM flow entropy.
param-list
To create a user-defined parameter list or to configure parameters and parameter list instances for an existing parameter list, use the
param-list command in global configuration mode. To delete a user-defined parameter list, use the
no form of
this command.
param-listparameter-list-name
noparam-listparameter-list-name
Syntax Description
parameter-list-name
Name of the parameter list.
Note
The parameter-list-name argument can be used to create a new parameter list or configure parameters and parameter list instances for an existing parameter list. To view existing parameter lists, type param-list ? in global configuration mode.
Command Default
No parameter lists are predefined.
Command Modes
Global configuration (config)
Command History
Release
Modification
7.0(0)N1(1)
This
command was introduced.
Usage Guidelines
When you create a parameter list using the param-list command, the device enters parameter list configuration mode (config-param-list). In parameter list configuration mode, you can:
Create parameters for the specified parameter list using the define option.
Create an instance of a parameter list using the instance option.
Note
To view the define and instance options, type ? in parameter list configuration mode.
To configure parameters and parameter list instances for an existing parameter list, use the param-listparameter-list-name command, where parameter-list-name corresponds to an existing parameter list.
Examples
The following example shows how to create a user-defined parameter list named List1 and create a parameter named param1 within the list:
To configure
a password for the user, use the
password
secure-mode command in global configuration mode. To disable the
password configuration, use the
no form of
this command.
passwordsecure-mode
nopasswordsecure-mode
Syntax Description
This command has
no arguments or keywords.
Command Default
No password is configured.
Command Modes
Global configuration (config)
Command History
Release
Modification
7.0(0)N1(1)
This
command was introduced.
Examples
This example shows
how to enable secure mode while changing the password:
To configure the
control plane forward or reverse path verification request, use the
path command
in FabricPath OAM profile configuration mode. To remove the path verification
request, use the
no form of
this command.
Use the
path
command to allow FabricPath OAM to carry a Type Length Value (TLV) with this
request over the network, to query for the ECMP number and switch ID, and to
return results.
To configure all
ECMP, use 0xFF as
the ECMP value.
Examples
The following
example shows how to configure the control plane forward path verification
request.
To configure a
FabricPath Operation, Administration, and Maintenance (OAM) payload pattern,
use the
payload
command in FabricPath OAM profile configuration mode. To remove the FabricPath
OAM payload pattern, use the
no form of
this command.
(Optional)
Sends a loopback request to the specified switch ID.
profileprofile-id
(Optional)
Specifies FabricPath OAM profile.
interfaceinterface-id
(Optional) Name of the egress interface for FabricPath OAM ping.
The allowed interfaces are Ethernet and Port Channel. The interface range is
allowed for asynchronous ping so that multiple sessions per interface are
created.
ingressif-id
(Optional) Name of the ingress interface. (Required for SVI when used for
enhanced forwarding. The ingress SVI and IP address from flow entropy is used
to determine which segment packet exits out of the device.)
vlanvlan-id
VLAN
ID. The range is from 1 to 4094.
tagtag-id
FabricPath OAM tag. The range is from 4096 to 0x00FFFFFF.
dot1qdot1q-idintf-id
Specifies the FabricPath OAM 802.1Q interface ID.
Note
Dot1q
option is not available on Cisco Nexus 5000 series and 6000 series switches and
it's only applicable to N7k.
use-host-vlan
(Optional) Specifies that only VLAN input should be used. Use
this keyword when enhanced forwarding is applied and you do not want to use
translated VLAN. Use this option when you specify the ingress interface ID or
when you specify the flow entropy through the
profile
keyword or through forward flow with IP address of customer traffic.
replymodeout-of-band
(Optional) Specifies that the FabricPath OAM reply mode is out
of band. By default, FabricPath OAM is replied in band (on the FabricPath
network). Use the
replymodeout-of-band keyword to change the mode of reply to
out of band for input IPv4 or IPv6 addresses. For routing, only default VRF is
used.
ipv4ipv4-addr
(Optional) Specifies the input IPv4 address for out-of-band
reply.
ipv6ipv6-addr
(Optional) Specifies the input IPv6 address for out-of-band
reply.
forwardflowflow-entropy
(Optional) Specifies input flow entropy (128 bytes) from actual
user data traffic so that FabricPath OAM packet takes the same path as user
traffic.
l2
(Optional) Specifies that the input flow entropy must be
terminated until only Layer 2 entries are used. For example, MAC address, VLAN,
and e-type. We recommend that you use only one string option.
l3
(Optional) Specifies that the input flow entropy must be
terminated until only Layer 3 entries are used.
Note
Only IPv4 and IPv6 entries can be processed.
hophop-count
(Optional) Specifies the FabricPath OAM ping hop count. Range is
from 1 to 64. Default is 63.
topologytopology-id
(Optional) Specifies the topology ID. Range is from 0 to 63.
Default is 0.
sizesize
(Optional) Specifies the data padding size of data Type Length
Value (TLV) or test TLV. The total size must not be greater than the MTU of the
egress interface.
sweepmin-sizemax-size
(Optional) Specifies the FabricPath OAM minimum or maximum data
or test TLV size in a sweep scenario.
payload
(Optional) Specifies the FabricPath OAM payload pattern.
testpattern-typetest-id
(Optional) Specifies the FabricPath OAM test pattern ID.
padpad-value
(Optional) Specifies the padding of the packet with the
specified data pattern. The range is from 0 to 0-0xFFFF.
repeatrepeat-count
(Optional) Specifies the repeat value.
validate
(Optional) Validates the
ping command.
verbose
(Optional) Displays additional information.
timeouttimeout-value
(Optional) Specifies the timeout values in seconds. Range is
from 1 to 36000.
intervalinterval-val
(Optional) Specifies the minimum send delay between requests, in
milliseconds. The range is from 100 to 3600000. Default is 0 for synchronous
ping, 1000 for asynchronous ping.
asynchronousdatabase-id
(Optional) Specifies the database ID for storing asynchronous
FabricPath OAM ping output.
thresholdthreshold-value
(Optional) Specifies the threshold for number of timeouts that
can occur before the information is captured in syslogs or SNMP traps. The
range is from 1 to 10.
Command Modes
Privileged EXEC (#)
Command History
Release
Modification
7.0(0)N1(1)
This
command was introduced.
Usage Guidelines
For an synchronous
ping, traceroute, or mtrace, if the profile has multiple interfaces only the
first interface, is selected. Use the
interface
keyword to overwrite the selected interface. Only one session is created.
For Asynchronous
ping, multiple sessions are automatically created for each interface option
unless the you overwrite the inferface option using the
interface
keyword.
Examples
The following
examples show how to ping a switch ID.
Device# ping fabricpath switch-id 10
sender handle: 1
Sending 5, 300-byte Loopback Request to switch-id 10,
Timeout is 5 seconds, send interval is 0 msec:
Codes: '!' - success, 'Q' - request not sent, '.' - timeout,
'D' – Destination Unreachable, 'X' - unknown return code,
'V' – VLAN nonexistent, 'v' – VLAN in suspended state,
'M' - malformed request, 'm' - unsupported tlvs, 'C' – Cross Connect Error,
'U' – Unknown RBridge nickname, 'n' – Not AF,
'E' –MTU mismatch, 'I' – Interface not in forwarding state,
'S' – Service Tag nonexistent, 's' – Service Tag in suspended state
't' – trace route in progress to get hop count’
Type escape sequence to abort.
!!!!!
Success rate is 100 percent (5/5), round-trip min/avg/max = 1/1/1 ms
Total Time Elapsed 5 ms
The following examples show
how to ping a switch ID with the keyword
verbose.
Device# ping fabricpath switch-id 10 verbose
Sending 5, 300-byte Loopback Request to switch-id 10,
Timeout is 5 seconds, send interval is 0 msec:
Codes: '!' - success, 'Q' - request not sent, '.' - timeout,
'D' – Destination Unreachable, 'X' - unknown return code,
'V' – VLAN nonexistent, 'v' – VLAN in suspended state,
'm' - malformed request, 'C' – Cross Connect Error,
'U' – Unknown RBridge nickname, 'n' – Not AF,
'M' –MTU mismatch, 'I' – Interface not in forwarding state,
'S' – Service Tag nonexistent, 's' – Service Tag in suspended state,
't' – trace route in progress to get hop count
Type escape sequence to abort.
! size 300, reply switch-id 10
! size 300, reply switch-id 10
! size 300, reply switch-id 10
! size 300, reply switch-id 10
! size 300, reply switch-id 10
Success rate is 100 percent (5/5), round-trip min/avg/max = 1/1/1 ms
Total Time Elapsed 5 ms
The following example shows how to ping FabricPath switch ID when
data TLV is included.
Device# ping fabricpath switch-id 3570 vlan 10 size 100 payload pad 0xAABB repeat 1 verbose
Codes: '!' - success, 'Q' - request not sent, '.' - timeout,
'D' - Destination Unreachable, 'X' - unknown return code,
'V' - VLAN nonexistent, 'v' - VLAN in suspended state,
'm' - malformed request, 'C' - Cross Connect Error,
'U' - Unknown RBridge nickname, 'n' - Not AF,
'*' - Success, Optional Tlv incomplete,
'I' - Interface not in forwarding state,
'S' - Service Tag nonexistent, 's' - Service Tag in suspended state,
'c' - Corrupted Data/Test
Sender handle: 6
! size 274, reply switch-id 3570
Success rate is 100 percent (1/1), round-trip min/avg/max = 5/5/5 ms
Total time elapsed 6 ms
The following example shows how to ping FabricPath switch ID with
enhanced forwarding.
Device# ping fabricpath switch-id 3570 ingress vlan 20 vlan 10 repeat 1
Codes: '!' - success, 'Q' - request not sent, '.' - timeout,
'D' - Destination Unreachable, 'X' - unknown return code,
'V' - VLAN nonexistent, 'v' - VLAN in suspended state,
'm' - malformed request, 'C' - Cross Connect Error,
'U' - Unknown RBridge nickname, 'n' - Not AF,
'*' - Success, Optional Tlv incomplete,
'I' - Interface not in forwarding state,
'S' - Service Tag nonexistent, 's' - Service Tag in suspended state,
'c' - Corrupted Data/Test
Sender handle: 7
!
Success rate is 100 percent (1/1), round-trip min/avg/max = 3/3/3 ms
Total time elapsed 5 ms
The following example shows interactive ping with control plane
forward and control plane reverse verification request.
Device# ping fabricpath
Switch-id(1-65535) [1] 3570
Repeat count(1-429967295) [5]
Timeout in seconds [2]
Interval in ms [1000]
Extended command(y/n) [n] y
OAM Profile(1-1023) [none]
Interface [none]
Ingress Interface [none]
Forward Flow entropy [n]
Reverse Flow entropy [n]
Reply mode out of band [n]
Verbose [n]
Hop count(1-63) [63]
Topology id [0]
Use host vlan [n]
Vlan(vlan id or none) [1] 10
Control path forward request [n] y
Control path forward ecmp [1]
Control path forward switch-id(1-65535) [1] 3570
Control path reverse request [n] y
Control path reverse ecmp [1]
Control path reverse switch-id(1-65535) [1] 2021
Codes: '!' - success, 'Q' - request not sent, '.' - timeout,
'D' - Destination Unreachable, 'X' - unknown return code,
'V' - VLAN nonexistent, 'v' - VLAN in suspended state,
'm' - malformed request, 'C' - Cross Connect Error,
'U' - Unknown RBridge nickname, 'n' - Not AF,
'*' - Success, Optional Tlv incomplete,
'I' - Interface not in forwarding state,
'S' - Service Tag nonexistent, 's' - Service Tag in suspended state,
'c' - Corrupted Data/Test
Sender handle: 8
!!!!!
Success rate is 100 percent (5/5), round-trip min/avg/max = 3/7/19 ms
Total time elapsed 4071 ms
The following example shows how to ping FabricPath switch ID when flow
entropy is specified.
Device# ping fabricpath switch-id 3570 forward flow 0011222211110022222233338100000A8904 repeat 1
Codes: '!' - success, 'Q' - request not sent, '.' - timeout,
'D' - Destination Unreachable, 'X' - unknown return code,
'V' - VLAN nonexistent, 'v' - VLAN in suspended state,
'm' - malformed request, 'C' - Cross Connect Error,
'U' - Unknown RBridge nickname, 'n' - Not AF,
'*' - Success, Optional Tlv incomplete,
'I' - Interface not in forwarding state,
'S' - Service Tag nonexistent, 's' - Service Tag in suspended state,
'c' - Corrupted Data/Test
Sender handle: 10
!
Success rate is 100 percent (1/1), round-trip min/avg/max = 14/14/14 ms
Total time elapsed 15 ms
To configure a
destination or source flow port address, use the
port command
in FabricPath OAM profile flow configuration mode. To remove the configured
address for source or destination port, use the
no form of
this command.
port
{ destination
|
source }
port-number
noport
{ destination
|
source }
Syntax Description
destination
Specifies
the destination flow port address.
source
Specifies
the source flow port address.
port-number
The source
or destination port address. The range is from 0 to 65535.
Configures the direction FabricPath OAM flow entropy.
protocol
(fabricpath-oam)
To configure the
FabricPath Operation, Administration, and Maintenance (OAM) flow protocol
number, use the
protocol
command in FabricPath OAM profile flow configuration mode. To remove the flow
protocol number, use the
no form of
this command.
Configures the direction FabricPath OAM flow entropy.
redistribute hmm route-map
To enable redistribution of IPv4 and IPv6 Host Mobility Manager (HMM) routes through specified route maps, use the
redistribute hmm route-map command in address-family configuration mode. To disable redistribution of HMM routes through specified route maps, use the
no form of
this command.
redistribute hmm route-mapmap-name
no redistribute hmm route-mapmap-name
Syntax Description
map-name
Route-map name.
Note
Redistribution does not work if an access list is used as a match option in route-maps.
Command Default
HMM routes are redistributed by default.
Command Modes
Address-family configuration (config-router-af)
Command History
Release
Modification
7.0(0)N1(1)
This
command was introduced.
Examples
The following
example shows how to enable redistribution of HMM IPv4 routes filtered through route-map1:
To configure the
fabricpath OAM out-of-band service reply mode, use the
reply mode
out-of-band command in fabricpath OAM profile configuration mode.
To remove the out-of-band service reply mode, use the
no form of
this command.
To restart the
fabric multicast process in a controlled way, use the
restart
fabric_mcast in privileged EXEC mode.
restartfabric_mcast
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
Release
Modification
7.0(0)N1(1)
This
command was introduced.
Usage Guidelines
You can restart
the fabric multicast process only if the process is already running. You can
start the fabric multicast process using the
ipv4 multicast
fabric-forwarding or
ipv6 multicast
fabric-forwarding command.
Examples
The following
example shows how to restart a fabric multicast process:
Device# restart fabric_mcast
route-reflector-group affinity
To specify the route reflector group affinity to peer with, use
the route-reflector-group affinity command in router configuration mode.
route-reflector-group affinity group-id
Syntax Description
group-id
Route reflector group ID.
The range is from 1 to 65535.
Command Default
The route reflector group affinity
is not configured.
Command Modes
Router configuration (config-router)
Command History
Release
Modification
7.0(0)N1(1)
This
command was introduced.
Examples
The following
example shows how to configure a route reflector group affinity:
To configure
Lightweight Directory Access Protocol (LDAP) or Extensible Messaging and
Presence Protocol (XMPP) for a server group, use the
serverprotocol command in fabric database
configuration mode. To remove the configuration use the
no form of
this command.
no
server protocol
{ ldap
| xmpp }
{ ipip-address
| hosthostname }
[ portport-number ]
[ vrfvrf-name ]
Syntax Description
ldap
Specifies
that LDAP is configured.
xmpp
Specifies
that XMPP is configured.
ipip-address
Specifies
the IP address of the server.
hosthostname
Specifies
the hostname of the server.
portport-number
(Optional) Specifies the TCP or UDP port number on the server.
vrfvrf-name
(Optional) Specifies the VRF context to use to connect to the
server.
Command Default
The protocol for
a server group is not configured.
Command Modes
Fabric database configuration (config-fabric-db)
Command History
Release
Modification
7.0(0)N1(1)
This
command was introduced.
Usage Guidelines
Use this command
along with the
fabric database
type command to configure an external database using XML or XMPP.
Examples
The following
example shows how to configure a profile database using LDAP:
Device(config)# fabric database type profile
Device(config-fabric-db)# server protocol ldap ip 10.0.0.1
Device(config-fabric-db-server)# db-table db-profile-db
The following
example shows how to configure an asset database using XMPP and segment ID as
key.
Configures the Jabber ID and password of the switch that is used to connect to the server.
server protocol
radius
To configure a
RADIUS server protocol for a an authentication, authorization, and accounting
(AAA) server group, use the
serverprotocolradius command in fabric database configuration
mode. To remove the configuration, use the
no form of
this command.
serverprotocolradiusgroupgroup-name
noserverprotocolradiusgroupgroup-name
Syntax Description
groupgroup-name
Specifies
a RADIUS protocol using an authentication, authorization, and accounting (AAA)
server group.
Command Default
The RADIUS server
protocol for a AAA server group is not configured.
Command Modes
Fabric database configuration (config-fabric-db)
Command History
Release
Modification
7.0(0)N1(1)
This
command was introduced.
Usage Guidelines
Use this command
along with the fabric database
type command to configure an external database.
Examples
The following
example shows how to configure an asset database using RADIUS:
Device(config)# fabric database type asset
Device(config-fabric-db)# server protocol radius group group1
Device(config-fabric-db-server)# key-type 2
To configure a
FabricPath OAM service, use the
service tag
command in FabricPath OAM profile configuration mode. To remove the FabricPath
OAM service, use the
no form of
this command.
servicetagtag-id
noservicetagtag-id
Syntax Description
tag-id
Service
tag ID. The range is from 4096 to 16777215.
To display the
clock configuration, use the
show clock
command in any command mode.
show clock [detail]
Syntax Description
detail
(Optional)
Displays the summer-time (daylight saving time) offset configuration.
Command Default
Displays all
configured command alias variables.
Command Modes
Any command mode
Command History
Release
Modification
—
This
command was introduced in a release earlier than Cisco NX-OS Release
7.0(0)N1(1).
Usage Guidelines
This command does
not require a license.
Examples
This example shows
how to display the clock setting:
Device# show clock
Fri Jun 13 02:19:20 PDT 2008
This example shows
how to display the clock setting and the summer-time (daylight saving time)
configuration:
Device# show clock detail
Fri Jun 13 02:19:20 PDT 2008
summer-time configuration:
--------------------------
timezone name: PDT
starts : 1 Sunday March at 02:00 hours
Ends : 1 Sunday November at 02:00 hours
Minute offset: 60
show
config-profile
To display details
of created and applied profiles, use the
show
config-profile in privileged EXEC mode.
showconfig-profile
Syntax Description
This command has
no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
Release
Modification
7.0(0)N1(1)
This
command was introduced.
Usage Guidelines
Use the
configure
profile command to create profiles and to assign a list of
commands to the profile in the device. Once a profile is created with a valid
parameter list and parameter instances, apply the profile using the
apply profile
command.
Use > to redirect the configuration profile to a file and >> to redirect it to a file in append mode.
Examples
The following
sample output from the
show
config-profile command displays details of the param-prof1
profile:
Device(config)# show config-profile param-prof1
config-profile param-prof1
interface vlan $vlan_num
ip local-proxy-arp
ip proxy-arp
fabric forwarding mode proxy-gateway
ip address $ipaddr
no ip redirects
vrf member $prog1
no shutdown
vlan $vlan_num
vn-segment $segid
applied: param-prof1-inst1
To display the
connection status of a device or a user in the fabric access network, use the
show fabric access
connections command in privileged EXEC mode.
show fabric access connections
Syntax Description
This command has
no arguments or keywords.
Command Default
None
Command Modes
Privileged EXEC (#)
Command History
Release
Modification
7.0(0)N1(1)
This
command was introduced.
Usage Guidelines
Use the
show fabric access
connections command to view the status of devices and users in
the fabric access network. The fabric access ping parameters include status,
interval, response time, and retry.
Examples
This example shows
how to display the connection status of the device and user in the fabric
access network:
Checks which remote devices failed to respond to the CLI requests sent through the single point of management feature.
show fabric access
group
To display the
groups that a device or user is currently subscribed to or a list of members
existing in a particular group, use the
show fabric access
group command in privileged EXEC mode.
showfabricaccessgroup
[ device
| membersgroup-name
| user ]
Syntax Description
device
(Optional)
Lists the groups that the currently logged-in device belongs to.
membersgroup-name
(Optional)
Lists the members belonging to a group.
user
(Optional)
Lists the groups that the currently logged-in user belongs to.
Command Default
None
Command Modes
Privileged EXEC (#)
Command History
Release
Modification
7.0(0)N1(1)
This
command was introduced.
Usage Guidelines
The
show fabric access
group command is part of the single point of management feature
and helps the device or user find the names of existing groups to join. You can
also create a group in the Extensible Messaging and Presence Protocol (XMPP)
server using the
fabric access create
groupgroup-name command.
Examples
The following
sample output from the
show fabric access
group command displays all the groups that the device or user is
currently subscribed to:
Device# show fabric access group
group1
group2
group3
group4
group5
Total 5 groups
The following
sample output from the
show fabric access group
device command displays the groups that the currently logged-in
device is subscribed to:
Device# show fabric access group device
group3
group4
The following
sample output from the
show fabric access group
members command displays the members belonging to group2:
Device# show fabric access group members group2
admin@host-1.com
device3@host-2.com
Total 2 members
Checks which remote devices failed to respond to the CLI requests sent through the single point of management feature.
show fabric access
statistics
To check which
remote devices failed to respond to the CLI requests sent through the single
point of management feature, use the
show fabric access
statistics command in privileged EXEC mode.
showfabricaccessstatistics
Syntax Description
This command has
no arguments or keywords.
Command Default
None
Command Modes
Privileged EXEC (#)
Command History
Release
Modification
7.0(0)N1(1)
This
command was introduced.
Usage Guidelines
Use the
fabric access
attach command or the
fabric access
send command to send CLI requests to a specified device or group.
Examples
The following sample output from the show users command displays the remote device “spom2-test2@host1.com” that did not respond to the show users command.
Device# show fabric access statistics
Device not replied(1) to CLI "sh users" on 2013-04-18 18:27:53
spom2-test2@host1.com/(fabric-access-device)
Displays the connection status of a device or a user that is connected in the fabric access network.
show fabric
connectivity cable-plan
To display the
cable plan available in the system memory, use the
showfabricconnectivitycable-plan command in privileged EXEC mode.
showfabricconnectivitycable-plan
Syntax Description
This command has
no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
Release
Modification
6.0(2)N3(1)
This
command was introduced.
Usage Guidelines
This command
displays information specific to the cable plan that is imported. The cable
plan information includes the location of the imported file, mismatch delay
configuration values, cable-plan-check enable values, and details of all
entries that are related to the device.
If no cable plan
is imported, the output of the command will not display anything.
Configure the
featurelldp command before enabling cable management.
The following
table provides a list of cable plan status codes:
Table 3 Cable Plan
Status Codes
Status
Code
Description
Ok
Everything works as per the configured cable plan checks; the cable-plan check
is a success.
Unkn
Unable
to determine the status. Usually happens when a cable plan is not enforced or
there is no link between peers.
ErrC
The
port is error-disabled due to a mismatch (the peer does not match the entry in
the cable plan).
S
Specified at the end of a status. Usually happens when the port
is stale in the device because the neighboring port interface is in an
error-disabled mode.
Enp
An
entry is not present in the cable plan. Usually happens when there is no cable
plan record; however, there is a link between peers.
Examples
The following is
sample output from the
showfabricconnectivitycable-plan command:
Device# show fabric connectivity cable-plan
-------------------------------------------------------------------------------
Cable-Plan Enforce: Enforced File: No File
Mismatch Delay Config: Disabled Mismatch Delay Timeout: 0
DeviceID: host1.spine1 Last Deployed:
Md5: Size: 0
-------------------------------------------------------------------------------
Codes: (Ok) Normal, (ErrC) Cabling Plan error, (S) Stale entry
(Unkn) Unknown, (Enp) Entry not present in Cable-Plan
Current Cable-Plan:
-------------------------------------------------------------------------------
lChassisId lPortId rChassisId rPortId Status
The following
example shows how to enable cable management and import a cable plan from the
local location. If a cable plan is not imported the output of the
showfabricconnectivitycable-plan will not display anything:
(Optional)
Displays information about neighbors that are in cabling error state.
interface
(Optional)
Displays the list of neighbors connected to an interface.
ethernet
slot/chassis
(Optional)
Displays information about the specified Ethernet 802.3z interface. The range
for the
slot/chassis argument is from 1 to 253.
mgmt
interface-number
(Optional)
Displays information about the specified management interface.
tier
(Optional)
Displays the neighbors connected to an adjacent tier.
lower
(Optional)
Displays the neighbors connected to an adjacent lower tier.
upper
(Optional) Displays the neighbors connected to an adjacent upper
tier.
Command Modes
Privileged EXEC (#)
Command History
Release
Modification
6.0(2)N3(1)
This
command was introduced.
Usage Guidelines
This command
displays the data received by a device via the Link Layer Discovery Protocol
(LLDP) type, length, values (TLVs). The command also displays the local chassis
and port IDs, remote chassis and port ID, the tier levels of the remote
chassis, the expected cable-plan entry, and status of the configuration.
Examples
The following is
sample output from the
showfabricconnectivityneighbors command:
Device# show fabric connectivity neighbors
-------------------------------------------------------------------------------
Local System:
Device Tier Config: Enabled Device Tier Level: 2
Mismatch Delay Config: Disabled Mismatch Delay Timeout: 0
Cable-Plan Enforce: Enabled
DeviceID: host1 ChassisID: 000a.0001.0008
-------------------------------------------------------------------------------
Codes: (Ok) Normal, (ErrT) Tier error , (ErrC) Cable-Plan error,
(V) VPC Peer connection, (S) Stale entry, (Unkn) Unknown,
(Enp) Entry not present in Cable-Plan, (Tl) Tier level
Neighbor Table:
-------------------------------------------------------------------------------
Local DeviceID PortID Tl Cable-Plan Status
Intf Entry
Eth2/1 leaf0 Eth2/2 Unk Unkn Ok
Eth2/2 leaf1 Eth2/2 Unk Unkn Ok
Eth2/3 leaf2 Eth2/2 Unk Unkn Ok,S
Eth2/4 stewong-1 Eth2/2 Unk Unkn Ok
Eth2/5 leaf4 Eth2/2 Unk Unkn Ok
Eth2/6 leaf5 Eth2/2 Unk Unkn Ok
Eth2/7 leaf6 Eth2/2 Unk Unkn Ok,S
Eth2/8 leaf7 Eth2/2 Unk Unkn Ok
Total entries displayed: 8
Clears all information about neighbors from the neighbor cache.
show fabric
database statistics
To display fabric
database statistics, use the
show fabric database
statistics command in privileged EXEC mode.
show fabric database statistics
[ type
| { asset
| cabling
| profile
} ]
Syntax Description
type
(Optional)
Defines the type of statistics to display.
asset
(Optional)
Displays statistics of asset databases.
cabling
(Optional)
Displays statistics of cabling databases.
profile
(Optional)
Displays statistics of profile databases.
Command Default
Displays
statistics of all databases.
Command Modes
Privileged EXEC (#)
Command History
Release
Modification
7.0(0)N1(1)
This
command was introduced.
Examples
The following is
sample output from the
show fabric database
statistics command where statistics for all databases are
displayed. The fields are self-explanatory.
Device# show fabric database statistics
Global Stats:
DB-Type Requests Dispatched Not dispatched Re-dispatched
---------------------------------------------------------------------
Asset 3 1 2 0
Cabling 0 0 0 0
Profile 1 1 0 0
---------------------------------------------------------------------
TOTAL 4 2 2 0
Per Database stats:
T Prot Server/DB Reqs OK NoRes Err TmOut Pend
-------------------------------------------------------------------------------
A LDAP host91 1 0 1 0 0 0
ou=segments,dc=cisco,dc=com
P LDAP host91 1 1 0 0 0 0
ou=profiles,dc=cisco,dc=com
Legend:
T-Type (A-Asset, C-Cabling, P-Profile)
To display information about the host databases and configuration of the host mobility manager (HMM) component, use the show fabric forwarding command in privileged EXEC mode.
This command shows how to display host database information:
Device# show fabric forwarding host-db
This command shows how to display address family information:
Device# show fabric forwarding internal af
Number of URIB buffers in use/xid : 0/0
Number of U6RIB buffers in use/xid : 0/0
Number of VRFs in Update RIB List : 0
Update RIB event signalled count : 0
Update RIB thread wake up count : 0
This command shows how to display the internal buffer state maintained by HMM:
Device# show fabric forwarding internal buffers
HMM buffers information
This command shows how to display internal debug information maintained by HMM:
Device# show fabric forwarding internal debug
HMM Debug information
Debug Flags : Off
Debug-filters : Off
This command shows how to display auto-configuration events of HMM process:
Device# show fabric forwarding internal event-history auto-config
Process auto-config logs of HMM
1) Event:E_DEBUG, length:65, at 382460 usecs after Mon Dec 23 10:53:29 2013
[126] [10937]: Decrement outstanding PPM request (1/10) -> (0/10)
2) Event:E_DEBUG, length:65, at 376938 usecs after Mon Dec 23 10:53:29 2013
[126] [10937]: Decrement outstanding PPM request (2/10) -> (1/10)
3) Event:E_DEBUG, length:65, at 375093 usecs after Mon Dec 23 10:53:29 2013
[126] [10937]: Decrement outstanding PPM request (3/10) -> (2/10)
4) Event:E_DEBUG, length:65, at 373241 usecs after Mon Dec 23 10:53:29 2013
[126] [10937]: Decrement outstanding PPM request (4/10) -> (3/10)
--More--
This command shows how to display HMM error logs:
Device# show fabric forwarding internal event-history errors
Error events for HMM Process
This command shows how to display HMM process events:
Device# show fabric forwarding internal event-history events
Process Event logs of HMM
1) Event:E_DEBUG, length:58, at 788428 usecs after Sun Jan 12 09:44:36 2014
[117] [10937]: Received L3_PROTOCOL_STATE change msg, num 1
2) Event:E_DEBUG, length:58, at 786919 usecs after Sun Jan 12 09:44:36 2014
[117] [10937]: Received L3_PROTOCOL_STATE change msg, num 1
3) Event:E_DEBUG, length:58, at 784142 usecs after Sun Jan 12 09:44:36 2014
[117] [10937]: Received L3_PROTOCOL_STATE change msg, num 1
4) Event:E_DEBUG, length:51, at 777076 usecs after Sun Jan 12 09:44:36 2014
[117] [10937]: Received IF_CREATED change msg, num 1
--More--
This command shows how to display HMM message logs:
Device# show fabric forwarding internal event-history msgs
Msg events for HMM Process
1) Event:E_DEBUG, length:45, at 602003 usecs after Mon Jan 13 05:14:48 2014
[100] [32706]: nvdb: transient thread created
2) Event:E_DEBUG, length:83, at 601402 usecs after Mon Jan 13 05:14:48 2014
[100] [10944]: comp-mts-rx opc - from sap 27057 cmd hmm_show_internal_event_
hist_cmd
3) Event:E_DEBUG, length:42, at 918941 usecs after Mon Jan 13 05:14:15 2014
[100] [32699]: nvdb: terminate transaction
4) Event:E_DEBUG, length:45, at 896918 usecs after Mon Jan 13 05:14:15 2014
[100] [32699]: nvdb: transient thread created
--More--
This command shows how to display HMM process packet events:
Device# show fabric forwarding internal event-history packets
Process packet logs of HMM
This command shows how to display HMM process periodic events:
Device# show fabric forwarding internal event-history periodic
Process periodic event logs of HMM
1) Event:E_DEBUG, length:44, at 786068 usecs after Mon Jan 13 05:16:01 2014
[123] [10942]: HMM cleanup thread in progress
2) Event:E_DEBUG, length:44, at 785935 usecs after Mon Jan 13 05:15:56 2014
[123] [10942]: HMM cleanup thread in progress
3) Event:E_DEBUG, length:43, at 62257 usecs after Mon Jan 13 05:15:55 2014
[123] [10936]: Invoke profile bookkeeping...
4) Event:E_DEBUG, length:44, at 785801 usecs after Mon Jan 13 05:15:51 2014
[123] [10942]: HMM cleanup thread in progress
--More--
This command shows how to display processing logs of HMM commands:
Device# show fabric forwarding internal event-history trace
Trace logs of HMM
1) Event:E_DEBUG, length:58, at 210400 usecs after Mon Dec 23 10:53:29 2013
[119] [10935]: mts data queue bind success dynamic_sap=3137
This command shows how to display HMM local host database information:
Device# show fabric forwarding internal intf local-host-db
This command shows how to display HMM remote host database information:
Device# show fabric forwarding internal intf remote-host-db
This command shows how to display MAC-BD information:
Device# show fabric forwarding internal mac-bd local-host-db
This command shows how to display dynamic memory statistics:
Device# show fabric forwarding internal mem-stats
Mem stats for HMM Process
Private Mem stats for UUID : Malloc track Library(103) Max types: 5
--------------------------------------------------------------------------------
Curr alloc: 1728 Curr alloc bytes: 120844(118k)
Private Mem stats for UUID : Non mtrack users(0) Max types: 161
--------------------------------------------------------------------------------
Curr alloc: 740 Curr alloc bytes: 75035(73k)
Private Mem stats for UUID : libsdwrap(115) Max types: 22
--------------------------------------------------------------------------------
Curr alloc: 34 Curr alloc bytes: 2441304(2384k)
Private Mem stats for UUID : Associative_db library(175) Max types: 14
--------------------------------------------------------------------------------
Curr alloc: 156 Curr alloc bytes: 4400(4k)
Private Mem stats for UUID : Event sequence library(158) Max types: 4
--------------------------------------------------------------------------------
Curr alloc: 0 Curr alloc bytes: 0(0k)
--More--
This command shows how to display the HMM VIPs DB for migration:
Device# show fabric forwarding internal migration-vips
This command shows how to display internal state information maintained by HMM:
The following is
sample output from the
showfabric
multicastipv4rp-grangevrfall command:
Device# show fabric multicast ipv4 rp-grange vrf all
RP Grange Database for VRF "default" VNI: 0
RP Grange Database for VRF "vpn1" VNI: 5002
RP: 18.18.18.18 Group Range: 238.0.0.0/16
RP: 19.19.19.19 Group Range: 239.0.0.0/16
RP Grange Database for VRF "vpn2" VNI: 5003
RP Grange Database for VRF "vpn3" VNI: 5004
RP Grange Database for VRF "vpn4" VNI: 5005
The following is
sample output from the
showfabric
multicastipv4ssm-rangevrfall command:
Device# show fabric multicast ipv4 ssm-range vrf all
SSM Range Database for VRF "default" VNI: 0
SSM Group Range: 232.0.0.0/8
SSM Range Database for VRF "vpn1" VNI: 5002
SSM Group Range: 232.0.0.0/8
SSM Range Database for VRF "vpn2" VNI: 5003
SSM Group Range: 232.0.0.0/8
SSM Range Database for VRF "vpn3" VNI: 5004
SSM Group Range: 232.0.0.0/8
SSM Range Database for VRF "vpn4" VNI: 5005
SSM Group Range: 232.0.0.0/8
Enables multicast enhanced fabric forwarding for a particular VRF.
show fabric
multicast vrf
To display the
virtual routing and forwarding (VRFs) learned by the fabric multicast process
and virtual network identifiers (VNI) configured under the VRFs, use the
showfabricmulticastvrf command in privileged EXEC mode.
show fabric multicast vrf
[ vrf-name
| all
| default
| management ]
Syntax Description
vrf-name
(Optional)
VRF name.
all
(Optional)
Displays all VRFs learned by the fabric multicast process and the VNIs
configured under the VRFs.
default
(Optional)
Displays VNIs configured under the default VRF.
management
(Optional)
Displays VNIs configured under the management VRF.
Command Modes
Privileged EXEC (#)
Command History
Release
Modification
7.0(0)N1(1)
This
command was introduced.
Examples
The following is
sample output from the
showfabric
multicastvrfall command:
Device> enable
Device# show fabric multicast vrf all
VRF Name VRF VN-Seg
ID ID
default 1 0
vpn1 4 5002
vpn2 5 5003
vpn3 6 5004
vpn4 7 5005
Displays the global state associated with the fabric multicast process.
show fabricpath isis
To display information about FabricPath Intermediate System-to-Intermediate System (IS-IS), use the show fabricpath isis command in privileged EXEC or global configuration mode.
showfabricisis
Syntax Description
This command has
no arguments or keywords.
Command Modes
Privileged EXEC (#)
Global configuration (config)
Command History
Release
Modification
6.0(2)N1(1)
This
command was introduced.
7.0(0)N1(1)
This command was modified in Cisco NX-OS Release 7.0(0)N1(1). The following fields
were included in the display:
Graceful Restart Holding
LSP Lifetime
L1 LSP GEN interval
L1 SPF Interval
Max-Path
Usage Guidelines
This command requires an Enhanced Layer 2 license. You can store the output of the command in an external file by including the > symbol after the command, followed by the name of the file and the type of storage location. You can add the output from the command to an existing file using the >> symbol.
Examples
The following
example shows how to display information about FabricPath IS-IS in privileged EXEC mode:
Device(config)# show fabricpath isis
Fabricpath IS-IS domain : default
System ID : 547f.eea9.f73c IS-Type : L1 Fabric-Control SVI: Unknown
SAP : 432 Queue Handle : 11
Maximum LSP MTU: 1492
Graceful Restart enabled. State: Inactive
Last graceful restart status : none
Graceful Restart holding time:60
Metric-style : advertise(wide), accept(wide)
Start-Mode: Complete [Start-type configuration]
Area address(es) :
00
Process is up and running
CIB ID: 1
Interfaces supported by Fabricpath IS-IS :
Level 1
Authentication type and keychain not configured
Authentication check specified
LSP Lifetime: 1200
L1 LSP GEN interval- Max:8000 Initial:50 Second:50
L1 SPF Interval- Max:8000 Initial:50 Second:50
MT-0 Ref-Bw: 400000
Max-Path: 16
Address family Swid unicast :
Number of interface : 0
Distance : 115
L1 Next SPF: Inactive
show fabricpath isis interface
To display information about the FabricPath Intermediate System-to-Intermediate System (IS-IS) interface, use the show fabricpath isis interface command in privileged EXEC or global configuration mode.
Displays brief information about the IS-IS interface.
ethernet
Displays information about the Ethernet interface.
slot/
Slots from 1 to 8.
Slots 1 to 4 are fixed Linecard Expansion Modules (LEMs).
Slots 5 to 8 are hot-swappable LEMs.
port
Port number within a particular slot. Range is from 1 to 128.
port-channel
Displays the information about port-channel interface.
channel-number
Port-channel number. Range is from 1 to 4096.
Command Modes
Privileged EXEC (#)
Global configuration (config)
Command History
Release
Modification
6.0(2)N1(1)
This
command was introduced.
7.0(0)N1(1)
This command was modified in Cisco NX-OS Release 7.0(0)N1(1). The QSFP-module argument was removed.
Usage Guidelines
The showfabricpathisisinterface command requires an Enhanced Layer 2 license. You can store the output of the command in an external file by including the > symbol after the command, followed by the name of the file and the type of storage location. You can add the output from the command to an existing file using the >> symbol.
Examples
This example shows how to display brief information about the FabricPath IS-IS interface:
To display
information about FabricPath Operation, Administration, and Maintenance (OAM)
loopback, use the
show
fabricpathoam
loopback command in privileged EXEC mode.
(Optional)
Displays information about FabricPath OAM loopback for a specific session.
Command Modes
Privileged EXEC (#)
Command History
Release
Modification
7.0(0)N1(1)
This
command was introduced.
Usage Guidelines
When a
ping command
returns errors and the details are not available in the command output, you can
use the
show
fabricpathOAM
loopbackdatabase command to see the details.
A session is an
auto-generated identifier for a proactive loopback request.
Examples
The following is
sample output from the
show fabricpath OAM
loopback statistics command.
Device# show fabricpath OAM loopback statistics
Sender Handle: 10
Last Clear of Statistics: Never
Loopback Reply/notification return code distribution:
V – VLAN nonexistent (0) - 0
v – VLAN in suspended state (1) - 0
C – Cross Connect Error (2) - 0
U – Unknown RBridge nickname (3) - 0
n – Not AF (4) - 0
M – MTU mismatch (5) - 0
I – Interface not in forwarding state (6) - 0
S – Service Tag nonexistent (7) - 0
s – Service Tag in suspended state (8) - 0
! - success - 5
m – malformed request - 0
Q – request not sent - 0
. – timeout - 0
D – Destination unreachable - 0
X – Unknown return code - 0
The following is
sample output from the
show fabricpath OAM
loopback statistics summary command.
Device# show fabricpath OAM loopback statistics summary
Loopback Requests: sent (5)/received (0)/timeout (0)/unsent (0)
Loopback Replies: sent (0)/received (5)/unsent (0)
The following is
sample output from the
show fabricpath OAM
loopback status command.
Device(#) show fabricpath OAM loopback status
Sender Handle Type State
1 on demand completed
10 Asynchronous running(No Error)
The following is
sample output from the
show fabricpath OAM
loopback database command.
Device(#) show fabricpath OAM loopback database
Loopback Request from switch-id 10
Sender handle: 1
Last Clear of Statistics: Never
Start time: 00:00:10
End time: NA
Id: sent: 5 timeout: 0 unsent: 0 Interface: NA
Hop limit: 2 Flags: 0 switch-id: 10
Forward Flow Entropy: Default
Reverse Flow Entropy: NA
Service Tag: NA Vlan: 10 out of band: No
Reverse Path Req(ecmp/nickname): NA
Control Plane Verification Req(ecmp/nickname):NA
Reply: received (5)
Reverse Resp (ecmp cnt: 1, (ecmp id: 0xFFFF, ifindex: 32, slot:0, port:0, state:10, state:fwd))
Forward Resp (ecmp cnt: 1, (ecmp id: 0xFFFF, ifindex: 32, slot:0, port:0, state:10, state:fwd))
To display
information about fabricpath Operation, Administration, and Maintenance (OAM)
mtrace, use the
show
fabricpathoammtrace command in privileged EXEC mode.
When the
mtrace
command returns errors and the details are not available in the command output,
you can use the
showfabricpathoammtracedatabase command to see the details.
Examples
The following is
sample output from the
show fabricpath oam
mtrace statistics command.
Device(#) show fabricpath OAM mtrace statistics
Mtrace Reply/notification return code distribution:
V – VLAN nonexistent (0) - 0
v – VLAN in suspended state (1) - 0
C – Cross Connect Error (2) - 0
U – Unknown RBridge nickname (3) - 0
n – Not AF (4) - 0
M – MTU mismatch (5) - 0
I – Interface not in forwarding state (6) - 0
S – Service Tag nonexistent (7) - 0
s – Service Tag in suspended state (8) - 0
! - success - 5
m – malformed request - 0
Q – request not sent - 0
. – timeout - 0
D – Destination unreachable - 0
X – Unknown return code - 0
Mtrace Requests: sent (5)/received (0)/timedout (0)/unsent (0)
Mtrace Replies: sent (0)/received (25)/unsent (0)
The following is
sample output from the
show fabricpath oam
mtrace statistics summary command.
Device(#) show fabricpath OAM mtrace statistics summary
Mtrace Requests: sent (5)/received (0)/timeout (0)/unsent (0)
Mtrace Replies: sent (0)/received (25)/unsent (0)
The following is
sample output from the
show fabricpath oam
mtrace database command.
Device(#) show fabricpath OAM mtrace database
Sender handle: 2
Mtrace request from switch-id 10
Id: sent: 1 timeout: 0 unsent: 0
Tree ID: 1 Vlan : 5 Hop limit: 2
Forward Flow Entropy: Default
Reverse Flow Entropy: NA
Service Tag: NA Vlan: 10 out of band: No
Control Plane Verification Req(ecmp/nickname):1/15
Reply: received (2)
Control Plane Resp from switch-id 112
2 next hop Rbridges
Switch-id 11 ifindex 0x00010023 Slot 3 Port 5 Speed 10M State – forwarding no error
Switch-id 789 ifindex 0x00230782 Slot 5 Port 11 Speed 1G State – forwarding no error
ecmp cnt: 1, (ecmp id: 0xFFFF, ifindex: 32, slot:0, port:0, state:10, state:fwd)
Control Plane Resp from switch-id 13
ecmp cnt: 1, (ecmp id: 0xFFFF, ifindex: 32, slot:0, port:0, state:10, state:fwd)
Traces the path from a source to a destination branch for FabricPath OAM.
show fabricpath
oam notification
To display
information about FabricPath Operation, Administration, and Maintenance (OAM)
notifications, use the
showfabricpathoamnotification command in privileged EXEC mode.
Displays
information about the FabricPath OAM notification database.
statistics
Displays
information about FabricPath OAM notification statistics.
Command Modes
Privileged EXEC (#)
Command History
Release
Modification
7.0(0)N1(1)
This
command was introduced.
Examples
The following is
the sample output from the
show fabricpath OAM
notification statistics command.
Device(#) show fabricpath OAM notification statistics
Last Clearing of Statistics: Never
Notfication Received: 0
Time Expiry: 0
Destination Unreachable: 0
Parameter Problem: 0
To display
information about FabricPath Operation, Administration, and Maintenance (OAM),
use the
show
fabricpathoamtraceroute command in privileged EXEC mode.
When a
traceroute
command returns errors and the details are not available in the command output,
you can use the
show
fabricpathOAM
traceroutedatabase command to see the details.
A session is an
auto-generated identifier for a proactive traceroute request.
Examples
The following is
sample output from the
show fabricpath OAM
traceroute statistics command.
Device# show fabricpath OAM traceroute statistics
Last Clear of Statistics: Never
Traceroute Reply/notification return code distribution
V – VLAN nonexistent (0) - 0
v – VLAN in suspended state (1) - 0
C – Cross Connect Error (2) - 0
U – Unknown RBridge nickname (3) - 0
n – Not AF (4) - 0
M – MTU mismatch (5) - 0
I – Interface not in forwarding state (6) - 0
S – Service Tag nonexistent (7) - 0
s – Service Tag in suspended state (8) - 0
! - success - 5
m – malformed request - 0
Q – request not sent - 0
. – timeout - 0
D – Destination unreachable - 0
X – Unknown return code - 0
Path Trace Requests: sent (5)/received (0)/timedout (0)/unsent (0)
Path Trace Replies: sent (0)/received (5)/unsent (0)
The following is
sample output from the
show fabricpath OAM
traceroute statistics summary command.
Device# show fabricpath OAM traceroute statistics summary
Path Trace Requests: sent (5)/received (0)/timeout (0)/unsent (0)
Path Trace Replies: sent (0)/received (5)/unsent (0)
The following is
sample output from the
show fabricpath OAM
traceroute database command.
Device# show fabricpath OAM traceroute database
Sender handle: 2
Path Trace Request from switch-id 10
Id: sent: 5 timeout: 0 unsent: 0 Interface: NA
Hop limit: 2 Flags: 0 switch-id: 10
Forward Flow Entropy: Default
Reverse Flow Entropy: NA
Service Tag: NA Vlan: 10 out of band: No
Reverse Path Req(ecmp/nickname): NA
Control Plane Verification Req(ecmp/nickname):NA
Reply: received (5)
Reverse Resp (ecmp cnt: 1, (ecmp id: 0xFFFF, ifindex: 32, slot:0, port:0, state:10, state:fwd))
Forward Resp (ecmp cnt: 1, (ecmp id: 0xFFFF, ifindex: 32, slot:0, port:0, state:10, state:fwd))
To display the
Energy Efficient Ethernet (EEE) status on an interface, use the
showinterfaceethernet command.
showinterfaceethernetslot/chassis
Syntax Description
slot/chassis
Slot or
chassis number. The range is from 1 to 253.
Command Modes
Any command mode
Supported User
Roles
network-admin
network-operator
vdc-admin
vdc-operator
Command History
Release
Modification
6.0(2)N3(1)
This
command was introduced in an earlier NX-OS release.
Usage Guidelines
This command does
not require a license.
Examples
The following
sample output shows the EEE status on an interface:
Device# show interface ethernet 2/6
Ethernet2/6 is down (Link not connected)
admin state is up, Dedicated Interface
Hardware: 10000 Ethernet, address: 0022.5579.de41 (bia 001b.54c1.af5d)
MTU 1500 bytes, BW 10000000 Kbit, DLY 10 usec
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation ARPA, medium is broadcast
auto-duplex, auto-speed, media type is 10G
Beacon is turned off
Auto-Negotiation is turned off
Input flow-control is off, output flow-control is off
Auto-mdix is turned off
Rate mode is shared
Switchport monitor is off
EtherType is 0x8100
EEE (efficient-ethernet) : n/a
Last link flapped never
Last clearing of "show interface" counters never
0 interface resets
30 seconds input rate 0 bits/sec, 0 packets/sec
30 seconds output rate 0 bits/sec, 0 packets/sec
Load-Interval #2: 5 minute (300 seconds)
input rate 0 bps, 0 pps; output rate 0 bps, 0 pps
L3 in Switched:
ucast: 0 pkts, 0 bytes - mcast: 0 pkts, 0 bytes
.
.
.
show interface
status err-disabled
To display
information about interfaces that are in error-disabled state, use the
showinterfacestatuserr-disabled command in privileged EXEC mode.
showinterfacestatuserr-disabled
Syntax Description
This command has
no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
Release
Modification
6.0(2)N3(1)
This
command was introduced.
Usage Guidelines
Miscabling
interfaces, or interfaces in error-disabled state, prevent all traffic from
leaving these interfaces. Error disabling is one way of bringing down an
interface via software.
Examples
The following is
sample output from the
showinterfacestatuserr-disabled command:
Device# show interface status err-disabled
----------------------------------------------------------------------------
Port Name Status Reason
----------------------------------------------------------------------------
Eth2/1 -- down fabric tier-mismatch
The following sample output displays ARP error log messages:
Device# show ip arp internal event-history errors
1)Event :E_DEBUG, length:40, at 763259 usecs after Wed Oct 9 16:37:49 2013
[120] [4174]: Zero Ip on iod Ethernet2/1
2)Event:E_DEBUG, length:40, at 755456 usecs after Wed Oct 9 16:37:48 2013
[120] [4174]: Zero Ip on iod Ethernet2/2
3)Event:E_DEBUG, length:34, at 52925 usecs after Wed Oct 9 16:21:37 2013
[120] [4174]: Zero Ip on iod mgmt0
To view the current buffer size of Address Resolution Protocol (ARP) event log message types, use the
show ip arp internalevent-historybuffer-size command in privileged EXEC mode.
show ip arp internalevent-historybuffer-size {
all |
cli |
client-errors |
client-event |
control |
errors |
event |
ha |
ip-sync-event |
lcache |
lcache-errors |
packet |
snmp |
sync-event}
Syntax Description
all
Displays the current buffer size for all ARP event log message types.
cli
Displays the current buffer size for the ARP CLI-related event log messages.
client-errors
Displays the current buffer size for the ARP client error log messages.
client-event
Displays the current buffer size for the ARP client event log messages.
control
Displays the current buffer size for the ARP control event log messages.
errors
Displays the current buffer size for the ARP error log messages.
event
Displays the current buffer size for the ARP event log messages.
ha
Displays the current buffer size for the ARP High Availability (HA)-related log messages.
ip-sync-event
Displays the current buffer size for the ARP-related layer 3 (L3) routing traffic over virtual port channel (vPC) event log messages.
lcache
Displays the current buffer size for the ARP lcache log messages.
lcache-errors
Displays the current buffer size for the ARP lcache error log messages.
packet
Displays the current buffer size for the ARP packet log messages.
snmp
Displays the current buffer size for the Simple Network Management Protocol (SNMP) log messages.
sync-event
Displays the current buffer size for the ARP-related Cisco Fabric Services (CFS) and multichassis EtherChannel Manager (MCECM) log messages.
Command Modes
Privileged EXEC (#)
Command History
Release
Modification
7.0(0)N1(1)
This
command was introduced.
Examples
The following sample output displays the buffer size for all ARP event log message types:
To view Address Resolution Protocol (ARP) statistics, use the
show ip arp statistics command in privileged EXEC mode.
show ip arp statistics
[
ethernetinterface-number
[
.sub-interface-number ]
|
loopbackinterface-number |
mgmtmanagement-interface-number] [
interface-all] [
vrf {
vrf-name |
all |
default |
management}]
Syntax Description
ethernetinterface-number
(Optional) Displays ARP statistics for the specified ethernet interface.
.sub-interface-number
(Optional) Subinterface number for which ARP statistics will be displayed.
Note
The period (.) needs to precede the sub-interface-number argument value.
loopbackinterface-number
(Optional) Displays ARP statistics for the specified loopback interface.
mgmtmanagement-interface-number
(Optional) Displays ARP statistics for the specified management interface.
interface-all
(Optional) Displays ARP statistics for all interfaces.
vrfvrf-name
(Optional) Displays ARP statistics for the specified VRF instance.
vrfall
(Optional) Displays ARP statistics for all VRF instances.
vrfdefault
(Optional) Displays ARP statistics for the default VRF instance.
vrfmanagement
(Optional) Displays ARP statistics for the management VRF instance.
Command Modes
Privileged EXEC (#)
Command History
Release
Modification
7.0(0)N1(1)
This
command was introduced.
Examples
The following sample output shows ARP statistics for an Ethernet subinterface:
Device# show ip arp statistics ethernet 2/1.1
ARP packet statistics for interface: Ethernet2/1.1
Sent:
Total 0, Requests 0, Replies 0, Requests on L2 0, Replies on L2 0,
Gratuitous 0, Tunneled 0, Dropped 0 from Server Port 0, from Fabric Port 0,
fixup core 0, fixup server 0, fixup rarp 0, modified anycast glean 0
Send packet drops details:
MBUF operation failed : 0
Context not yet created : 0
Invalid context : 0
Invalid ifindex : 0
Invalid SRC IP : 0
Invalid DEST IP : 0
Destination is our own IP : 0
Unattached IP : 0
Adjacency Couldn't be added : 0
Null Source IP : 0
Null Source MAC : 0
Client Enqueue Failed : 0
Dest. not reachable for proxy arp : 0
Dest. unreachable for enhanced proxy: 0
Dest. on L2 port being tracked : 0
Invalid Local proxy arp : 0
Invalid proxy arp : 0
VIP is not active : 0
Received:
Total 0, Requests 0, Replies 0, Requests on L2 0, Replies on L2 0
Proxy arp 0, Local-Proxy arp 0, Enhanced Proxy arp 0, Anycast proxy Proxy arp 0, L2 Port-track Proxy arp 0, Tunneled 0,
Fastpath 0, Snooped 0, Dropped 0, on Server Port 0
Received packet drops details:
Appeared on a wrong interface : 0
Incorrect length : 0
Invalid protocol packet : 0
Invalid context : 0
Context not yet created : 0
Invalid layer 2 address length : 0
Invalid layer 3 address length : 0
Invalid source IP address : 0
Source IP address is our own : 0
No mem to create per intf structure : 0
Source address mismatch with subnet : 0
Directed broadcast source : 0
Invalid destination IP address : 0
Non-local destination IP address : 0
Non-active FHRP dest IP address. Learn and drop : 0
Invalid source MAC address : 0
Source MAC address is our own : 0
Received before arp initialization : 0
Displays current buffer size of ARP event log message types.
show logging level
evb
To display the
system log (syslog) filter level for an Edge Virtual Bridging (EVB) session,
use the
showlogginglevelevb command in privileged EXEC mode.
showlogginglevelevb
Command Default
None
Command Modes
Privileged EXEC (#)
Command History
Release
Modification
7.0(0)N1(1)
This
command was introduced.
Usage Guidelines
Use the
featureevb command to enable the EVB session. This, in
turn, enables the
evb keyword
in the
logging level
command and the
show logging
level command on the device. Use the
show logging level
evb command to identify the default and the current severity
levels of the EVB session.
Examples
The following is
sample output from the
show logging level
evb command in which, for an EVB session, the default severity
level is 5 and the user-defined syslog filter level is 4:
(Optional)
Enter a start time to log messages in the format
yyyy mmm dd
hh:mm:ss. Use three characters for the month (mmm) field, digits for the year (yyyy) and day (dd) fields, and digits separated by colons for the
time (hh:mm:ss)
field.
end-time
(Optional)
Enter an end time to log messages in the format
yyyy mmm dd
hh:mm:ss. Use three characters for the month (mmm) field, digits for the year (yyyy) and day (dd) fields, and digits separated by colons for the
time (hh:mm:ss)
field.
Command Modes
Any command mode
Supported User
Roles
network-admin
network-operator
vdc-admin
vdc-operator
Command History
Release
Modification
6.0(2)N3(1)
This
command was introduced in an earlier Cisco NX-OS release.
Usage Guidelines
If you do not
enter an end time, the current time is used.
This command
does not require a license.
Examples
This example
shows how to display the messages in the log file that were timestamped within
the span shown:
Device# show logging logfile start-time 2008 mar 11 12:10:00
Device#
show
param-list
To display all
user-defined parameter lists configured in a device, use the
show
param-list command in privileged EXEC mode.
(Optional)
Displays details of a specific user-defined parameter.
show-instance
(Optional)
Displays details of instances created for user-defined parameters.
Command Modes
Privileged EXEC (#)
Command History
Release
Modification
7.0(0)N1(1)
This
command was introduced.
Usage Guidelines
The
show
param-list command displays all parameter lists configured in the
device. To view the instances of all the parameter lists, use the
show param-list
show-instance command. To view the instances of a specific
user-defined parameter list, use the
show param-list
param-list-namelist-nameshow-instance command.
Examples
The following
sample output from the
show
param-list command displays all parameter lists configured in the
device:
Device(config)# show param-list
Param List Name : param-prof1-list
Name : ipaddr Type : ipaddr
Name : prog1 Type : string
Name : segid Type : integer
Name : vlan_num Type : integer
Param List Name : param-prof2-list
Name : l2-segid Type : integer
Name : l3-segid Type : integer
Name : ipv4addr Type : ipaddr
Name : ipv6addr Type : ipaddr
The following
sample output from the
show param-list
show-instance command displays instances of all parameter lists
available in the device:
Device(config)# show param-list show-instance
Param List Name : param-prof1-list
Name : ipaddr Type : ipaddr
Name : prog1 Type : string
Name : segid Type : integer
Name : vlan_num Type : integer
Param Instance Name : param-prof1-inst1
Name : ipaddr Value : 192.0.2.12
Name : prog1 Value : vrf-300
Name : segid Value : 6300
Name : vlan_num Value : 300
Param Instance Name : param-prof1-inst2
Name : ipaddr Value : 192.0.2.10
Name : prog1 Value : 330-vrf-2
Name : segid Value : 6301
Name : vlan_num Value : 301
Param List Name : param-prof2-list
Name : l2-segid Type : integer
Name : l3-segid Type : integer
Name : ipv4addr Type : ipaddr
Name : ipv6addr Type : ipaddr
Param Instance Name : param-prof2-inst1
Name : l2-segid Value : 6305
Name : l3-segid Value : 6306
Name : ipv4addr Value : 192.0.2.5
Name : ipv6addr Value : 2001:DB8::1
Param Instance Name : param-prof2-inst2
Name : l2-segid Value : 6307
Name : l3-segid Value : 6308
Name : ipv4addr Value : 192.0.2.8
Name : ipv6addr Value : 2001:DB8::1
The following
sample output from the
show param-list
param-list-namelist-nameshow-instance command displays instances of the
param-prof1-list parameter list:
Device(config)# show param-list param-list-name param-prof1-list show-instance
Param List Name : param-prof1-list
Name : ipaddr Type : ipaddr
Name : prog1 Type : string
Name : segid Type : integer
Name : vlan_num Type : integer
Param Instance Name : param-prof1-inst1
Name : ipaddr Value : 192.0.2.12
Name : prog1 Value : vrf-300
Name : segid Value : 6300
Name : vlan_num Value : 300
Param Instance Name : param-prof1-inst2
Name : ipaddr Value : 192.0.2.10
Name : prog1 Value : 330-vrf-2
Name : segid Value : 6301
Name : vlan_num Value : 301
Displays the statistical information about the startup configuration of a parameter list.
show
running-config evb
To display the
currently running configuration of an Edge Virtual Bridging (EVB) session, use
the
showrunning-configevb command in privileged EXEC mode.
showrunning-configevb
[ all ]
Syntax Description
all
(Optional)
Displays the currently running configuration of an EVB session including all
defaults.
Command Default
Displays the
current configuration of the EVB session without any defaults.
Command Modes
Privileged EXEC (#)
Command History
Release
Modification
7.0(0)N1(1)
This
command was introduced.
Usage Guidelines
Use the
featureevb command to enable the EVB session. This, in
turn, enables the
evb keyword
in the
show
running-config command on the device.
Examples
The following is
sample output from the
show running-config
evb command in an EVB session:
Device# show running-config evb
!Command: show running-config evb
!Time: Thu Oct 10 20:26:42 2013
version 6.2(1)
feature evb
logging level evb 6
evb reinit-keep-alive 21
evb resource-wait-delay 21
evb mac 0123.4567.89AB
To display the
running configurations made for the fabric multicast process, use the
show running-config fabric
multicast command in privileged EXEC mode.
showrunning-configfabricmulticast
[ all ]
Syntax Description
all
(Optional)
Display all configurations made for the fabric multicast process.
Command Modes
Privileged EXEC (#)
Command History
Release
Modification
7.0(0)N1(1)
This
command was introduced.
Examples
The following is
sample output from the
showrunning-configfabricmulticast command:
Device# show running-config fabric multicast all
!Command: show running-config fabric multicast all
!Time: Tue Oct 22 02:17:35 2013
version 6.2(1)
feature fabric multicast
ip multicast fabric-forwarding
Related Commands
Command
Description
Related Information
ip multicast fabric-pruning
Sets the multicast fabric-pruning to a desired level.
show
running-config param-list
To display the
configurations of a parameter list saved to the running configuration file of a
configured parameter list, use the
show running-config
param-list command in privileged EXEC mode.
showrunning-configparam-list
[param-list-name]
Syntax Description
param-list-name
(Optional) The name of the parameter list.
The
maximum number of characters is 80.
Command Modes
Privileged EXEC (#)
Command History
Release
Modification
7.0(0)N1(1)
This
command was introduced.
Usage Guidelines
Use this command
to display configured commands in the running configuration of a
parameter list.
Examples
The following is
sample output from the
show running-config
param-list command after configuring a parameter list:
! Configuring a Parameter list
Device> enable
Device# configure terminal
Device(config)# param-list param-prof1-list
Device(config-param-list)# define ipaddr ipaddr
Device(config-param-list)# define prog1 string
Device(config-param-list)# define segid integer
Device(config-param-list)# define vlan_num integer
Device(config-param-list)# instance param-prof1-inst1
Device(config-param-inst)# set ipaddr 192.0.2.1/24
Device(config-param-inst)# set prog1 vrf-300
Device(config-param-inst)# set segid 6300
Device(config-param-inst)# set vlan_num 300
Device(config-param-inst)# instance param-prof1-inst2
Device(config-param-inst)# set ipaddr 192.0.2.2/24
Device(config-param-inst)# set prog1 330-vrf-2
Device(config-param-inst)# set segid 6301
Device(config-param-inst)# set vlan_num 301
Device(config-param-inst)# exit
Device(config-param-list)# exit
! Displaying the running configuration of a parameter list
Device(config)# show running-config param-list param-prof1-list
!Command: show running-config param-list param-prof1-list
!Time: Thu Nov 28 00:37:25 2013
version 6.2(1)
param-list param-prof1-list
define ipaddr ipaddr
define prog1 string
define segid integer
define vlan_num integer
instance param-prof1-inst1
set ipaddr 192.0.2.1/24
set prog1 vrf-300
set segid 6300
set vlan_num 300
instance param-prof1-inst2
set ipaddr 192.0.2.2/24
set prog1 330-vrf-2
set segid 6301
set vlan_num 301
Device(config)# end
Displays all user-defined parameter lists configured in a device.
show
startup-config evb
To display the
configuration of an Edge Virtual Bridging (EVB) session stored in the NVRAM
that will be used at the next device startup, use the
showstartup-configevb command in privileged EXEC mode.
showstartup-configevb
[ all ]
Syntax Description
all
(Optional)
Displays the configuration of an EVB session from the NVRAM, including all
defaults.
Command Default
Displays the
configuration of the EVB session from the NVRAM without any defaults.
Command Modes
Privileged EXEC (#)
Command History
Release
Modification
7.0(0)N1(1)
This
command was introduced.
Usage Guidelines
Use the
featureevb command to enable the EVB session. This, in
turn, enables the
evb keyword
in the
show
startup-config command on the device.
Examples
The following is
sample output from the
show startup-config
evb command in an EVB session:
Device# show startup-config evb
!Command: show startup-config evb
!Time: Thu Oct 10 20:28:36 2013
!Startup config saved at: Thu Oct 10 20:24:00 2013
version 6.2(1)
feature evb
logging level evb 6
evb reinit-keep-alive 21
evb resource-wait-delay 21
evb mac 0123.4567.89AB
To display the
configurations of a parameter list saved to the startup configuration file of a
configured parameter list, use the
show startup-config
param-list command in privileged EXEC mode.
showstartup-configparam-list
[param-list-name]
Syntax Description
param-list-name
(Optional) The name of the parameter list.
The
maximum number of characters is 80.
Command Modes
Privileged EXEC (#)
Command History
Release
Modification
7.0(0)N1(1)
This
command was introduced.
Usage Guidelines
Use this command
to display configured parameters saved to the startup configuration of a
parameter list.
Examples
The following is
sample output from the
show startup-config
param-list command after configuring a parameter list:
! Configuring a Parameter list
Device> enable
Device# configure terminal
Device(config)# param-list param-prof1-list
Device(config-param-list)# define ipaddr ipaddr
Device(config-param-list)# define prog1 string
Device(config-param-list)# define segid integer
Device(config-param-list)# define vlan_num integer
Device(config-param-list)# instance param-prof1-inst1
Device(config-param-inst)# set ipaddr 192.0.2.1/24
Device(config-param-inst)# set prog1 vrf-300
Device(config-param-inst)# set segid 6300
Device(config-param-inst)# set vlan_num 300
Device(config-param-inst)# instance param-prof1-inst2
Device(config-param-inst)# set ipaddr 192.0.2.2/24
Device(config-param-inst)# set prog1 330-vrf-2
Device(config-param-inst)# set segid 6301
Device(config-param-inst)# set vlan_num 301
Device(config-param-inst)# exit
Device(config-param-list)# exit
Device(config)# copy running-config startup-config
[########################################] 100%
Copy complete.
! Displaying the startup configuration of a parameter list
Device(config)# show startup-config param-list param-prof1-list
!Command: show startup-config param-list param-prof1-list
!Time: Thu Nov 28 02:51:51 2013
!Startup config saved at: Thu Nov 28 02:51:30 2013
version 6.2(1)
param-list param-prof1-list
define ipaddr ipaddr
define prog1 string
define segid integer
define vlan_num integer
instance param-prof1-inst1
set ipaddr 192.0.2.1/24
set prog1 vrf-300
set segid 6300
set vlan_num 300
instance param-prof1-inst2
set ipaddr 192.0.2.2/24
set prog1 330-vrf-2
set segid 6301
set vlan_num 301
Device(config)# end
Displays all user-defined parameter lists configured in a device.
show tech-support
fabric multicast
To display all
show commands and event histories associated
with fabric multicast process, use the
show tech-support fabric
multcast command in virtual services configuration mode.
showtech-support fabric_mcast
Syntax Description
This command has
no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
Release
Modification
7.0(0)N1(1)
This
command was introduced.
Examples
The following is
sample output from the
show tech-support fabric
multicast command:
Device# show tech-support fabric multicast
`show running-config fabric multicast`
!Command: show running-config fabric multicast
!Time: Tue Oct 22 16:42:32 2013
version 6.2(1)
feature fabric multicast
ip multicast fabric-forwarding
`show system internal sysmgr service name fabric_mcast`
Service "fabric_mcast" ("fabric_mcast", 119):
UUID = 0x4B3, PID = 14139, SAP = 1241
State: SRV_STATE_HANDSHAKED (entered at time Tue Oct 22 16:42:03 2013).
Restart count: 2
Time of last restart: Tue Oct 22 16:42:03 2013.
The service never crashed since the last reboot.
Tag = N/A
Plugin ID: 1
`show system internal feature-mgr feature state | include fabric_mcast`
fabric_mcast 0x000004b3 enabled SUCCESS
`show processes threads fabric_mcast`
Thread-name Pid Stack-base Stack-size Bytes used MaxTime
`show fabric multicast vrf all`
Note: process currently not running
`show fabric multicast globals`
Note: process currently not running
`show fabric multicast ipv4 mroute vrf all`
Note: process currently not running
`show fabric multicast ipv6 mroute vrf all`
Note: process currently not running
`show fabric multicast ipv4 ssm-range vrf all`
Note: process currently not running
`show fabric multicast ipv6 ssm-range vrf all`
Note: process currently not running
`show fabric multicast ipv4 rp-grange vrf all`
Note: process currently not running
`show fabric multicast ipv6 rp-grange vrf all`
Note: process currently not running
`show system internal fabric multicast ipv4 nexthop mapping`
Note: process currently not running
`show system internal fabric multicast ipv6 nexthop mapping`
Note: process currently not running
`show fabric multicast internal txlist detail vrf all`
Note: process currently not running
`show fabric multicast internal client-buffers`
Note: process currently not running
`show fabric multicast internal statistics`
Note: process currently not running
`show fabric multicast internal event-history errors`
Note: process currently not running
`show fabric multicast internal event-history msgs`
system fabric core-vlans
To specify the VLAN ID or range of VLAN IDs used for core-facing interfaces, use the system fabric core-vlans command in
global configuration mode. To remove the specified VLAN ID or range of VLAN IDs, use the no form of this command.
system fabric core-vlansvlan-id-or-range
no system fabric core-vlans
Syntax Description
vlan-id-or-range
VLAN ID or range. You can specify VLAN IDs from 1 to 4094. The VLAN range is 1-5, 10 or 2-5, and 7-19.
Command Default
No default range of VLAN IDs is specified.
Command Modes
Global configuration (config)
Command History
Release
Modification
7.0(0)N1(1)
This command was introduced.
Usage Guidelines
Use the system fabric core-vlans command to specify the set of VLANs that are used for core-facing interfaces. You can specify only those VLANs that are a subset of the fabric-reserved VLANs defined using the system fabric dynamic-vlans command. You an use the system fabric core-vlans command only after you have enabled the feature fabric forwarding command.
Note
There can be no existing VLANS in the range you specify by using the system fabric core-vlans command.
Examples
The following example shows how to specify a VLAN ID or a range of VLAN IDs for a device:
To specify the VLAN ID or range of core and server and core or host-facing VLANs for a device, use the system fabric dynamic-vlans command in
global configuration mode. To remove the specified VLAN ID or range of VLAN IDs, use the no form of this command.
system fabric dynamic-vlansvlan-id-or-range
no system fabric dynamic-vlans
Syntax Description
vlan-id-or-range
VLAN ID or range. You can specify VLAN IDs from 1 to 4094. The VLAN range is 1-5, 10 or 2-5, and 7-19.
Command Default
No default range of VLAN IDs is specified.
Command Modes
Global configuration (config)
Command History
Release
Modification
7.0(0)N1(1)
This command was introduced.
Usage Guidelines
Use the system fabric dynamic-vlans command to specify the VLAN IDs or the complete range of core and server or host-facing VLANs for a device. You an use this command only after you have enabled the feature fabric forwarding command. We recommend specifying a contiguous range of VLAN IDs.
Note
There can be no existing VLANS in the range you specify by using the system fabric dynamic-vlans command.
Examples
The following example shows how to specify a VLAN ID or range of VLAN IDs for a device:
To configure a
FabricPath Operation, Administration, and Maintenance (OAM) service topology
identifier, use the
topology
command in FabricPath OAM profile configuration mode. To remove the service
topology, use the
no form of
this command.
topologytopology-id
notopology
Syntax Description
topology-id
Topology
identifier. The range is from 0 to 63.
Command Default
A FabricPath OAM
service topology identifier is not configured.
Sends a
loopback request to the specified switch ID.
interfaceinterface-id
(Optional) Name of the egress interface for FabricPath OAM traceroute.
vlanvlan-id
VLAN ID.
The range is from 1 to 4094.
tagtag-id
FabricPath OAM tag. The range is from 4096 to 0x00FFFFFF.
dot1qdot1q-idintf-id
Specifies the FabricPath OAM 802.1Q interface ID.
Note
The
Dot1q option is not available on Cisco Nexus 5000 series and 6000 series
switches; it is available only on the Cisco Nexus 7000 series.
use-host-vlan
(Optional) Specifies that only VLAN input should be used. Use
this keyword when enhanced forwarding is applied and you do not want to use the
translated VLAN. Use this option when you specify the ingress interface ID or
when you specify the flow entropy through the
profile
keyword or through forward flow with the IP address of customer traffic.
replymodeout-of-band
(Optional) Specifies that the FabricPath OAM reply mode is out
of band. By default, FabricPath OAM is replied in band (on the FabricPath
network). Use the
replymodeout-of-band keyword to change the mode of reply to
out of band for input IPv4 or IPv6 addresses. For routing, only the default VRF
is used.
ipv4ipv4-addr
(Optional) Specifies the input IPv4 address for out-of-band
reply.
ipv6ipv6-addr
(Optional) Specifies the input IPv6 address for out-of-band
reply.
forwardflowflow-entropy
(Optional) Specifies input flow entropy (128 bytes) from actual
user data traffic so that the FabricPath OAM packet takes the exact same path
as the user traffic.
l2
(Optional) Specifies that the input flow entropy must be
terminated until only Layer 2 entries are used. For example, MAC address, VLAN,
and e-type. We recommend that you use only one string option.
l3
(Optional) Specifies that the input flow entropy must be
terminated until only Layer 3 entries are used.
Note
Only IPv4 and IPv6 entries can be processed.
hophop-count
(Optional) Specifies the FabricPath OAM ping hop count. Range is
from 1 to 64. Default is 63.
topologytopology-id
(Optional) Specifies the topology ID. Range is from 0 to 63.
Default is 0.
verbose
(Optional) Displays additional information.
timeouttimeout-value
(Optional) Specifies the timeout values. Range is from 1 to
36000.
Command Modes
Privileged EXEC (#)
Command History
Release
Modification
7.0(0)N1(1)
This
command was introduced.
Usage Guidelines
For a
synchronous ping, traceroute, or mtrace, if the profile has multiple
interfaces, only the first interface is selected. Use the
interface
keyword to overwrite the selected interface. Only one session is created.
Examples
The following
example shows how to discover the route for FabricPath OAM packets.
Device# traceroute fabricpath switch-id 10
Sender handle: 3
Tracing fabricpath switch-id 10
Codes: '!' - success, 'Q' - request not sent, '.' - timeout,
'D' – Destination Unreachable, 'X' - unknown return code,
'V' – VLAN nonexistent, 'v' – VLAN in suspended state,
'm' - malformed request, 'C' – Cross Connect Error,
'U' – Unknown RBridge nickname, 'n' – Not AF,
'M' –MTU mismatch, 'I' – Interface not in forwarding state,
'S' – Service Tag nonexistent, 's' – Service Tag in suspended state,
Type escape sequence to abort.
0 5 Rcvd on Eth10/23, Next hop RBID – 10(fwd)[1ms]
! 10 [1ms]
The following example shows how to discover the route for FabricPath
OAM packets with for a specific switch ID when the keyword
verbose is included.
Device# traceroute fabricpath switch-id 3570 verbose
Codes: '!' - success, 'Q' - request not sent, '.' - timeout,
'D' - Destination Unreachable, 'X' - unknown return code,
'V' - VLAN nonexistent, 'v' - VLAN in suspended state,
'm' - malformed request, 'C' - Cross Connect Error,
'U' - Unknown RBridge nickname, 'n' - Not AF,
'*' - Success, Optional Tlv incomplete,
'I' - Interface not in forwarding state,
'S' - Service Tag nonexistent, 's' - Service Tag in suspended state,
'c' - Corrupted Data/Test
Sender handle: 1
Hop Code SwitchId Interface State TotalTime PathId DwnSwId Intf State
===============================================================================
1 ! 3570 Rcvd on Eth1/3 fwd 3ms
!!!!!specify customer flow entropy
The following example shows how to discover the route for FabricPath
OAM packets with for a specific switch ID for forward flow.
Device# traceroute fabricpath switch-id 3570 forward flow 00112222111100112222222281000000A8903
Codes: '!' - success, 'Q' - request not sent, '.' - timeout,
'D' - Destination Unreachable, 'X' - unknown return code,
'V' - VLAN nonexistent, 'v' - VLAN in suspended state,
'm' - malformed request, 'C' - Cross Connect Error,
'U' - Unknown RBridge nickname, 'n' - Not AF,
'*' - Success, Optional Tlv incomplete,
'I' - Interface not in forwarding state,
'S' - Service Tag nonexistent, 's' - Service Tag in suspended state,
'c' - Corrupted Data/Test
Sender handle: 2
Hop Code SwitchId Interface State TotalTime PathId
============================================================
1 ! 3570 Rcvd on Eth1/3 fwd 3ms
!!!!Interactive traceroute with user specified layer 2 flow entropy
The following example shows interactive traceroute with user specified
layer 2 flow entropy
Device# traceroute fabricpath
Switch-id(1-65535) [1] 3570
Timeout in seconds [2]
Extended command(y/n) [n] y
OAM Profile(1-1023) [none]
Interface [none]
Ingress Interface [none]
Forward Flow entropy [n] y
Forward Flow entropy type L2/L3 [L2]
Forward Flow source mac address(aaaa.bbbb.cccc) [0001.ccaa.aabb]
Forward Flow destination mac address(aaaa.bbbb.cccc) [0001.ccaa.3abb]
Forward Flow vlan(vlan id or none) [1] 10
Forward Flow stag(1-0xFFFFFF) [none]
Forward Flow ether type [0x9100]
Reverse Flow entropy [n]
Reply mode out of band [n]
Verbose [n]
Hop count(1-63) [63]
Topology id [0]
Use host vlan [n]
Vlan(vlan id or none) [1] 10
Control path forward request [n]
Control path reverse request [n]
Codes: '!' - success, 'Q' - request not sent, '.' - timeout,
'D' - Destination Unreachable, 'X' - unknown return code,
'V' - VLAN nonexistent, 'v' - VLAN in suspended state,
'm' - malformed request, 'C' - Cross Connect Error,
'U' - Unknown RBridge nickname, 'n' - Not AF,
'*' - Success, Optional Tlv incomplete,
'I' - Interface not in forwarding state,
'S' - Service Tag nonexistent, 's' - Service Tag in suspended state,
'c' - Corrupted Data/Test
Sender handle: 3
Hop Code SwitchId Interface State TotalTime PathId
============================================================
1 ! 3570 Rcvd on Eth1/3 fwd 3ms
To specify a
virtual routing and forwarding instance (VRF) name for a RADIUS, TACACS+, or
LDAP server group, use the
use-vrf
command in the appropriate command mode. To remove the
VRF name, use the
no form of
this command.
use-vrfvrf-name
nouse-vrfvrf-name
Syntax Description
vrf-name
VRF name.
The name is case sensitive.
Command Default
No VRF name is
specified.
Command Modes
RADlUS server group configuration (config-radius)
TACACS+ server group configuration (config-tacacs+)
LDAP server group configuration (config-ldap)
Command History
Release
Modification
—
This
command was introduced in an earlier Cisco NX-OS release.
Usage Guidelines
You can configure
only one VRF instance for a server group.
Use the
aaa group server
radius command to enter RADIUS server group configuration mode,
the
aaa group server
tacacs+ command to enter TACACS+ server group configuration mode,
or the
aaa group server
ldap command to enter LDAP server group configuration mode.
If the server is
not found, use the
radius-server
host command, the
tacacs-server
host command, or the
ldap-server
host command to configure the server.
Note
You must use
the
feature
tacacs+ command before you configure TACACS+ or the
feature ldap
command before you configure LDAP.
This command does
not require a license.
Examples
This example
shows how to specify a VRF name for a RADIUS server group:
Device# configure terminal
Device(config)# aaa group server radius RadServer
Device(config-radius)# use-vrf vrf1
This example shows
how to specify a VRF name for a TACACS+ server group:
Device(config)# feature tacacs+
Device(config)# aaa group server tacacs+ TacServer
Device(config-tacacs+)# use-vrf vrf2
This example shows
how to remove the VRF name from a TACACS+ server group:
Device(config)# feature tacacs+
Device(config)# aaa group server tacacs+ TacServer
Device(config-tacacs+)# no use-vrf vrf2
This example shows
how to specify a VRF name for an LDAP server group:
Device(config)# feature ldap
Device(config)# aaa group server ldap LdapServer
Device(config-ldap)# use-vrf vrf3
This example shows
how to remove the VRF name from an LDAP server group:
Device(config)# feature ldap
Device(config)# aaa group server ldap LdapServer
Device(config-ldap)# no use-vrf vrf3
Creates a RADIUS server group and enters RADIUS server group configuration mode.
user-jid
To configure
Jabber ID and password of the switch that is used to connect to the server, use
the
user-jid
command in fabric database server configuration mode. To remove the Jabber ID
and password, use the
no form of
this command.
user-jidjidpasswordpassword
nouser-jidjidpasswordpassword
Syntax Description
jid
Jabber ID
of the switch.
passwordpassword
Specifies
the password for the Jabber ID.
Command Default
The Jabber ID and
password are not configured.
Command Modes
Fabric database server configuration (config-fabric-db-server)
Command History
Release
Modification
7.0(0)N1(1)
This
command was introduced.
Usage Guidelines
Use the
user-jid
command to configure the Jabber ID and password for the switch that is used to
connect to the Extensible Messaging and Presence Protocol (XMPP) server. Use
this command with the
fabric database type
asset command to configure the external database using Extensible
Markup Language (XML) and XMPP.
Examples
The following
example shows how to configure a Jabber ID and password:
To create or specify a virtual
device context (VDC) for a switch and enter VDC configuration mode, use the
vdc switch command.
vdc switch [
id 1| type storage]
Syntax Description
id 1
(Optional) Forces the VDC into a
specific ID 1.
type storage
(Optional) Specifies a VDC for
storage.
Command Default
No VDC is specified.
Command Modes
Global configuration (config)
Command History
Release
Modification
7.0(0)N1(1)
This command was introduced.
Usage Guidelines
You can use the
vdc switch command only with the specific
Virtual Device Context (VDC) identifier value of 1. The VDC type storage
cannot be the default VDC, and it can be only one of the VDCs. You cannot have
two type storage VDCs on the device. When you create or specify a VDC, the
Cisco NX-OS software allocates the internal resources for the VDC. This process
can take a few minutes to complete depending on the amount of internal resource
you have requested for the VDC.
Examples
The following example shows how
to specify a Virtual Device Context (VDC) for a switch:
To configure the
FabricPath Operation, Maintenance, and Administration (OAM) VLAN, use the
vlan command
in FabricPath OAM profile configuration mode. To remove the VLAN configuration,
use the
no form of
this command.
To create a new
VLAN access-map entry or to configure an existing VLAN access-map entry on a
device, use the
vlan
access-map command in global configuration mode. To remove a VLAN
access-map entry, use the
no form of
this command.
vlan access-mapmap-name
novlan
access-mapmap-name
Syntax Description
map-name
Name of
the VLAN access map that you want to create or configure. The map-name argument
can be up to 64 alphanumeric, case-sensitive characters.
Command Default
A VLAN access-map
is not configured.
Command Modes
Global configuration (config)
Command History
Release
Modification
—
This
command was introduced in a release earlier than Cisco NX-OS Release 7.0(0)N1(1).
7.0(0)N1(1)
This
command was modified. The
sequence-number argument was removed.
Usage Guidelines
Each VLAN
access-map entry can include one
action
command and one or more
match
commands. Use the
statistics
per-entry command to configure the device to record statistics
for a VLAN access-map entry.
Use the
vlan
access-map command to enter the access-map configuration mode
(config-access-map) to enable receiving of packets on any port on the switch.
PowerOn Auto Provisioning (POAP) uses access control 3ists (ACL) to selectively
receive packets. All line cards supported by N7K support Layer 2 ports.
Therefore, for the purpose of PoAP, all ports are configured as Layer 2 ports.
To simplify configuration of ACLs, a common VLAN is allowed on all the ports
and the VLAN ACL (VACL) configured on this common VLAN.
The VACL is
configured in two phases. Initially, the VACL will be configured to permit just
the DHCP requests and responses and redirect these to the supervisor. All other
packets will be dropped. The permit rules match DHCP requests and responses.
They make use of the fact that DHCP uses UDP and fixed L4 port numbers for the
server (67) and client (68). Once the PoAP process receives the appropriate
DHCP packets and an IP address is assigned to the switch, the VACL will be
modified to permit all packets destined to the newly assigned IP address.
This command does
not require a license.
Examples
The following
example shows how to enable and configure a VLAN access-map entry:
Device> enable
Device# configure terminal
Device(config)# ip access-list testacl
Device(config-acl)# 20 permit udp any any eq 67
Device(config-acl)# 30 permit udp any any eq 68
Device(config-acl)# 40 permit udp any eq 67 any
Device(config-acl)# 50 permit udp any eq 68 any
Device(config-acl)# 60 deny ip any any
Device(config-acl)# exit
Device(config)# vlan access-map poapvacl
Device(config-access-map)# match ip address testacl
Device(config-access-map)# end
To apply a VLAN
access map to one or more VLANs, use the
vlan filter
command in global configuration mode. To unapply a VLAN access map, use the
no form of
this command.
vlan filtermap-namevlan-listvlan-list
no
vlan filtermap-namevlan-listvlan-list
Syntax Description
map-name
Name of
the VLAN access map that you want to create or configure.
vlan-listvlan-list
Specifies
the ID of one or more VLANs that the VLAN access map filters. Valid VLAN IDs
are from 1 to 3967.
Use a
hyphen (-) to separate the beginning and ending IDs of a range of VLAN IDs; for
example, use 70-100. Use a comma (,) to separate individual VLAN IDs and ranges
of VLAN IDs; for example, use 20,70-100,142.
Note
When you use the
no form of this command, the VLAN-list argument is optional. If you omit this
argument, the device removes the access map from all VLANs where
the access map is applied.
Command Default
None
Command Modes
Global configuration (config)
Command History
Release
Modification
—
This
command was introduced in a release earlier than Cisco NX-OS Release 7.0(0)N1(1).
Usage Guidelines
You can apply a
VLAN access map to one or more VLANs. You can apply only one VLAN access map to
a VLAN.
The
no form of
this command enables you to unapply a VLAN access map from all or part of the
VLAN list that you specified when you applied the access map. To unapply an
access map from all VLANs where it is applied, you can omit the vlan-list
argument. To unapply an access map from a subset of the VLANs where it is
currently applied, use the vlan-list argument to specify the VLANs where the
access map should be removed.
This command does
not require a license.
Examples
The following
example shows how to specify access control for packets on a VLAN access
control list (VACL):
Device> enable
Device# configure terminal
Device(config)# ip access-list testacl
Device(config-acl)# 20 permit udp any any eq 67
Device(config-acl)# 30 permit udp any any eq 68
Device(config-acl)# 40 permit udp any eq 67 any
Device(config-acl)# 50 permit udp any eq 68 any
Device(config-acl)# 60 deny ip any any
Device(config-acl)# exit
Device(config)# vlan access-map poapvacl
Device(config-access-map)# match ip address testacl
Device(config-access-map)# exit
Device(config)# vlan filter poapvacl vlan-list 1
Device(config)# end
Creates and configures VLAN access-map entry on a device.
vn-segment
To configure the
virtual network (VN) segment ID of the virtual LAN (VLAN), use the
vn-segment
command in VLAN configuration mode. To remove a configured VN segment ID, use
the
no form of
this command.
vn-segmentsegment-id
novn-segment
Syntax Description
segment-id
Configures
the VN segment identifier of the VLAN. The range is from 4096 to 16773119.
Command Default
The virtual network
segment identifier is not configured.
Command Modes
VLAN configuration (config-vlan)
Command History
Release
Modification
7.0(0)N1(1)
This
command was introduced.
Usage Guidelines
You must enable
feature-set fabricpath and VLAN-based VN segment features on the device before
configuring the VN segment ID.
Examples
This example shows
how to configure the VN segment ID of the VLAN on a device:
To configure the
virtual network identifier (VNI), use the
vni command
in global configuration or VRF configuration mode. To remove the VNI, use the
no form of
this command.
vni
[ vni-id
| [ -vni-id ] ]
novni
[ vni-id
| [ -vni-id ] ]
Syntax Description
vni-id
(Optional) Configures
the unique identifier. The range is from 4096 to 16773119.
-
vni-id
(Optional) Configures
the unique identifier range. The range is from 4096 to 16773119.
Note
You
can specify a single ID or a range. For example, 4099, 5000-5005.
Command Default
Virtual network
identifier is not configured.
Command Modes
For spine devices—Global configuration (config)
For leaf devices—VRF configuration (config-vrf)
Command History
Release
Modification
7.0(0)N1(1)
This
command was introduced.
Examples
This example shows
how to configure VNI on a spine device:
Device(config)# vni 4099
This example shows how to configure VNI on a leaf device: