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:
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.
Prepare: create a new user and log in
Download: wget http://www.di.unipi.it/~augusto/WanderingToken/wt.tgz
Unpack: tar -xzvf wt.tgz
Install libraries:
DSA:
tar -xzvf Crypt-OpenSSL-DSA-0.13.tar.gz
cd Crypt-OpenSSL-DSA-0.13
perl Makefile.PL
make
make test
sudo make install
Time:
tar -xzvf Time-HiRes-1.55.tar.gz
cd Time-HiRes-1.55
perl Makefile.PL
make
make test
sudo make install
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 ...