# testing-harness

**Repository Path**: mirrors_esnet/testing-harness

## Basic Information

- **Project Name**: testing-harness
- **Description**: A harness for executing jobs across multiple hosts and collecting output.
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-04-02
- **Last Updated**: 2026-03-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ESnet Network Test Harness

To install dependencies, run:

```
pip install build
python3 -m build
```


This directory contains a customized version of ESnet's Network Test Harness for testing BBRv3.

Eventually this branch should probably be merged into the master branch.


This docker container has all tools needed (latest versions of ss and mpstat are required)
```
see: https://hub.docker.com/r/bltierney/perfsonar-testpoint-bbrv3-testing
```

# Docker container

The easiest way to use this test harness is via docker. Useful docker commands inslude:
```
 docker compose -f docker-compose.yml build
 docker compose -f docker-compose.yml up -d
 docker compose -f docker-compose.yml exec testpoint bash
 docker compose down
```


# Directories
```
ini: sample config files
lib: python code for each of the harness modules
plot: utilities needed to generate Gnuplot graphs
```

## Example execution

Sample command to run a single test:
~~~
$ ./collect.py -j ini/single.ini -o /data
~~~

Sample cron entry:
~~~
$ /harness/collect.py -v -i ens2 -j /harness/ini/perfsonar.ini -o /data -H /harness/ini/test-hosts.csv >> /tmp/harness.out 2>&1 
~~~

## iperf3 example output with default settings (localhost test)
```
$ python3 collect.py -j ini/iperf3.ini
[2021-03-31 16:37:53,266] [MainThread] INFO: Found 2 job definitions
[2021-03-31 16:37:53,266] [MainThread] INFO: Created job for item "iperf3_cubic"
[2021-03-31 16:37:53,267] [MainThread] INFO: Created job for item "iperf3_bbr2"
[2021-03-31 16:37:53,267] [MainThread] INFO: Starting jobs [2]
[2021-03-31 16:37:53,267] [MainThread] INFO: Executing runs for job iperf3_cubic and 2 iterations
[2021-03-31 16:37:53,267] [MainThread] INFO: Testing to 127.0.0.1 using "iperf3 -c 127.0.0.1 -J -A 1 -C cubic"
[2021-03-31 16:38:53,991] [MainThread] INFO: Executing runs for job iperf3_bbr2 and 1 iterations
[2021-03-31 16:38:53,991] [MainThread] INFO: Testing to 127.0.0.1 using "iperf3 -c 127.0.0.1 -J -A 1 -C bbr"
```

## Use with Netem

If you have a host running netem in your test path, you can specify netem sweep options in the .ini file.
See ini/perfsonar-throughput-example.ini for options. Note that the harness expects to find a script
/harness/utils/pre-netem.sh, and that you will likely need to customize that script for your setup. 

## Plotting the results

Instructions coming soon
- ### (plot/iperf3_to_gnuplot.py)
TBD