Simple client that checks a network link for common errors
Project description
What is linktester?
linktester is a small link test application that uses iperf3 and ethtool to look for errors, problems on a network link. You could use it for example to test a new physical connection between a new card you installed on a server and an existing machine.
How does it work
The way is works is simple:
- Capture statistics on the card using ethtool
- Wait for a remote iperf3 server to start. Once is up, send TCP traffic to trigger for a few minutes any unwanted behaviour.
- Capture statistics on the card using ethtool a second time and compare error counters
- Report back
Requirements
- iperf3 and iperf3 libraries (most distributions have RPM, DEB packages)
- Python3
- Rest of the dependencies will be installed with PIP and a virtual environment: rich, python3-iperf3
For example, on Fedora (or any RPM based system) you can install the dependencies as follows:
sudo dnf -y install iperf3 python3-ethtool libnl
On a Debian based distribution:
sudo apt-get install -y python3-ethtool iperf3
Virtual environment
I do recommend you use a virtual environment for the installation:
python3 -m virtualenv $HOME/virtualenv/linktester
. $HOME/virtualenv/linktester/bin/activate
For the rest of the installation instructions I will assume you have activated your virtual environment as explained above.
Installation
Once all the base bindings are installed then you can proceed to install from Pypi.org:
pip install linktester
Developers
If you want to contribute features you can do this:
python3 -m virtualenv $HOME/virtualenv/linktester
. $HOME/virtualenv/linktester/bin/activate
git clone git@github.com:josevnz/linktester.git
python setup.py develop
Bugs
Please report any bugs on the official linktester page
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Hashes for linktester-0.0.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 824728f6ffc59ebaa87c09a19d0884ac6ff7b3262320a19accdd93dc9e1f5be8 |
|
MD5 | e65304853dbecffe7840bce784657763 |
|
BLAKE2b-256 | 9857363612164bfdcbc82394cc3ebdaf53cca573222ad9974bfa84b524c1265d |