The bandwidth testing application
bwtester enables a variety of bandwidth tests on the SCION network. Installation and usage are described below. Documentation of the code and protocol are described in the bwtester README.
sudo apt install scion-apps-bwtester
See Installation for details.
Sample servers are installed at the following locations:
You can test the application as follows:
scion-bwtestclient -c 17-ffaa:1:89,[127.0.0.1]:0 -s 17-ffaa:1:13,[192.168.1.79]:30100
-s specifies the bandwidth server whereas
-c specifies your machine.
-c flag can be omitted if a SCION localhost address is configured. To do this, add your
SCION host to the
/etc/hosts file. Below you can see an example:
# regular IPv4 hosts # .... # regular IPv6 hosts # .... # SCION hosts 17-ffaa:0:1,[192.168.1.1] localhost
Controlling the bandwidth¶
The application supports specification of the test duration (up to 10 seconds), the packet size to be used (at least 4 bytes), the total number of packets that will be sent, and the target bandwidth. For instance,
5,100,10,1600bps specifies that 10 packets of size 100 bytes will be sent over 5 seconds, resulting in a bandwidth of 1600bps. The question mark
? character can be used as wildcard for any of these parameters. Its value is then computed according to the other parameters. The parameters for the test in the client-to-server direction are specified with
-cs, and the server-to-client direction with
-sc. So for instance to send 1 Mbps for 10 seconds from the client to the server, and 10 Mbps from the server to the client, you can use this command:
scion-bwtestclient -s 17-ffaa:1:13,[192.168.1.79]:30100 -cs 10,1000,1250,1Mbps -sc 10,1000,12500,10Mbps
For more information run the application without arguments to print its usage.
bwtestclient is also available via the webapp.
The server is started as follows:
scion-bwtestserver -s 17-ffaa:0:1102,[184.108.40.206]:30100 &
-s specifies your server address. Again, it can be omitted by specifying a SCION localhost like above. The server then
uses localhost to bind to. In this case, the port can be specified with the
scion-bwtestserver -p 30100 &