Overview

Sastre provides functions to assist with managing configuration elements and visualize information from Cisco SD-WAN deployments.

Some use-cases include:

  • Transfer configuration from one vManage to another. Lab or proof-of-concept environment to production, on-prem to cloud environments as examples.
  • Backup, restore and delete configuration items. Tags and regular expressions can be used to select all or a subset of items.
  • Visualize operational data across multiple devices. For instance, display status of control connections from multiple devices in a single table.

Sastre can be consumed as a self-contained CLI application or as a Python SDK to other applications. This documentation focuses on leveraging Sastre infrastructure as an SDK, being referred to as Cisco SD-WAN Python SDK.

This is a tool created and maintained by Cisco. Support enquires can be sent to sastre-support@cisco.com.

The current release of the SDK is 1.17. Information about each release is available on the CHANGELOG file.

What can I do with the SDK

The SDK allows Python developers to build applications that communicate with Cisco SD-WAN, without having to deal with the lower-level details of vManage REST API.

The common tasks include to create workflows out of one or more Sastre tasks:

  • Backup: Save vManage configuration items to a local backup.
  • Restore: Restore configuration items from a local backup to vManage.
  • Delete: Delete configuration items on vManage.
  • Migrate: Migrate configuration items from a vManage release to another. Currently, only 18.4, 19.2 or 19.3 to 20.1 is supported. Minor revision numbers (e.g. 20.1.1) are not relevant for the template migration.
  • Transform: Modify configuration items. Currently, copy and rename operations are supported.
  • Attach: Attach WAN Edges/vSmarts to templates. Allows further customization on top of the functionality available via "restore --attach".
  • Detach: Detach WAN Edges/vSmarts from templates. Allows further customization on top of the functionality available via "delete --detach".

Also it can integrate with enterprise observability stacks by building collectors to import SD-WAN operational data (state, statistics, alarms, events, etc.) into prometheus, elasticsearch, etc.