This repository contains the files required for the participants of Cisco Live US 2019 workshop:

DevNet-2595: Stateful Network Validation using pyATS+Genie and Robot Framework.

This workshop can be completed at home; as all devices are included in this workshop.

• Cisco Live US: https://www.ciscolive.com/us.html?zid=cl-global
• pyATS/Genie Portal: https://developer.cisco.com/pyats/
• Genie Documentation: https://pubhub.devnetcloud.com/media/pyats-packages/docs/genie/index.html
  • Genie CLI: https://pubhub.devnetcloud.com/media/pyats-packages/docs/genie/cli/index.html
  • RobotFramework Keywords: https://pubhub.devnetcloud.com/media/pyats-packages/docs/genie/robot.html
  • Triggers, Verifications, Models: https://pubhub.devnetcloud.com/media/pyats-packages/docs/genie/genie_libs/index.html
• pyATS Documentation: https://developer.cisco.com/docs/pyats/
  • RobotFramework Keywords: https://pubhub.devnetcloud.com/media/pyats/docs/robot.html
• Community: https://communities.cisco.com/community/developer/pyats
• Support Email: [email protected]

• Mac OSX, Linux or Windows 10 WSL
• Python 3.5, 3.6 or 3.7
• Network connectivity (for downloading PyPI packages)
• Working knowledge of Python is a plus, but not required.

All Cisco devices are provided! We are providing mocked devices which are sufficient for this workshop.

These preparations will have been already done on the laptop you use in Cisco Live. If you are doing this on your own times, you'll need these steps.

In a new shell window:

# create a development directory
cd ~/workspace
mkdir devnet-2595
cd devnet-2595

# create python virtual environment
python3 -m venv .

# activate virtual environment
source bin/activate

# update your pip/setuptools
pip install --upgrade pip setuptools

Installing genie and genie.libs.robot will automatically install all required dependencies, including pyats and pyats.robot Robot Framework keyword support.

# install genie and genie robot library
pip install genie genie.libs.robot

# clone this repo
git clone https://github.com/CiscoTestAutomation/CL-DevNet-2595.git workshop

and now you should be ready to get going!

Head to the >Main Workshop< to start!

    testbed.yaml                      testbed YAML file to connect to our devices
    robot_initial_snapshot/           Directory with RobotFramework script to gather the first snapshot
    robot_compare_snapshot/           Directory with RobotFramework script to collect the second snapshot and compare with the initial snapshot
    mocked_devices/                   Data for the mocked devices.
    README.md                         Introduction text for this Workshop
    workshop.md                       Workshop instruction