Cisco Nexus Cloud Services Platform Troubleshooting Guide, Release
5.2(1)SP1(7.1)
First Published: June 11, 2014
Americas Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: 408 526-4000
800 553-NETS (6387)
Fax: 408 527-0883
Text Part Number: OL-31545-01
© 2010-2014
Cisco Systems, Inc. All rights reserved.
CONTENTS
Preface
Preface v
Audience v
Document Conventions v
Related Documentation for Cisco Nexus Cloud Services Platform vii
Documentation Feedback viii
Obtaining Documentation and Submitting a Service Request viii
CHAPTER 1
Overview 1
Information about Cisco Nexus Cloud Services Platform 1
Overview of the Troubleshooting Process 1
Overview of Best Practices 2
Troubleshooting with Logs 2
Accessing External USB/CD to View Troubleshooting Logs 2
Cisco Support Communities 3
Contacting Cisco Customer Support 3
CHAPTER 2
Troubleshooting Cisco Nexus Cloud Services Platform 5
Problems with Cisco Nexus Cloud Services Platform 5
Cisco Nexus Cloud Services Platform Troubleshooting Commands 8
Cisco Nexus Cloud Services Platform Troubleshooting Guide, Release 5.2(1)SP1(7.1)
OL-31545-01
iii
Contents
Cisco Nexus Cloud Services Platform Troubleshooting Guide, Release 5.2(1)SP1(7.1)
iv
OL-31545-01
Preface
This preface contains the following sections:
• Audience, page v
• Document Conventions, page v
• Related Documentation for Cisco Nexus Cloud Services Platform, page vii
• Documentation Feedback, page viii
• Obtaining Documentation and Submitting a Service Request, page viii
Audience
This publication is for network administrators who configure and maintain Cisco Nexus devices.
This guide is for network and server administrators with the following experience and knowledge:
• An understanding of virtualization
• Using hypervisor host machine software to create a virtual machine and configure a virtual switch.
Document Conventions
Command descriptions use the following conventions:
Convention
Description
bold
Bold text indicates the commands and keywords that you enter literally
as shown.
Italic
Italic text indicates arguments for which the user supplies the values.
[x]
Square brackets enclose an optional element (keyword or argument).
[x | y]
Square brackets enclosing keywords or arguments separated by a vertical
bar indicate an optional choice.
Cisco Nexus Cloud Services Platform Troubleshooting Guide, Release 5.2(1)SP1(7.1)
OL-31545-01
v
Preface
Document Conventions
Convention
Description
{x | y}
Braces enclosing keywords or arguments separated by a vertical bar
indicate a required choice.
[x {y | z}]
Nested set of square brackets or braces indicate optional or required
choices within optional or required elements. Braces and a vertical bar
within square brackets indicate a required choice within an optional
element.
variable
Indicates a variable for which you supply values, in context where italics
cannot be used.
string
A nonquoted set of characters. Do not use quotation marks around the
string or the string will include the quotation marks.
Examples use the following conventions:
Convention
Description
screen font
Terminal sessions and information the switch displays are in screen font.
boldface screen font
Information you must enter is in boldface screen font.
italic screen font
Arguments for which you supply values are in italic screen font.
<>
Nonprinting characters, such as passwords, are in angle brackets.
[]
Default responses to system prompts are in square brackets.
!, #
An exclamation point (!) or a pound sign (#) at the beginning of a line
of code indicates a comment line.
This document uses the following conventions:
Note
Caution
Means reader take note. Notes contain helpful suggestions or references to material not covered in the
manual.
Means reader be careful. In this situation, you might do something that could result in equipment damage
or loss of data.
Cisco Nexus Cloud Services Platform Troubleshooting Guide, Release 5.2(1)SP1(7.1)
vi
OL-31545-01
Preface
Related Documentation for Cisco Nexus Cloud Services Platform
Related Documentation for Cisco Nexus Cloud Services Platform
This section lists the documents used with the Cisco Nexus Cloud Services Platform and available on Cisco.com
at the following URL:
http://www.cisco.com/en/US/products/ps12752/tsd_products_support_series_home.html
General Information
Cisco Nexus Cloud Services Platform Release Notes
Install and Upgrade
Cisco Nexus Cloud Services Platform Hardware Installation Guide
Cisco Nexus Cloud Services Platform Software Installation and Upgrade Guide
Regulatory Compliance and Safety Information for the Cisco Nexus Cloud Services Platform
Configuration Guide
Cisco Nexus Cloud Services Platform Software Configuration Guide
Reference Guides
Cisco Nexus Cloud Services Platform Command Reference
Cisco Nexus Cloud Services Platform Compatibility Information
Troubleshooting and Alerts
Cisco Nexus Cloud Services Platform Troubleshooting Guide
Nexus 1000V Documentation
For the Cisco Nexus 1000V for VMware vSphere Documentation:
http://www.cisco.com/en/US/products/ps9902/tsd_products_support_series_home.html
For the Cisco Nexus 1000V for Microsoft Hyper-V Documentation:
http://www.cisco.com/en/US/products/ps13056/tsd_products_support_series_home.html
Virtual Security Gateway Documentation
Cisco Virtual Security Gateway Documentation
Virtual Network Management Center Documentation
Virtual Network Management Center
Virtual Wide Area Application Services (vWAAS) Documentation
Virtual Wide Area Application Services (vWAAS)
Cisco Nexus Cloud Services Platform Troubleshooting Guide, Release 5.2(1)SP1(7.1)
OL-31545-01
vii
Preface
Documentation Feedback
ASA 1000V Cloud Firewall Documentation
Cisco ASA 1000V Cloud Firewall
Network Analysis Module Documentation
Network Analysis Module
Documentation Feedback
To provide technical feedback on this document, or to report an error or omission, please send your comments
to:
• [email protected]
We appreciate your feedback.
Obtaining Documentation and Submitting a Service Request
For information on obtaining documentation, using the Cisco Bug Search Tool (BST), submitting a service
request, and gathering additional information, see What's New in Cisco Product Documentation, at: http://
www.cisco.com/c/en/us/td/docs/general/whatsnew/whatsnew.html.
Subscribe to What's New in Cisco Product Documentation, which lists all new and revised Cisco technical
documentation, as an RSS feed and deliver content directly to your desktop using a reader application. The
RSS feeds are a free service.
Cisco Nexus Cloud Services Platform Troubleshooting Guide, Release 5.2(1)SP1(7.1)
viii
OL-31545-01
CHAPTER
1
Overview
This chapter contains the following sections:
• Information about Cisco Nexus Cloud Services Platform, page 1
• Overview of the Troubleshooting Process, page 1
• Overview of Best Practices, page 2
• Troubleshooting with Logs, page 2
• Accessing External USB/CD to View Troubleshooting Logs, page 2
• Cisco Support Communities, page 3
• Contacting Cisco Customer Support, page 3
Information about Cisco Nexus Cloud Services Platform
For detailed information about the overview of the Cisco Nexus Cloud Services Platform product family and
how to install and upgrade Cisco Nexus Cloud Services Platform, see the Cisco Nexus Cloud Services Platform
Software Installation and Upgrade Guide.
For detailed information about how to configure the Cisco Nexus Cloud Services Platform product family,
see the Cisco Nexus Cloud Services Platform Software Configuration Guide.
Overview of the Troubleshooting Process
Follow the steps below to troubleshoot your network:
1 Gather information that defines the specific symptoms.
2 Identify all potential problems that could be causing the symptoms.
3 Systematically eliminate each potential problem (from most likely to least likely) until the symptoms
disappear.
Cisco Nexus Cloud Services Platform Troubleshooting Guide, Release 5.2(1)SP1(7.1)
OL-31545-01
1
Overview
Overview of Best Practices
Overview of Best Practices
Best practices are the recommended steps you should take to ensure the proper operation of your network.
We recommend the following general best practices for most networks.
• Maintain a consistent Cisco Nexus Cloud Services Platform release across all network devices.
• Refer to the release notes for your Cisco Nexus Cloud Services Platform release for the latest features,
limitations, and caveats.
• Enable system message logging.
• Verify and troubleshoot any new configuration changes after implementing the change.
Troubleshooting with Logs
Cisco Nexus Cloud Services Platform generates many types of system messages on the switch and sends them
to a syslog server. These messages can be viewed to determine what events may have led up to the current
problem condition you are facing.
Use the following commands to access and view logs in the Cisco Nexus Cloud Services Platform.
• To view logs, enter the show logging command.
• To view Cisco Nexus Cloud Services Platforminformation, enter the show tech-support nexus1010
command.
• To access agent logs, sos report, and other logs, enter the vsa-system get agent logs command.
• To access redundancy logs, enter the following commands:
• show system internal redundancy trace
• show system redundancy status
Accessing External USB/CD to View Troubleshooting Logs
In the event of any failure on the Cisco Nexus Cloud Services Platform or loss in network connectivity, you
can access an external USB or CD to copy the logs for troubleshooting.
You can use the following procedure to copy the logs.
SUMMARY STEPS
1. Enable the auxillary feature using the following command:
2. Access an external USB or CD. The physical parameter represents a physical USB or CD drive. The virtual
parameter represents a virtual drive that is mapped through the KVM console on the CIMC.
3. Copy the logs to the repository.
Cisco Nexus Cloud Services Platform Troubleshooting Guide, Release 5.2(1)SP1(7.1)
2
OL-31545-01
Overview
Cisco Support Communities
DETAILED STEPS
Step 1
Enable the auxillary feature using the following command:
switch # configure terminal switch # [no] feature auxillary [cdrom|usb]
Step 2
Access an external USB or CD. The physical parameter represents a physical USB or CD drive. The virtual parameter
represents a virtual drive that is mapped through the KVM console on the CIMC.
switch[no] mount [physical |virtual]
Step 3
Copy the logs to the repository.
switch# copy bootflash:usb|v-usb|cdrom|v-cdrom| bootflash:repository
Cisco Support Communities
For additional information, visit one of the following support communities.
• Cisco Support Community for Server Networking
• Cisco Communities: Nexus 1000V
Contacting Cisco Customer Support
If you are unable to solve a problem after using the troubleshooting suggestions in this guide, contact a
customer service representative for assistance and further instructions. Before you call, have the following
information ready to help your service provider assist you as quickly as possible.
• Version of the Cisco Nexus Cloud Services Platform software that you are running
• Contact phone number
• Brief description of the problem
• Brief explanation of the steps you have already taken to isolate and resolve the problem
After you have collected this information, see the Obtaining Documentation and Submitting a Service Request
section.
Cisco Nexus Cloud Services Platform Troubleshooting Guide, Release 5.2(1)SP1(7.1)
OL-31545-01
3
Overview
Contacting Cisco Customer Support
Cisco Nexus Cloud Services Platform Troubleshooting Guide, Release 5.2(1)SP1(7.1)
4
OL-31545-01
CHAPTER
2
Troubleshooting Cisco Nexus Cloud Services
Platform
This chapter contains the following sections:
• Problems with Cisco Nexus Cloud Services Platform, page 5
• Cisco Nexus Cloud Services Platform Troubleshooting Commands, page 8
Problems with Cisco Nexus Cloud Services Platform
This section includes symptoms, possible causes and solutions for the following problems with Cisco Nexus
Cloud Services Platform product family.
Symptom
Possible Causes
Verification and Solution
When 10G interface or SSL card
is not detected then the show
hardware and show version
commands display the port and
card slot values as '0'.
When a Cisco Nexus 1110-X is
asymmetrically paired with a
different model such as Cisco
Nexus1010, Cisco Nexus1010-X,
then the 10G interface or SSL
interface is not enabled. It is
required, that both the Cisco Nexus
Cloud Services Platform systems
must be of Cisco Nexus 1110-X
model.
The output of show hardware
command will show the model
number and hardware version
which confirms they are of same
product type. Also, you can verify
using the following commands.
Number of physical 10 Gbps
ethernet ports: 0 Number of
SSL accelerator card: 0
1 show network summary
2 show running-config
The Cisco Nexus Cloud Services Once the installation is complete, No command is present to verify
Platform will take an extra reboot there will be an extra reboot after this.
after installation.
observing a message 'iommu not
set'. The iommu parameter is
required to enable the SSL offload
feature.
Cisco Nexus Cloud Services Platform Troubleshooting Guide, Release 5.2(1)SP1(7.1)
OL-31545-01
5
Troubleshooting Cisco Nexus Cloud Services Platform
Problems with Cisco Nexus Cloud Services Platform
Symptom
Possible Causes
Verification and Solution
Interface card or port-channels
goes down.
This may occur if the CSP pair is in Verify the port-channels or
Active-Active mode after fresh
interface state.
installation.
1 show network summary
2 show network port-channel
summary
The output of the show system
redundancy status command,
displays the standby Cisco Nexus
Cloud Services Platform in warm
standby state.
This may occur when there is no
control traffic communication
between the Cisco Nexus Cloud
Services Platform HA pair.
1 Verify if the control VLAN
configuration of both primary
and secondaryCisco Nexus
Cloud Services Platform.
show svs domain
2 Verify if the upstream switch
for both primary and secondary
Cisco Nexus Cloud Services
Platform is configured by
allowing the control VLAN in
the list of VLAN permitted in
the upstream trunk port.
interface name
switchport trunk allowed vlan
addid
3 Verify the status of the ports.
show network uplink
4 Verify the network cdp of
active and standby Cisco Nexus
Cloud Services Platform. show
network cdp-neighbors
The output of the show
This may occur after the reload or
virtual-service-blade summary upgrade of Cisco Nexus Cloud
command displays the status of Services Platform.
the VSB on the active Cisco
Nexus Cloud Services Platform as
power in progress and the status
of the VSB on the standby Cisco
Nexus Cloud Services Platform as
powered on.
1 Manually sync the state of the
VSB on the Cisco Nexus Cloud
Services Platform. Enter the
command in the virtual service
blade configuration
mode.description " "
2 Verify the status of the VSB
show virtual-service-blade
summary
Cisco Nexus Cloud Services Platform Troubleshooting Guide, Release 5.2(1)SP1(7.1)
6
OL-31545-01
Troubleshooting Cisco Nexus Cloud Services Platform
Problems with Cisco Nexus Cloud Services Platform
Symptom
Possible Causes
Verification and Solution
Removal of a VSB fails and the Multiple operations were carried out
1 Manually remove the VSB
following error message is logged: on the VSB before it was removed.
using the following
"Previous command in
command:no enable force
progress".
2 Verify the removal of the
VSB.show
virtual-service-blade
summary
Remove of VSB results in the
following error message:
Multiple operations were carried out Manually remove the VSB by
on the VSB before it was removed. using the following command:
"Another action on VSB:VPX
1 no enable force
is currently being processed.
2 Verify the removal of VSB
using
show virtual-service-blade
summary.
There can be only one
outstanding action. Pleae
wait till that is completed
before inititaing a new
action. Use 'show
virtual-service-blade
summary' comman to check if
that operation is complete
and try again later!"
Removal of port channel fails with The port channel is in use by Cisco Verify if the port channel is in use
the following error message:
Nexus Cloud Services Platform.
in the Cisco Nexus Cloud Services
Platform.
Interface (Ethernet1) pc in
use by rt mgr while trying
Show network summary
to remove a Gig member from
Show network port-channel
summary
a port channel.
VSB is not created on the
secondary Cisco Nexus Cloud
Services Platform even if the
Cisco Nexus Cloud Services
Platform is in sync and in HA
mode.
An error occurred during the
automatic creation of the VSB on
the secondary Cisco Nexus Cloud
Services Platform.
Manually create the VSB on the
secondary Cisco Nexus Cloud
Services Platform.
After rebooting the Cisco Nexus
Cloud Services Platforms, the
configured VSBs do not appear.
Cisco Nexus Cloud Services
Platform configuration may not
have been saved after creating the
VSBs.
Contact a customer service
representative for assistance to
recover pointers to the VSBs.
See the Cisco Nexus Cloud Services
Platform Software Configuration
Guide for creating VSBs.
Note
Do not attempt to modify
the Cisco Nexus Cloud
Services Platform
configuration or reload the
VSB.
Cisco Nexus Cloud Services Platform Troubleshooting Guide, Release 5.2(1)SP1(7.1)
OL-31545-01
7
Troubleshooting Cisco Nexus Cloud Services Platform
Cisco Nexus Cloud Services Platform Troubleshooting Commands
Cisco Nexus Cloud Services Platform Troubleshooting
Commands
You can use the commands in the following table to troubleshoot problems related to Cisco Nexus Cloud
Services Platform.
Commands
Description
show tech-support nexus1010
Displays switch information for Cisco TAC to assist
you in diagnosing issues.
show network
Displays information about the network.
show virtual-service-blade summary
Displays information about the virtual service blade.
show network cdp neighbors
Displays uplink connectivity for the active or standby
Cisco Nexus Cloud Services Platform
show interface
Displays information about interface configuration.
show network port-channel summary
Displays summary information of port channels in
the network.
show system redundancy status
Displays the redundancy state (active or standby) and
the redundancy role (primary or secondary) for the
Cisco Nexus Cloud Services Platforms.
show network cdp neighbors
Displays uplink connectivity for the active or standby
Cisco Nexus Cloud Services Platform.
show virtual-service-blade Name<name>
Displays only the specific VSB configuration.
show network summary
Displays a summary of all VSBs including the ones
configured in passthrough mode.
show nexus1010-mgr internal info
Display internal information
show nexus1010-mgr internal event-history msgs Displays both TX and RX (excluding frequent
heartbeat messages).
show nexus1010-mgr internal event-history all
Displays all event-history related to all FSMs.
show nexus1010-mgr internal event-history install Displays event-history related to Install FSM.
[last <count>]
show nexus1010-mgr internal event-history vsb
vbid <id> [last <count>]
Displays event-history related to specific virtual
service blade (VSB).
Cisco Nexus Cloud Services Platform Troubleshooting Guide, Release 5.2(1)SP1(7.1)
8
OL-31545-01
Troubleshooting Cisco Nexus Cloud Services Platform
Cisco Nexus Cloud Services Platform Troubleshooting Commands
For detailed information about show command output, see the Cisco Nexus Cloud Services Platform Command
Reference.
Cisco Nexus Cloud Services Platform Troubleshooting Guide, Release 5.2(1)SP1(7.1)
OL-31545-01
9
Troubleshooting Cisco Nexus Cloud Services Platform
Cisco Nexus Cloud Services Platform Troubleshooting Commands
Cisco Nexus Cloud Services Platform Troubleshooting Guide, Release 5.2(1)SP1(7.1)
10
OL-31545-01