Integrating Cisco Catalyst SD-WAN Manager with CX Cloud
This document refers to the Cisco Catalyst SD-WAN Manage, previously vManage.
Prerequisites for Data Collection for SD-WAN Telemetry in CX Cloud
The following conditions must be met to ensure a successful integration between SD-WAN Manager and CX Cloud:
- Confirm that SD-WAN Manager software is v20.6 or later
- SD-WAN Manager is associated with Cisco Smart Accounts and a unique Organization Name has been allocated
- The user adding the data source must be both an Administrator on the Smart Account and/or Virtual Account associated with the SD-WAN Manager organization and a CX Cloud Super Administrator or Administrator
- Data Collection is enabled on the Cisco Catalyst SD-WAN Manager
Enabling Cloud Services and Data Collection
Cisco-Provided Cloud-Hosted Service
Cloud services are enabled by default. No further action is required.
On-Premises Service
Cloud services are disabled by default and must be enabled prior to enabling data collection for Cisco Catalyst SD-WAN telemetry.
To enable Cloud Services:
- Select Administration > Settings from the Cisco SD-WAN Manager menu.
- Click Edit.
- Click Enabled.
- Enter the One Time Password (OTP). Generate an OTP token using the self-service portal or request one from the Cisco CloudOps Team by opening a Cisco Technical Assistance Center (TAC) support case.
- Leave the Cloud Gateway URL blank.
- Approve permission to begin data collection and upload data to the cloud.
- Click Save.
Note: In some cases, newer versions of the Cisco Catalyst SD-WAN Manager require only Smart Account login credentials and do not require an OTP token.
Enabling or Disabling Data Collection for SD-WAN Telemetry
To enable or disable Data Collection for SD-WAN telemetry:
- Select Administration > Settings from the Cisco SD-WAN Manager menu.
- Click Edit for the Data Collection option.
- Enabled is selected by default for the SD-WAN Telemetry Data Collection. To disable data collection for the Cisco Catalyst SD-WAN telemetry, click Disabled. Disabling stops the telemetry from flowing to CX Cloud.
- Click Save.
Integrating SD-WAN Manager with CX Cloud
To integrate SD-WAN Manager with CX Cloud:
- Log in to the CX Cloud portal with Administrator or Super Administrator permissions.
- Click the Settings icon.
- Click Add a Data Source.
- Click Connect on the appropriate line to select Cisco Catalyst SD-WAN Manager.
- Select the SD-WAN Manager Organization for integration and click Connect to add the selected account.
Note: Allow up to 24 hours to process the telemetry associated with the Organization(s) in the system. While the system allows multiple organizations to be selected, currently only one organization can be selected. The option to select multiple organizations will be supported in a future release.
WARNING: SD-WAN Manager does not currently include asset configuration details which may result in a higher count of Potentially Affected devices under Security Advisories. Without the running configuration, CX Cloud cannot determine that the configuration is set to prevent a vulnerability. Consequently, the device is listed in the Potentially Affected tab as “Missing Running Configuration”.
Affected Reasons
Support is available for SD-WAN devices using CX Cloud Agent to pull telemetry directly from devices which includes the running configuration. Cisco recommends not configuring Cisco Catalyst SD-WAN Manager in CX Cloud Data Sources when devices are connected using CX Cloud Agent.
Troubleshooting
Q. Why are no Organizations returned when Add Data Source is selected?
A. Ensure that the user is the Administrator of the Smart Account associated with the SD-WAN Manager organization in the Smart Accounts Portal (software.cisco.com) and that the SD-WAN Manager has been set up in Smart Accounts with an Organization Name.
Q. The Organization was configured but it has been more than 24 hours and there is still no SD-WAN Manager telemetry.
A. Ensure that the Organization shown in SD-WAN Manager matches the selected Organization. Ensure that Cloud Services, Data Collection, and SD-WAN Telemetry Collection have been enabled in the Cisco Catalyst SD-WAN Manager.
Organization Names
Cloud Services Enabled
Data Collection and SD-WAN Telemetry Data Connection Enabled
Click here for more information about configuring SD-WAN Manager with Smart Accounts.
Click here for information about configuring Cloud Services and Data Collection.
Adding Cisco Webex Control Hub to CX Cloud
This section provides guidance on connecting Telemetry for the Collaboration Success Track to the CX Cloud account. For the Collaboration Success Track, Telemetry comes from the WebEx Control Hub, allowing CX Cloud customers to import and manage Collaboration assets in CX Cloud.
Prerequisites
- Access to Webex Control Hub with a cisco.com account; Click here for more information about adding users to WebEx Control Hub
- Access to CX Cloud with a cisco.com account
- Customers must have a cisco.com account in both WebEx Control Hub and CX Cloud to pull the associated Orgs in CX Cloud
To add Cisco Webex Control Hub to CX Cloud:
- Click Admin Settings > Data Sources.
- Click Add Data Source.
Add Data Source
- Select WebEx as the data source to add to CX Cloud and import the WebEx Control Hub account to CX Cloud.
Webex Data Source
A list of organizations associated with the logged in user displays. Refer to the Prerequisites above.
- Select the applicable Organization and click Connect.
Organization Selected
- Upon successful connection, the Collaboration prompt is added, and the data source Status displays as “First Collection Pending”.
Data Collection Message
After 24 hours, the data source displays as connected with the time of the last successful update.
Data Collection Completed