Hot to install and run the Wandering Token agent.

This is the installation HOWTO for the Wandering Token agent.

In summary, you need to download the package, compile and install two libraries (unless your Linux distribution offers equivalent packages), and launch the local agent. The installation has been tested on Ubuntu (perl-Time-HiRes available), and on SL RedHat (need to recompile perl-Time-HiRes). Reports from other distributions are welcome.

Remember that this is experimental software. It may damage your system in some unexpected way.

This is the roadmap:

  1. Check: check the accessibility of UDP ports. The protocol uses UDP port 9000, UDP ports in the interval 12000-12100, and listens on TCP port 9001. The presence of other services using the same ports must be avoided. The availability of these ports can be checked using nmap (or other common use scanners), or with netcat, preferably from an host outside your domain (you can ask me for support in this). Your host must have a static IP assigned: NAT is not supported.

  2. Prepare: create a new user and log in

  3. Download: wget http://www.di.unipi.it/~augusto/WanderingToken/wt.tgz

  4. Unpack: tar -xzvf wt.tgz

  5. Install libraries:

tar -xzvf Crypt-OpenSSL-DSA-0.13.tar.gz

cd Crypt-OpenSSL-DSA-0.13

perl Makefile.PL

make

make test

sudo make install

tar -xzvf Time-HiRes-1.55.tar.gz

cd Time-HiRes-1.55

perl Makefile.PL

make

make test

sudo make install

  1. Go: ./wt-agent start

The reply should be something of this kind:

Using 192.168.113.4 as initial peer
* restart server...
* restart agent...
using stoken.pm: Revision: 1.31
agent.pl: Revision: 1.7
Agent starting on IP accapi
 using well known port 9000
 with reference peer 192.168.113.4

The name accapi will be replaced with your hostname, 192.168.113.4 with another IP. That's it, finished.

If you want to test your installation, or report a problem:

# tail -f /tmp/agent.log

to see the token exchange protocol working.

Or

# tail -f /tmp/agent.log

to see the database updates. The command:

# ls /tmp/peerdb/*.pub

returns the list of agents in the experiment.

If you want to stop the agent:

# ./wt-agent stop

... and thanks for participating to the experiment ...