dnac-pnp 1.0.2b1

Cisco DNA center PnP device add, claim and delete automation

dnac-pnp

Cisco DNA center device claim and delete automation

Features

Behaviour

• Git alike commandline user interface

• Define user credentials and host for DNAC

• Read configurations from file

• Configurations file lookup in 3 default locations

Checks

• Pre-checks user inputs

• Pre-checks csv file for bulk import (add+claim)

• Pre-checks txt file for bulk delete

• Pre-check templates

• Pre-check and warning messages for template variables

• Pre-checks for valid sites

• Pre-checks for device status

Import

• Single import of device

• Bulk import devices from csv

• Single site creation

• Bulk site creation

Delete

• Single device deletion, more than one device deletion

• Bulk device delete from txt file

• Single/Multiple Device delete even after provision

Decision

• Decision based on site status and device status

• Read day0 template

• Decide on day0 template parameters are provided properly or not

• Shows day0 template parameters

• Day0 configuration

View

• Shows all pnp devices

• Shows details about a single device by serial number

• Shows all available templates

• Shows specific template body and variables by full template name

• Shows all available locations

Export

• Export all PnP devices to csv

Dependencies

This package requires a configuration file in either .yaml or yml format. The look up priority for the configuration file is as following-

1. <user_home_directory>/.<package_name>/configs/config.yaml (Window/Linux/MacOS)

2. <current_working_directory>/.<package_name>/configs/config.yaml (Windows/Linux/MacOS)

3. /etc/<package_name>/configs/config.yaml (Linux/MacOS)

If config.yaml doesn’t exists in one of these locations, the program will NOT run. So, to create the configuration file, please use -

Windows

Windows system by default doesn’t allow creation of . prefixed directory from GUI, so use the following -

• Open cmd and change the directory to the home folder of the user

• Run mkdir .dnac_pnp

• Run cd .dnac_pnp

• Run mkdir configs

Now that the . prefixed directory is created, use the GUI to add a file in configs directory named config.yaml. Once the file is created, open the file and add the following lines according to your preference -

---
dnac:
  host: sandboxdnac.cisco.com
  username: <username>
  password: <secret_password>

Linux/MacOS

• Open a terminal and cd into the home directory or any other directory form the above dependency list.

• Run mkdir -p .dnac_pnp/{catalog, configs}

• Run cd .dnac_pnp/configs/

• Run nano config.yaml

• Add the above lines into the file and save it

Bulk Import Dependency

While importing in bulk, a device catalog file can be put inside the catalog folder under .dnac_pnp with DeviceImport.csv name at the program will automatically read this file.

Windows

.dnac_pnp\catalog\DeviceImport.csv

Linux/MacOS

.dnac_pnp/catalog/DeviceImport.csv

Note

Samples files are available, in the data directory of this repo. The location of the catalog file can be provided with -f flag also

Usage

Installing Virtual Environment

It is highly recommended to use virtual environment for this package. To know how to setup the virtual environment please visit this page.

Installing the package

Once you have virtual environment installed, clone this repository and move into the root directory of the project.

Now, crate a virtual environment.

virtualenv --always-copy -p python3 venv

activate virtual environment -

Linux/MacOS

source venv/bin/activate

Windows

venv\Scripts\activate.bat

Once the virtual environment is active, run the following command -

pip install .

Once the installation is finished, check out all the available options with -

dnac_pnp --help

This should give an output like below -

(venv) C:\Users\user.name\folder\dnac-pnp>dnac_pnp --help
Usage: dnac_pnp [OPTIONS] COMMAND [ARGS]...

Mission control module

Options:
  --debug    Turns on DEBUG mode.  [default: False]
  --version  Show the version and exit.
  --help     Show this message and exit.

Commands:
  acclaim-devices  Add and claim single or multiple devices.
  add-sites        Add one or more sites.
  delete-devices   Delete single or multiple devices.
  pkg-info         Shows package information.
  show             Shows DNA center component information.

To see the individual options for any of the commands use --help flag after the command.

(venv) C:\Users\user.name\folder\dnac-pnp>dnac_pnp acclaim-in-bulk --help

To use this package without any errors/bugs please always activate the virtual environment first

To deactivate virtual environment use -

deactivate

Credits

See AUTHORS.rst

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.

History

1.0.2b1 (2019-10-25)

• Second release with package missing error fixes

1.0.1b2 (2019-09-23)

• Beta release 2

1.0.1b1 (2019-09-23)

• First beta release

0.4.5 (2019-09-23)

• Major CLI look and fell changes

• Bug fixes

0.4.4 (2019-09-20)

• Bug fixes as CISCO api changes

0.4.3 (2019-09-19)

• IOS device reset functionality added

• Listing of all available sites

• Sample data modifications

• Bug fixes

• New api references added

• Bulk site creation

0.4.2 (2019-08-30)

• Fixed skipped serial number bug

• Removed pagination dependency

0.4.1 (2019-08-29)

• Documentation updates

0.3.5 (2019-08-29)

• Fixed template version mismatch

• Added csv export functionality

0.3.4 (2019-08-26)

• Documentation updates

0.3.3 (2019-08-26)

• Separated token generator

• Modulated template functionality

0.3.2 (2019-08-24)

• Fixed bug for auto build

• Tokenize dependency for setup

• Removed .gz artifact storage

• Added usage instructions

• Updated documentation tutorials

• Added delete option for pnp devices

• Changed package dependency and encoding

• Fixed PnP flag for delete commands

• Updated delete instructions

• Introduced aliased group

• Added template handler

• Added template validation

0.3.1 (2019-08-20)

• Fixed documentation bugs for note and warning

0.2.5 (2019-08-19)

• Added api documentation

• Introduced first draft of documentation

0.2.4 (2019-08-19)

• Adding Jenkinsfile for auto build

• Adding jfrog-spec.json for artifact management

0.2.3 (2019-08-14)

• Updated issue #13

• Ready for testing

0.2.2 (2019-08-13)

• Fixed device delete bug (Issue #15)

• Updated Readme

0.2.1 (2019-08-08)

• Added CSV file read and json conversion

• Added input validation for bulk import

• Fixed Host not found BUG

• Added extra info to screen messages

0.1.5 (2019-08-07)

• Decoupled authentication process

0.1.4 (2019-08-07)

• Fixed version upgrade bug

• Removed device type in configurations

0.1.3 (2019-08-06)

• Added bulk import feature

0.1.2 (2019-08-06)

• Updated logging

• Updated syntax in source code

• Added API calls for importing devices

• Bug fix - Import devices

• Added device type in configurations

• Changed all log level default to DEBUG

• Added device claim

• Fixed issues

0.1.1 (2019-08-02)

• Added nested cli commands

• Added import handlers

• Added context management

0.1.0 (2019-07-31)

• Added functionality to login to DNAC

• Read configurations from file

• Default config locations for looking for configurations

0.1.0 (2019-07-30)

• First release on GitLab.

• Adding LICENSE

• Creating setup and structure