DevNet Create 2018

Session times: Tuesday 4/10/2018 3:00pm-4:30pm @ Workshop 5 - WS19 Wednesday 4/11/2018 10:15am-11:45am @ Workshop 7 - WS51

The current digital transformation trend is largely about digitizing existing business processes. In this workshop you will code against the Cisco Spark API and create a "digital project manager" which you can pair with your digital apps to provide project teams with robust live status updates!

During this session we will discuss a bit of software called "Digital Project Manager" as an example. The DPM is part of a larger application that defines and monitors the status of Ethernet access switch migrations. Because the application knows about the state of the migration, it can be used to supplement the migration team. The software can provide real-time migration status to project stake holders. If we think outside the box, we can turn Spark into more than just a notification target, we can make it a realtime migration log, work completion time estimator and report delivery vehicle! Participants will be encouraged to think of and implement other novel uses for Cisco Spark APIs.

The objective of this workshop is to:

• Acquire digital data about a real world process occurring in network infrastructure
• Interpret the data in the context of a migration event occurring in a timed window
• Create relevant progress metrics and display them in a visually appealing way
• Leverage the Cisco Spark API and application to share the progress with a team

##Agenda

We will go through a quick setup, clone the workshop repo, and verify prerequisites (Python, Pycharm, pip, venv, git, Flask, pysnmp) are installed.

We will walk through a functional implementation of the digital project manager functionality.

We will walk through provisioning a bot and obtaining a token in Cisco Spark; Programmatically organizing users in Spark teams and spaces; Listening for data from the switch infrastructure with SNMP; Scrubbing the data and getting it into a useful format; Formatting the data for Cisco Spark; and Sending the information to Cisco Spark.

We will recap what was learned, and participants will be called to consider and share other ways they think this type of Cisco Spark interaction could be used.

During the workshop you will be interacting with a pair of switches. Without an ability to attach to the switches... well, let's just say you won't get much value from the workshop!

Cisco Spark is a cloud-based team messaging, meeting and calling client. You can sign up for a basic/free account if you don't have one already from http://www.ciscospark.com. Once you have an account you can also familiarize yourself with the Spark API found at http://developer.ciscospark.com.

Cisco Spark can be consumed from the www.ciscospark.com webpage, but the experience is best had on the Windows or Mac clients. You can and should also install Spark on iOS and Android mobile devices!

You will need git to obtain the code we'll be editing, and the workshop will leverage git branches to ensure everyone is able to have running code at each step along the way. The code we will be running was written in Python3, so you'll need that installed. pip is a package manager which will allow you to install the dependencies upon which our application is built. The major components we're leveraging are pysnmp, requests, Flask and SQLalchemy. Those will be installed during a later step.

**Mac OS X Installation

• Mac Command Line Developer Tools Installation. After running command, complete installation using the GUI.

  xcode-select --install

• git installation - https://git-scm.com/download/mac

• Python 3.6.5 installation - https://www.python.org/downloads/release/python-365/

• Python pip installation

  curl -o get-pip.py https://bootstrap.pypa.io/get-pip.py

  sudo -H python get-pip.py

**Windows Installation

• git installation - https://git-scm.com/download/win

• Python 3.6.5 installation - https://www.python.org/downloads/release/python-365/

• Python pip installation - https://pip.pypa.io/en/stable/installing/

• https://help.github.com/articles/connecting-to-github-with-ssh/

https://www.jetbrains.com/pycharm/download/

git clone git@github.com:paulgiblin/digital-project-manager.git

• File -> Open -> select the directory -> click Open

  This will open the project in PyCharm, if you did it correctly, the top level directory should have run.py in it.

• Open Preferences -> "Project:digital-project-manager" -> Project Interpreter -> click on the gear icon -> choose "Add local..."

• Make sure new Virtualenv Environment is selected, and it points to your Python 3.6 instance for the base interpreter

  Virtualenv is installed as part of PyCharm, but can also be run independently. Virtualenv copies the interpreter to a local directory, and any packages installed are also copied. This gives us a clean environment to work with, independent of any global configuration your operating system may have.

• Click "Install Packaging tools" if prompted

• Open run.py -> banner at the head should prompt to install requirements, install them

• Click the Run/Debug Configuration drop down (next to the play icon) and select edit configurations

• Click +, then Python

• Enter python3.6-dpm for the name and configure the Script Path field to point to run.py in the root directory of the project

• Click play, Flask should indicate the application is running