This repository is deprecated; please follow the main search page or use the ‘Related code repos’ widget on the right side of the current page.

Onboarding Tools

Intent

Predefine an automated onbording workflow for new devices being connected to the network.

PnP-BulkConfig

Allows uploading of "predefined" rules to onboard network devices.
variables can be supplied to fill in device specific parameters.

The scripts in this directory take a CSV file of device serialNumber plus a workflow to be applied to them.
A PnP rule is created for each device, linking the serialNumber of the device to a predefined workflow in Cisco DNA Center.

When the device is connected to the network, it will discover Cisco DNA Center and begin the onboading process.

Cisco DNA Center will recognise the serial number of the device, and run the pre-defined workflow.

A simple example of a workflow would include an initial configuration template, which contains variables (such as hostname).
The script will recognise template variables and fill them in from the CSV file.

PnP-BulkConfig-128

Modified for version 1.2.8 which integrates the onboarding process into provisioning.
Instead of a workflow, uses a "site" and a day-0 template to configure the device.

PnPNoSerialClaim

A tool to allow auto-claiming of devices based on IP address and CDP neighbour uplink (as opposed to serialNumber).

It is only possible to do this using unclaimed flow as you need to get the IP address and CDP neighbour information after the
device contacts Cisco DNA Center.

This approach uses a workflow (configured via API) and mapped into a static config file.

Use Case

This tool enables you to upload pre-defined rules when onboarding network devices. Variables can be supplied to fill in device specific parameters.

The scripts in this directory consume a CSV file of device serial numbers and Cisco DNA Center workflows to be applied to the devices. A PnP rule is created for each device, linking the serial number to the workflow. When the device is connected to the network, it will discover Cisco DNA Center and begin the onboarding process. Cisco DNA Center will recognize the serial number of the device, and run the pre-defined workflow.

A simple example workflow might be an initial configuration template that contains variables, such as hostnames. The script will identify template variables and fill them in with information from the CSV file.

Objectives

  • A PnP rule is created for each device, linking the serial number to the workflow.
  • When the device is connected to the network, it will discover Cisco DNA Center and begin the onboarding process, recognize the serial number of the device, and then run the pre-defined workflow.
  • Cisco DNA Center will recognize the serial number of the device, and run the pre-defined workflow.
  • Cisco DNA Center will add, claim and delete of bulk devices.

Requirements

Python 3.6+

View code on GitHub

Code Exchange Community

Get help, share code, and collaborate with other developers in the Code Exchange community.View Community
Disclaimer:
Cisco provides Code Exchange for convenience and informational purposes only, with no support of any kind. This page contains information and links from third-party websites that are governed by their own separate terms. Reference to a project or contributor on this page does not imply any affiliation with or endorsement by Cisco.