https://github.com/cskoglun/ciscodnacbackupctl

https://github.com/cskoglun/ciscodnacbackupctl

Last synced: 25 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/cskoglun/ciscodnacbackupctl
• Owner: cskoglun
• License: other
• Created: 2021-02-26T18:57:35.000Z (almost 4 years ago)
• Default Branch: master
• Last Pushed: 2023-04-21T16:56:23.000Z (over 1 year ago)
• Last Synced: 2024-11-01T03:06:09.082Z (about 1 month ago)
• Language: Python
• Size: 146 KB
• Stars: 15
• Watchers: 8
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

• awesome-cisco-dnac - ciscodnacbackupctl

README

        
# ciscodnacbackupctl

![PyPI](https://img.shields.io/pypi/v/ciscodnacbackupctl)

![PyPI - Downloads](https://img.shields.io/pypi/dm/ciscodnacbackupctl)

![GitHub last commit](https://img.shields.io/github/last-commit/cskoglun/ciscodnacbackupctl)

![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/cskoglun/ciscodnacbackupctl)

![GitHub issues](https://img.shields.io/github/issues/cskoglun/ciscodnacbackupctl)

![GitHub closed issues](https://img.shields.io/github/issues-closed-raw/cskoglun/ciscodnacbackupctl)

![Libraries.io dependency status for GitHub repo](https://img.shields.io/librariesio/github/cskoglun/ciscodnacbackupctl)

![GitHub Repo stars](https://img.shields.io/github/stars/cskoglun/ciscodnacbackupctl?style=social)  

Cisco DNA Center Backup Tool (as a CLI tool)  

_Helps you to manage your backups and purge previous backups and also incompatible backups (between versions)_

---

## Why?

In the current state of Cisco DNA Center, it's possible to schedule and perform backups.  

But there's no automated way of purging backups and users are asked to purge backups through the Web UI

```ciscodnacbackupctl``` offers a CLI interface to handle your backups from your terminal or as a daemon/docker container

## Features

- [x] List all backups

- [x] History/On-going backups

- [x] Delete backup

- [x] Purge backups (all or just incompatible ones)

- [x] Schedule backups

    - [x] New Backup

    - [x] Purge

- [x] Debug HTTP

### Unsupported features

- Assurance backups (NFS)

  - _"The Assurance data consists of network assurance and analytics data. The first backup of Assurance data is a full backup. After that, backups are incremental."_

  - [Details](https://www.cisco.com/c/en/us/td/docs/cloud-systems-management/network-automation-and-management/dna-center/2-3-3/admin_guide/b_cisco_dna_center_admin_guide_2_3_3/b_cisco_dna_center_admin_guide_2_3_3_chapter_0110.html)

## Installation

```pip install ciscodnacbackupctl```

### Config

```

ciscodnacbackupctl config --help

Usage: ciscodnacbackupctl config [OPTIONS]

Options:

  --env / --no-env

  --hostname TEXT   [required]

  --username TEXT   [required]

  --password TEXT   [required]

  --secure          Secure HTTPS towards Cisco DNA Center

  --encode          Encode Cisco DNA Center config to Base64 string

  --overwrite       Writes over the existing config for Cisco DNA Center

  --help            Show this message and exit.

```

```

Usage: ciscodnacbackupctl [OPTIONS] COMMAND [ARGS]...

Options:

  --debug / --no-debug

  --version             Show the version and exit.

  --help                Show this message and exit.

Commands:

  config

  create

  daemon           ['start', 'stop', 'restart', 'status']

  delete

  history

  list

  progress

  purge

  schedule_backup

  schedule_purge

  whoami

```

## Technologies & Frameworks Used

**Cisco Products & Services:**

- Cisco DNA Center

**Tools & Frameworks:**

- rich

- tabulate

- hurry

- click

- schedule

- daemonocle

## Daemon or Docker

This makes it possible to automatically purge old backups daily

### Daemon

```ciscodnacbackupctl daemon start --keep 3```

### Docker Support

Generate Cisco DNA Center config as Base64 string  

```docker run -it --rm robertcsapo/ciscodnacbackupctl config --env --hostname  --username  --password  --encode```

Use the ENV to exucute commands

List

```

docker run -it --rm \

-e DNAC_CONFIG=ewogICAgImRuYWMiOiB7CiAgICAgICAgImhvc3RuYW1lIjogInNhbXBsZS5ob3N0LnRsZCIsCiAgICAgICAgInVzZXJuYW1lIjogImRuYWMiLAogICAgICAgICJwYXNzd29yZCI6ICJwYXNzdzByZCIsCiAgICAgICAgInNlY3VyZSI6IGZhbHNlCiAgICB9Cn0 \

robertcsapo/ciscodnacbackupctl \

list

```

Purge

```

docker run -it --rm \

-e DNAC_CONFIG=ewogICAgImRuYWMiOiB7CiAgICAgICAgImhvc3RuYW1lIjogInNhbXBsZS5ob3N0LnRsZCIsCiAgICAgICAgInVzZXJuYW1lIjogImRuYWMiLAogICAgICAgICJwYXNzd29yZCI6ICJwYXNzdzByZCIsCiAgICAgICAgInNlY3VyZSI6IGZhbHNlCiAgICB9Cn0 \

robertcsapo/ciscodnacbackupctl \

purge

```

## Authors & Maintainers

Smart people responsible for the creation and maintenance of this project:

- Christina Skoglund 

- Robert Csapo 

## License

This project is licensed to you under the terms of the [Cisco Sample

Code License](./LICENSE).