This page describes the procedure for setting up, running, and cleaning up each of the experiments that we're running for the [wiki:PlasticSlices Plastic Slices] project.

In each experiment, it assumes you've already created your slice and all of its slivers, and divided your compute resources into ''clients'' and ''servers''.

= !GigaPing =

This experiment uses the 'ping' command to send 1 GB of data via ICMP.

== Setup ==

Divide the hosts that you want to use into pairs. The client is the one that you'll run the 'ping' command on; the server is the one that you'll ping from the client.

Identify the precise IP address on each server that you'll want to ping. Make a table to keep track of which server you'll want to ping from each client, e.g.

|| ''client''              || ''server address''   ||
|| ganel.gpolab.bbn.com    || server=10.42.101.104 ||
|| of-planet1.stanford.edu || server=10.42.101.73  ||

You'll use the "server=<ipaddr>" parts when you go to execute the experiment.

To send 1 GB of data, you'll need to send a total of 666,667 1.5 KB packets. Rounding up for simplicity, divide 700,000 by the number of host pairs you have; call this number <count>, and use it below when you run the 'ping' commands.

== Execution ==

On each client, run

{{{
server=<ipaddr>
count=<count>
sudo ping -i .001 -s $((1500-8-20)) -c $count $server
}}}

using the "server=<ipaddr>" line from your table, and the <count> value you calculated earlier.

That should print many lines on your terminal that look like

{{{
1480 bytes from <ipaddr>: icmp_seq=44 ttl=64 time=135 ms
1480 bytes from <ipaddr>: icmp_seq=49 ttl=64 time=87.7 ms
1480 bytes from <ipaddr>: icmp_seq=50 ttl=64 time=77.9 ms
}}}

and then finish with a section that looks like

{{{
--- <ipaddr> ping statistics ---
<count> packets transmitted, <count> received, 0% packet loss, time 5229ms
rtt min/avg/max/mdev = 59.376/70.448/522.011/57.578 ms, pipe 55
}}}

Copy that final block for your results.

== Cleanup ==

No special cleanup is needed.

= !GigaNetcat =

This experiment uses the 'netcat' command to send 1 GB of data via unencrypted TCP.

= !GigaWeb =

This experiment uses the HTTPS protocol to send 1 GB of data via encrypted TCP.

= GigaPerfTCP =

This experiment uses the iperf command to send 1 GB of data via TCP, measuring performance throughout the transfer.

= GigaPerfUDP =

This experiment uses the iperf command to send 1 GB of data via UDP, measuring performance throughout the transfer.