Installing DOT

Download DOT and sfslite

The current version of DOT builds against a slightly modified version of sfslite. We're in the middle of upgrading DOT to use the latest sfslite (which has slightly different syntax and all of our changes), but for now, you'll be happier using this one:

• dot-0.2.tar.gz
• sfslite-dot-0.2.tar.gz

Install Required Software to Build

• gmp - the gnu multiple precision library
• Berkeley DB4 and the C++ bindings for it

Compile sfslite

• cd sfslite-dot-0.2; ./configure; make

Compile DOT

• See the README in the top level source directory
• ./configure --with-sfs=/path/to/your/sfslite/tree
• make
• ./test/dot-test.rb

Notes for compiling on specific operating systems can be found in the README.

Use DOT

First, start gtcd on the machines you want to use DOT on:

• gtcd -f /path/to/srcdir/test/gcp_test.conf

Then try using the gcp program to copy from one machine to another.

• gcp file dst

GCP arguments look like scp or rsync's. It can copy directories recursively, though this functionality is still under pretty heavy development and the syntax and semantics may change rapidly.

The .conf file tells DOT how to chain plugins together. The simplest test file doesn't use SET; more extensive examples can be found in the test/ directory. One of the best, most stable configurations is the one used in dot-test.rb -- take a peek inside at the configurations specified in there.

Use SET

• Run gtcd with a SET-enabled conf file
• On the sender, become a seed by putting the file into DOT:
  gcp -P file
• Remember the OID that gcp prints out.
• Tell receivers the OID, and have them initiate a download by:
  gcp dot://OID:srchost:srcport:1 ./filename_out
• The srchost and srcport must be the real-world IP of the source machine. The port is, by default, 12000.

FAQ

Still under construction, but...

Hack DOT

In order to hack on DOT, you'll probably want to install more build tools:

• autoconf, automake, libtool

Contact

DOT is very under-development. If you have problems, you can contact us at dot-pub AT emulab DOT net.

License

DOT itself is released under the Eclipse Public License, but from a practical standpoint, it needs to be compiled against sfslite, which is licensed under the GPL. If you'd like a difference license, we're all ears -- our goal is to make DOT as easily usable as possible.