Features

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

virtualenv --always-copy -p python3 venv

source venv/bin/activate

venv\Scripts\activate.bat

pip install .

dnac_pnp --help

(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.

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

deactivate

Credits

See AUTHORS.rst

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

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