Creating a basic integration for Cisco DNA Center assets

Create an integration to sync Cisco DNA Center with Oomnitza to gain visibility of network device data and manage network device data.

Before you start

This integration is a local basic integration and must be managed on a local machine. You must prepare your local environment beforehand, download the Oomnitza connector, update a configuration file, and push it to your Oomnitza instance. Finally, you must add a schedule to run the basic integration using tools such as Task Scheduler. 

To stream data into Oomnitza, complete these tasks:

1. Review the system requirements. 
2. Download and install Python. Best practice is to create a virtual environment. A virtual environment is created on top of the existing Python installation and can be isolated from the packages in the base environment, so only those explicitly installed in the virtual environment are available.

Installing the connector

GitHub: Getting started

Download the source code

1. Log into Oomnitza.
2. Click Configuration > Integrations and click Block view
3. In the Basic section for Asset Integrations, click the tile.
4. Download the source code and place it in a directory, such as C:\oomnitza_connector. 

You can also download the source code on the Oomnitza Connector page on GitHub.

Installing the Python dependencies

In the directory you created (C:\oomnitza_connector), install the required Python dependencies stored in the requirements.txt file using pip install -r requirements.txt

Tip
Run pip install --upgrade pip before installing and use the new version of pip

Generate the configuration file

In the same directory, runpython connector.py generate-ini to generate theconfig.inifile. For further information read the Connector Configs section in the Getting started document.

Run python connector.py --help to see all of the available command line options.

Edit the configuration file

You must modify the following sections in the configuration file:

• The Oomnitza section
• The Cisco DNA Center section

Before you edit the configuration file, you must retrieve the following information: 

• An Oomnitza token. See Adding, revoking, and refreshing an Oomnitza API token.  
• Your credentials.

Oomnitza configuration settings

[oomnitza]
url= https://<name_of_instance>.oomnitza.com
api token = <my_oomnitza_token>

In the section for Cisco DNA Center, make the following changes:

• • Set enable to True.
  • Enter your Cisco DNA Center base URL.
  • Enter your Cisco DNA username.
  • Enter your Cisco DNA password.
  • Add additional columns in db_columnsto display more data.

[dnac_network_devices]
enable = True
username = administrator
password = change-me
base_url = https://your_base_url/

You can delete the configurations that you do not need from the list such as Kace, Jasper, and so on.

Save your changes.

Map fields to Oomnitza

Map the fields to Oomnitza fields to get the asset information that you need. To map the fields, complete these steps:

1. Click Configuration > Integrations and then click Block view
2. In the Basic section for Asset Integrations, click the tile for the integration.
3. Click Mappings.
4. Map the fields to Oomnitza fields.  
5. Select the Serial Number as the sync key, which will synchronize the data that is streamed from into Oomnitza.
6. Click FINISH.

Custom fields

You can map these fields to Oomnitza:

AP Ethernet MAC Address
AP Manager Interface
AP Associated WLC IP
Boot Date Time
Collection Interval
Collection Status
Connect: Base URL
Connect: Credentials
Connect: Verify SSL
Connector Sync Time
Description
Device Support Level
Error Code
Error Description
Family
Host Name
ID
Instance Tenant ID
Instance UUID
Interface Count
Inventory Status Detail
Last Update Time
Last Updated
Line Card Count
Line Card ID
Location
Location Name
MAC Address
Managed Atleast Once
Management State
Memory Size
Platform ID
Reachability Failure Reason
Reachability Status
Role
Role Source
Serial Number
Series
SNMP Contact
SNMP Location
Software Type
Software Version
Tag Count
Tunnel UDP Port
Type
Up Time
Uptime Seconds
WAAS Device Mode

Run the network devices connector

To upload Cisco DNA Center data to Oomnitza, run the connector.

Run the connector in test mode to ensure that the mapped information is uploaded to Oomnitza:

python connector.py upload dnac_network_devices --testmode

When you are confident that you are uploading the information that you mapped, run the connector again in normal mode:

python connector.py upload dnac_network_devices

Getting the results

1. Click Configuration > Integrations and click Block view .
2. In the Basic section for Asset Integrations, click the tile.
3. Click SYNC SESSIONS.
4. Go to the Assets page and review the information that is uploaded.

Unleash the power of Oomnitza

To get valuable actionable insights that help you manage your assets, learn how to:

Configure dashboards to visualize key business data

Configure custom reports 

See Getting started.