Cisco SD-WAN Plugin Deployment and Configuration Guide
This document describes the steps to deploy and configure the Cisco SD-WAN Plugin.
To provision a single Cisco SD-WAN integration device, ensure that both the SD-WAN and SNMP plugins are enabled, then proceed to save the configuration. Please refer to the Installation steps below for more details.
Prerequisites
- Cisco SDWAN integration in SevOne NMS supports standard basic authentication using the vManage URL, username, and password.
- SNMP v2 or SNMP v3 details for the edge devices, based on device compatibility.
Device Onboarding
When onboarding Cisco SDWAN devices in SevOne NMS, you only need to add a single SD-WAN integration device (the Cisco SDWAN Orchestrator) with the appropriate orchestrator credentials. Once the integration device is added and saved, SevOne NMS automatically discovers all edge devices managed by that integration. There is no need to manually add each edge device.
If the edge devices already exist in SevOne NMS with SNMP-only monitoring and valid IP addresses, adding the SD-WAN integration device with both SNMP and SD-WAN plugins will automatically associate the integration with the existing devices. The SD-WAN metadata will then populate alongside the existing SNMP data, without creating duplicates.
To onboard a Cisco SD-WAN device in SevOne NMS, execute the following steps.
- Using a web browser, navigate to the SevOne NMS appliance URL, log in with your credentials, then go to the Devices menu via the navigation bar, select Device Manager, and click Add Device to create a new device.
- On the New Device page, add the following details.
- In the Name field, enter the device name.
- Leave the IP Address field blank.
- By default, the plugin is set to SNMP.
- Refer to the image and follow the instructions.
- Ensure that the field SNMP Capable check box is selected to enable the discovery of SNMP object types and to poll SNMP data on the device.
- The plugin uses the SNMP credentials you provide to begin discovery and identify all SD-WAN edge devices connected to vManage.
- Verify that the SNMP Capable checkbox is selected.
- Enter the SNMP credentials that are configured on each edge device.
- Enter the Username and Password for the Cisco SD-WAN device.
Note: Ensure the same SNMP credentials are configured on all Cisco SD-WAN devices.
- Select other options and click Save to save the current changes as a New Device.
- Refer to the image and follow the instructions.
-
- Now, from the drip down list , select SDWAN and ensure that Enable SDWAN API Integration check box is selected.
- Click the Vendor drop-down and select the Cisco SD-WAN option.
- In the vManage URL field, enter the URL for the SDWAN vendor, Cisco SD-WAN.
- In the Username field, enter the username for the SDWAN vendor, Cisco SD-WAN.
- In the Password field, enter the password for the SDWAN vendor, Cisco SD-WAN.
- Enable field Auto-discover and monitor associated Edge Devices - Use SNMP Plugin to automatically discover and monitor Cisco SD-WAN devices and click on Save.
- Now, from the drip down list , select SDWAN and ensure that Enable SDWAN API Integration check box is selected.
- Once the SDWAN plugin settings are configured, click the Devices menu and select Discovery Manager.
- After the discovery process is completed, Cisco SD-WAN devices will be visible on the Device Manager screen.
The TopN Report Views are automatically imported and are listed as shown below. Manual importing is not required for these reports.
- Cisco SD-WAN TLOC - Jitter Metrics
- Cisco SD-WAN TLOC - Latency Metrics
- Cisco SD-WAN TLOC - Packet Loss Metrics
- IOS-XE Highest CPU Util - Max
- IOS-XE Highest Memory Util - Max
- IOS-XE IPSEC Tunnels - Bytes In Bytes Out
- IOS-XE SD-WAN BFD Sessions Flap
- IOS-XE SD-WAN BFD Sessions Up
- IOS-XE SD-WAN SLA AppRoute Jitter
- IOS-XE SD-WAN SLA AppRoute Latency
- IOS-XE SD-WAN SLA AppRoute Packet Loss
- IOS-XE SD-WAN TLOC BFD Sessions Flap
- IOS-XE QoS Queue Depth
- IOS-XE QoS Queue Discards
- IOS-XE QoS Class Dropped Bytes
- IOS-XE QoS Class In Bytes - Pre-policy Util
- IOS-XE QoS Class Out Bytes - Post-policy Util
- Viptela CPU Utilization
- Viptela Interface Drops
- Viptela Interface Errors
- Viptela Interface Utilization
- Viptela Top BFD Sessions
- Viptela Top Bytes Received/Transmitted
- Viptela Top Qos Queue Utilization
- Viptela Top Used Memory
- Viptela vSmart SLA Policy Packet Loss
SevOne-import --allow-overwrite --file <CiscoSDWAN_TopN_*.spk>Upgrade
For more information, please refer to SevOne NMS Upgrade Process Guide.
Cisco SD-WAN Flows in SevOne NMS
Flow Interface Manager
To check the flows received on SevOne NMS, from the navigation bar, click the Administration menu, select Flow Configuration, and then select Flow Interface Manager.
Deny 'Router-Generated' on Flow Rules
To configure additional parameters in the SD-WAN Flow Views options template, refer to SD-WAN Flow Views Additional Configuration Guide
Support Long Flows on SevOne NMS
Sometimes, the flows are dropped when Cisco SD-WAN devices send flows with a longer duration than what is configured. To allow long flows, from the navigation bar, click the Administration menu and select Cluster Manager and click on Cluster Settings tab, now select the FlowFalcon subtab, and uncheck Drop Long Flows field.
Solution Verification & Customization
- Enter the URL for the SevOne NMS appliance into your web browser to display the Login page.
- Enter the credentials and click Login. For example, Username: admin and Password: SevOne
- To check MIB files imported, click the Administration menu, select Monitoring Configuration, and then select MIB Manager.
Please refer to MIB Manager page for details..
- To check device groups imported, click the Devices menu and select Grouping, then Device Groups. Please refer to Device Groups for details.
- To check device types imported, click the Administration menu and select Monitoring Configuration, then Device Types. Please refer to Device Types for details.
- To check Object Types, click on the Administration menu and select Monitoring Configuration, then Object Types. Please refer to Object Types for details.
-
Cisco SD-WAN TLOC object type indicators enables users to visualize and track indicators in SevOne NMS and to view the TLOC indicators, click the Devices menu and select Object Manager.
- In the Filter Options pop-up window, navigate to the Object Type filter and select SDWAN from the dropdown list and then choose TLOC as shown below.
Alternatively, users can also view TLOC object types by navigating to the Administration menu, selecting Monitoring Configuration, and then choosing Object Types. Filter by SD-WAN, select the TLOC Object type, and view its associated Jitter, Latency, and Packet Loss indicators.
Please refer to Object Types for details.
Example
- In the Filter Options pop-up window, navigate to the Object Type filter and select SDWAN from the dropdown list and then choose TLOC as shown below.
Cisco SD-WAN OOTB Reports in SevOne Data Insight
- Log in to SevOne Data Insight using your web browser and valid credentials
- Select Devices to open the Device Manager page, then choose the required datasource from the Datasource drop-down list.
Example
- Select Reports, expand SevOne Folders, then SD-WAN → Cisco, and choose Cisco SD-WAN Dashboard.
Alternatively, select Cisco SD-WAN Dashboard and click Run.
- Review all dashboard tabs, including Underlay, TLOC, Flow, and others.
Cisco SD-WAN TLOC Reports on SevOne Data Insight
- Select Reports, under SevOne Folders, click on the SD-WAN drop-down list, and select Cisco folder and click on Cisco SD-WAN TLOC Summary.
- In Cisco SD-WAN TLOC Summary page, select TLOC Object from the TLOC drop-down list to display the corresponding jitter, latency, and packet loss metrics.
Example
- Alternatively, you can click on the Cisco SD-WAN Dashboard, select Underlay menu, and choose the desired device under Device Name to view the corresponding jitter, latency, and packet loss metrics.
To learn more about the data flow process of the TLOC agent, see Cisco SD-WAN Agent (TLocAgent).