Troubleshooting and Technical Support
You can monitor and control Snabb from within Junos OS running on the Juniper vMX.
To see extensive statistics for all Snabb instances seen in the lwAFTR state, JET must be running on the vMX and the loopback address must be configured.
- Append the following stanzas to your existing configuration:
[edit system extensions] lab@lwaftr1# save terminal system { replace: extensions { extension-service { application { file rpc-jet.py { daemonize; username root; } } } } } user@host# save terminal interfaces { lo0 { unit 0 { replace: family inet { address 127.0.0.1/24; } } } }
- With JET running, you can view extensive statistics for
all the Snabb instances shown from the lwAFTR state command by running
the following:
user@host# run show lwaftr statistics
Snabb Statistics Instance id: 0 IPv4 interface drop bytes: 0 IPv4 interface drop packets: 0 IPv6 interface drop bytes: 0 IPv6 interface drop packets: 0 ICMPv4 bad checksum bytes: 0 ICMPv4 bad checksum packets: 0 Instance id: 1 IPv4 interface drop bytes: 0 IPv4 interface drop packets: 0 IPv6 interface drop bytes: 0
The following commands are useful for troubleshooting:
Viewing the lwAFTR state—To see the lwAFTR state (which is fetched from the NIC used by the Snabb process), type the following:
user@host# run show lwaftr state
Snabb State Instance id: 0 Process ID of this instance: 434 Nexthop v4 mac address: 00:00:00:00:00:00 Nexthop v6 mac address: 00:00:00:00:00:00 Received packets that were dropped: 0 Received packets: 2645 Sent packets that were dropped: 0 Transmitted packets: 1145 Instance id: 1 Process ID of this instance: 454 Nexthop v4 mac address: 5c:45:27:15:a0:08 Nexthop v6 mac address: 00:00:00:00:00:00 Received packets that were dropped: 0 Received packets: 5128 Sent packets that were dropped: 0 Transmitted packets: 5118
Monitoring lwAFTR—To see packet statistics for IPv4 and IPv6, run the following command (include the
–no more
parameter to improve the look of the output):user@host> monitor lwaftr id 0 |no-more
Current Time: 2016-10-01 09:30:40.619816 Instance ID: 0 Total per second lwaftr_v6 in-ipv6-packets 29600631 1550414.90 lwaftr_v6 in-ipv6-bytes 11633411014 609454123.04 lwaftr_v6 out-ipv6-packets 29598949 1550461.41 lwaftr_v6 out-ipv6-bytes 11633421610 609453815.51 lwaftr_v6 drop-all-ipv6-iface-packets 0 0.00 lwaftr_v6 in-ipv6-frag-reassembled 0 0.00 lwaftr_v6 drop-ipv6-frag-invalid-reassembly 0 0.00 lwaftr_v6 out-ipv6-frag 0 0.00 lwaftr_v6 out-ipv6-frag-not 0 0.00 Total per second nic ifInDiscards 190260 0.00 Total per second lwaftr_v4 in-ipv4-packets 29601940 1550414.42 lwaftr_v4 in-ipv4-bytes 10448288170 546936145.10 lwaftr_v4 out-ipv4-packets 29603415 609454123.04 lwaftr_v4 out-ipv4-bytes 10449385774 1550461.41 lwaftr_v4 drop-all-ipv4-iface-packets 0 609453815.51 lwaftr_v4 in-ipv4-frag-reassembled 0 0.00 lwaftr_v4 drop-ipv4-frag-invalid-reassembly 0 0.00 lwaftr_v4 out-ipv4-frag 0 0.00 lwaftr_v4 out-ipv4-frag-not 0 0.00 ..
Collecting Information Before Contacting Technical Support
If you need to work with Juniper Technical Support, please collect the following files and include them in your request. From the vMX, do the following (using Junos OS CLI commands):
Save your current Junos OS configuration:
user@host> save actual.cfg
Gather relevant support files (including data from the vCP and vFP):
user@host> request support information | save rsi.log
Copy Junos OS log files from the following directory:
/var/log/message
Generate a
support-info
file that can be included in a request for help by running the following command from the/vmx-docker-lwaftr/tests
directory on the host:user@host:~$ sudo ./collect-support-infos.sh lwaftr5
Provide details about the Snabb version that is being used, from the git log, for example:
user@host:~/latest-snabb-binary/snabb$ git log
commit 373d6c0ba4b7255ab06da4f2e930da25e7ddcfe0 Merge: 885105a 5f74716 Author: user <user@users.noreply.github.com> Date: Tue Sep 27 12:49:52 2016 +0200 Merge pull request #459 from Igalia/refactor-lwutils lwutil refactorings
Requesting Technical Support
Technical product support is available through the Juniper Networks Technical Assistance Center (JTAC). If you are a customer with an active J-Care or JNASC support contract, or are covered under warranty, and need post-sales technical support, you can access our tools and resources online or open a case with JTAC.
JTAC policies—For a complete understanding of our JTAC procedures and policies, review the JTAC User Guide located at https://www.juniper.net/us/en/local/pdf/resource-guides/7100059-en.pdf.
Product warranties—For product warranty information, visit https://www.juniper.net/support/warranty/
JTAC hours of operation—The JTAC centers have resources available 24 hours a day, 7 days a week, 365 days a year.
Self-Help Online Tools and Resources
For quick and easy problem resolution, Juniper Networks has designed an online self-service portal called the Customer Support Center (CSC) that provides you with the following features:
Find CSC offerings: https://www.juniper.net/customers/support/
Search for known bugs: http://www2.juniper.net/kb/
Find product documentation: https://www.juniper.net/documentation/
Find solutions and answer questions using our Knowledge Base: https://kb.juniper.net/
Download the latest versions of software and review release notes: https://www.juniper.net/customers/csc/software/
Search technical bulletins for relevant hardware and software notifications: https://www.juniper.net/alerts/
Join and participate in the Juniper Networks Community Forum: https://www.juniper.net/company/communities/
Open a case online in the CSC Case Management tool: https://www.juniper.net/cm/
To verify service entitlement by product serial number, use our Serial Number Entitlement (SNE) Tool: https://tools.juniper.net/SerialNumberEntitlementSearch/.
Opening a Case with JTAC
You can open a case with JTAC on the Web or by telephone.
Use the Case Management tool in the CSC at https://www.juniper.net/cm/.
Call 1-888-314-JTAC (1-888-314-5822 toll-free in the USA, Canada, and Mexico).
For international or direct-dial options in countries without toll-free numbers, see https://www.juniper.net/support/requesting-support.html .
Revision History
December, 2016—Revision 1, Junos OS Release 16.1R3—vMX
Copyright © 2019 Juniper Networks, Inc. All rights reserved.
Juniper Networks, the Juniper Networks logo, Juniper, and Junos are registered trademarks of Juniper Networks, Inc. and/or its affiliates in the United States and other countries. All other trademarks may be property of their respective owners.
Juniper Networks assumes no responsibility for any inaccuracies in this document. Juniper Networks reserves the right to change, modify, transfer, or otherwise revise this publication without notice.