Cisco APIC-EM Network Path Visualization v1 Last Updated: 04-DEC-2015 About This Solution Cisco Application Policy Infrastructure Controller Enterprise Module (APIC-EM) is a software-defined networking (SDN) controller designed to orchestrate and manage local-area networks (LANs) and wide-area networks (WANs) composed of Cisco infrastructure. The APIC-EM solution is made up of four applications: Network PnP, IWAN, Path Trace, and Network Inventory. All of these applications can be exposed either from the GUI or a RESTful API. The APIC-EM Controller s Path Visualization application greatly eases and accelerates the task of connection troubleshooting by allowing you to verify the path a flow would take through the network. Path trace allows you to also check if an ACL would block the traffic through the network. This demonstration does not explore the APIC-EM API capabilities. For information on APIs, see the Cisco APIC-EM Network Python Sandbox v1.1. About This Demonstration This demonstration includes scenarios showing you how to use Cisco APIC-EM Path Visualization, including: Scenario 1: Cisco APIC Enterprise Module Overview Scenario 2: Cisco APIC Enterprise Module Path Trace Requirements This demonstration does not require an endpoint router. Table 1. Requirements Required Laptop Optional Cisco AnyConnect 2015 Cisco and/or its affiliates. All rights reserved. This document is Cisco Public Information. Page 1 of 20
Topology This content includes preconfigured users and components to illustrate the scripted scenarios and features of the solution. Most components are fully configurable with predefined administrative user accounts. You can see the IP address and user account credentials to use to access a component by clicking the component icon in the Topology menu of your active session and in the scenario steps that require their use. Figure 1. Topology 2015 Cisco and/or its affiliates. All rights reserved. This document is Cisco Public Information. Page 2 of 20
Get Started BEFORE PRESENTING We strongly recommend that you go through this document and work with an active session before presenting in front of a live audience. This will allow you to become familiar with the structure of the document and content. PREPARATION IS KEY TO A SUCCESSFUL PRESENTATION. Follow the steps to schedule a session of the content and configure your presentation environment. 1. Browse to dcloud.cisco.com, select the location closest to you, and log in with your Cisco.com credentials. 2. Register and configure your router if this is the first time you will use the router with dcloud. [Show Me How] 3. Schedule a session. [Show Me How] 4. Test your connection. [Show Me How] 5. Verify that the status of your session is Active in My Dashboard > My Sessions. NOTE: It may take up to 30 minutes for your session to become active. 6. Click View to open the active session. 1. Using your local, supported browser, connect to the Public IP address of APIC-EM using HTTPS and the username from the Session Details tab and password C1sco12345. Figure 1. Session Details 2015 Cisco and/or its affiliates. All rights reserved. This document is Cisco Public Information. Page 3 of 20
Scenario 1. Cisco APIC Enterprise Module Overview Steps 1. From the APIC-EM homepage, click on the arrow in the upper left and select Device Inventory from the menu. Figure 2. Device Inventory 2. This lists all the network devices, including switches, routers, wireless access points, wireless controllers. This screen displays summary information, including: Device Name Associated IP address Device Status Up Time Last Updated Time Last Inventory Collection Status Figure 3. Device Inventory 2015 Cisco and/or its affiliates. All rights reserved. This document is Cisco Public Information. Page 4 of 20
3. Click on CAMPUS-Core1 to display the device details. Figure 4. CAMPUS-Core1 4. Click X to close the window. 5. From the left menu, click Host Inventory. This displays the available end hosts, along with summary information, including: Host MAC Addess Host IP Address Host Type Connected Network Device IP Address Connected Interface Name Host Name Figure 5. Host Inventory 2015 Cisco and/or its affiliates. All rights reserved. This document is Cisco Public Information. Page 5 of 20
6. From the left hand menu, click Topology. Figure 6. Topology 7. In the topology, select CAMPUS-Core1 and drag down to the right. Point out how easy it is to adjust your topology using this screen. Figure 7. Drag CAMPUS-Core1 2015 Cisco and/or its affiliates. All rights reserved. This document is Cisco Public Information. Page 6 of 20
8. Click on CAMPUS-Core1 to open the details window. Figure 8. CAMPUS-Core1 Details 9. In the upper right, click the Save icon and name the topology. Click Save as New and confirm your save. Figure 9. Save as New 2015 Cisco and/or its affiliates. All rights reserved. This document is Cisco Public Information. Page 7 of 20
10. The new topology is listed on the screen. To toggle between the two topologies, simply click the Load Network Layout icon for the topology and confirm the load. Figure 10. Topologies 11. Point out that you can zoom in or out on the topology, either by using the track ball on your mouse, or by clicking the plus and minus signs on the screen. Figure 11. Zoom 2015 Cisco and/or its affiliates. All rights reserved. This document is Cisco Public Information. Page 8 of 20
Scenario 2. Cisco APIC Enterprise Module Path Trace Steps 1. From the APIC-EM homepage, click on the arrow in the upper left and select Path Trace. This displays the Path Trace window. Figure 12. Path Trace Window 2. In the SourceIP drop down, select the Wireless client. Figure 13. Wireless Client 2015 Cisco and/or its affiliates. All rights reserved. This document is Cisco Public Information. Page 9 of 20
3. In the DestinationIP drop down, select the Wired client. Figure 14. Wired Client 4. Click Trace. A dialogue box opens while the path is being traced. Figure 15. Finding Path 2015 Cisco and/or its affiliates. All rights reserved. This document is Cisco Public Information. Page 10 of 20
5. The Path Trace displays, illustrating that the device was switched to an AP, through a CAPWAP Tunnel, and other details. Figure 16. Path Trace 6. Click Show Reverse to show the return traffic. Figure 17. Show Reverse 2015 Cisco and/or its affiliates. All rights reserved. This document is Cisco Public Information. Page 11 of 20
7. Click on View Small (which toggles to View Large) to show a smaller version of the path trace. This is helpful if you have a large network and want to compare the devices. Figure 18. View Small 8. Click View in Topology in the upper right hand corner. Figure 19. View in Topology 2015 Cisco and/or its affiliates. All rights reserved. This document is Cisco Public Information. Page 12 of 20
9. A new tab opens up with a topology highlighting the path from the wired client to the wireless client. Figure 20. View Topology 2015 Cisco and/or its affiliates. All rights reserved. This document is Cisco Public Information. Page 13 of 20
10. Click the Save or Load Topology icon and click the Load My Topology icon to see the layout reflected in your custom topology. Figure 21. Save or Load Topology and Load My Topology 11. From the left menu, click Path Trace. Point out that you can also look at the path by Source Port and Destination Port. NOTE: If an ACL was blocking traffic, it would show here. Figure 22. Source Port and Destination Port 2015 Cisco and/or its affiliates. All rights reserved. This document is Cisco Public Information. Page 14 of 20
12. Click to open a new tab and browse to https://198.18.129.100/swagger. 13. This displays the available APIs. Figure 23. Available APIs 14. Click Flow Analysis > Show/Hide > Post. Figure 24. Flow Analysis > Show/Hide > Post 2015 Cisco and/or its affiliates. All rights reserved. This document is Cisco Public Information. Page 15 of 20
15. In the pathrequest value, enter the following. Click Try it out! { "sourceip": "65.1.1.83", "destip": "212.1.10.20" } Figure 25. pathrequest Value 16. Scroll down to locate and copy the resulting task ID. NOTE: Only copy the ID. Do not copy the quotation marks. Figure 26. Task ID 2015 Cisco and/or its affiliates. All rights reserved. This document is Cisco Public Information. Page 16 of 20
17. Click Task > Show/Hide > Get. Figure 27. Task > Show/Hide > Get 18. Paste the Task ID into the taskid Value. Click Try it out! Figure 28. taskid Value 2015 Cisco and/or its affiliates. All rights reserved. This document is Cisco Public Information. Page 17 of 20
19. Scroll down to locate and copy the resulting Progress ID. NOTE: Only copy the ID. Do not copy the quotation marks. Figure 29. Progress ID 20. Click Flow Analysis > Show/Hide > GET. Figure 30. Flow Analysis > Show/Hide > GET 2015 Cisco and/or its affiliates. All rights reserved. This document is Cisco Public Information. Page 18 of 20
21. Paste the Progress ID into the pathid Value. Click Try it out! Figure 31. pathid Value 22. Scroll down into the Response Body and point out the path trace information from the API. Figure 32. Response Body 2015 Cisco and/or its affiliates. All rights reserved. This document is Cisco Public Information. Page 19 of 20
2015 Cisco and/or its affiliates. All rights reserved. This document is Cisco Public Information. Page 20 of 20