R+: Remy Performance Improvement + INT Support

Changes

This repo contains a few important changes over baseline Remy:

• The number of configurations used in each training step is increased
• The pacing rate action is a coefficient on the current sending rate, not a constant
• Minor fixes to improve performance on early drop out, scoring, etc.
• INT signals (link util and queue length) added

Example Usage

./remy cf=../configs/config-default of=../results/default-config/int/ sig=dsrqk

Requirements

Packages: cmake make clang protobuf-compiler g++ libboost-all-dev libglfw3-dev libglew-dev libsdl-pango-dev

Also, you may have to set the following environment variable: export AM_LDFLAGS="-pthread -lpthread"

Parameter Changes

• INT signals
  • Several signals are available for configuration in ./remy (sig=dsrqk includes all base E2E signals and link and queue INT (qk))
  • To create new signals, you will likely have to add to link.hh to change/add how signals are calculated (and then appended to the packet)
• Network config
  • The network config is set with cf=. You can create new configs with ./input-configrange
• Utility function
  • The utility function is defined in utility.hh (will require recompilation)

Remy: TCP ex Machina (computer-generated congestion control)

Remy is an optimization tool to develop new TCP congestion-control schemes, given prior knowledge about the network it will encounter and an objective to optimize for.

It is described further at the Web site for TCP ex Machina. A research paper on Remy was published at the ACM SIGCOMM 2013 annual conference.

Basic usage:

• Remy requires a C++11 compiler to compile, e.g. gcc 4.6 or contemporary clang++. You will also need the Google protobuf-compiler and the Boost C++ libraries.

• From the version-control repository checkout, run ./autogen.sh, ./configure, and make to build Remy.

• Run ./remy to design a RemyCC (congestion-control algorithm) for the default scenario, with link speed drawn uniformly between 10 and 20 Mbps, minRTT drawn uniformly between 100 and 200 ms, the maximum degree of multiplexing drawn uniformly between 1 and 32, and each sender "on" for an exponentially-distributed amount of time (mean 5 s) and off for durations drawn from the same distribution.

• Use the of= argument to have Remy save its RemyCCs to disk. It will save every step of the iteration.

• Use the if= argument to get Remy to read previous RemyCCs as the starting point for optimization.

• The sender-runner tool will execute saved RemyCCs. The filename should be set with a if= argument. It also accepts link= to set the link speed (in packets per millisecond), rtt= to set the RTT, and nsrc= to set the maximum degree of multiplexing.

If you have any questions, please visit Remy's Web site or e-mail remy at mit dot edu.

-- Keith Winstein