readme.md

snappi Tests

This repository consists of end-to-end test scripts written in snappi.

Setup

Please make sure that the client setup meets Python Prerequisites.

This repository is currently work-in-progress, and hence only the tests inside tests/raw have been tested against both Ixia-c and IxNetwork.

• Clone this project, cd inside it.

• Install snappi (along with extensions if needed).

  # if no extensions are needed - e.g. for ixia-c testbed
  python -m pip install --upgrade snappi==0.12.6
  # install with ixnetwork extension - for ixnetwork testbed
  python -m pip install --upgrade "snappi[ixnetwork]==0.9.1"

• Install test dependencies.

  python -m pip install --upgrade -r requirements.txt

• Update tests/settings.json

  # sample for ixia-c testbed
  {
    # controller address
    "location": "https://localhost:8443",
    "ports": [
        # traffic engine addresses 
        "localhost:5555",
        "localhost:5556"
    ],
    # since we're not using any snappi extension
    "ext": null,
    "speed": "speed_1_gbps",
    "media": null
  }
  # sample for ixnetwork testbed
  {
    # IxNetwork API Server address
    "location": "https://192.168.1.1:8443",
    "ports": [
        # chassis;card;port
        "192.168.2.1;6;1",
        "192.168.2.1;6;2"
    ],
    # since we're using snappi ixnetwork extension
    "ext": "ixnetwork",
    "speed": "speed_1_gbps",
    "media": "fiber"
  }

• Run Tests.

  python -m pytest tests/raw/test_basic_flow_stats.py

Python Prerequisites

• Please make sure you have python and pip installed on your system.

  You may have to use python3 or absolute path to python executable depending on Python Installation on system, instead of python.

  python -m pip --help

  Please see pip installation guide, if you don't see a help message.

• It is recommended that you use a python virtual environment for development.

  python -m pip install --upgrade virtualenv
  # create virtual environment inside `env/` and activate it.
  python -m virtualenv env
  # on linux
  source env/bin/activate
  # on windows
  env\Scripts\activate on Windows

  NOTE: If you do not wish to activate virtual env, you use env/bin/python (or env\scripts\python on Windows) instead of python.