Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
..
Failed to load latest commit information.
config
network
tmp
tools
0_built_topo.py
1_monitor.py
2_test.py
3_destroy_topo.py
README.md
requirements.txt

README.md

ACME-SMALL

A simple 4-node topology.

Alt text

Prerequisites

  • UNetLab server reachable from local machine
  • L2 and L3 IOU images under /opt/unetlab/addons/iol/bin renamed to 'L2-LATEST.bin' and 'L3-LATEST.bin'

Install dependencies

pip install -r requirements.txt

Environment setup

  • Change ./network/tests/traffic_flows.txt file to match the expected traffic paths
  • Change ./network/tests/ping_flows.txt file to match the destinations that need to be monitored
  • Change ./network/unetlab.yml to match your UNetLab server environment

Workflow

  1. Build and configure topology
    ./0_build_topo.py

After this step you should be able to find the lab up and running on UNetLab server.

  1. Verify real-time connectivity while making configuration changes

    ./1_monitor.py

Only failed pings will be displayed.

  1. Verify test scenarios

    ./2_test.py

If any of the scenarios have failed, examine the output, adjust configuration as needed and re-run the tests.

  1. Shutdown and delete the lab

    ./3_destroy_topo.py

Caveats

  • Designed only for IPv4 on Cisco IOS devices
  • Assuming only 15 seconds for protocol reconvergence when creating failure conditions