------------ |NANO Agent| ------------ 02/27/2009: Version 1.0 Pre-Alpha Release NANO Agent is part of the Network Neutrality Access Observatory (NANO) project at Georgia Tech. http://www.gtnoise.net/nano In this article you will find steps for installing and running nano-agent. It has following sections. 1 Before Install 2 Compiling and Installing NANO Agent 3 Running NANO Agent 4 Operation of NANO Agent 5 Compilation Problems and Error 1 Before Install ================== NANO requires following libraries, some of which may not already be installed on your machine. libpcap-dev libboost-thread-dev libssl-dev You can install these using apt-get on Ubuntu or similar systems with apt utilities. apt-get install libpcap-dev apt-get install libboost-thread-dev apt-get install libssl-dev In addition, NANO requires following libraries Please be sure to use ./configure --prefix=/usr for above three libraries. If you install these libraries in non-standard directories, e.g., by using --prefix flag with configure, please make sure that the directories are added to appropriate environment variables. 2 Compiling and Installing NANO Agent ==================== Download the NANO agent source and unzip it. user$ tar -xjvf gtnoise-nano-agent-release.tar.bz2 user$ cd gtnoise-nano-agent-release user$ ./configure user$ make user$ make install If all goes well, this is compile and install the NANO-Agent on your machine. If there are compilation errors, please make sure that you have all the required libraries. If that does not resolve the problem, please contact the development team at nano-help@gtnoise.net or send a message to nano-users@gtnoise.net For some known potential issues and their solutions, see section on Errors below. 3 Running NANO Agent* ================== user$ nano-agent-setup.sh The setup script will ask a number of questions to get information on the type of network connectivity, etc. This information will be reported back to the NANO server. We also ask for an email address to create a user string so that we can provide summaries about network performance to the users on our web page and also to notify users of any updates to the agent software. We promise to not use it for any other purpose. 4 Operation of NANO Agent ======================= Please consult README file in the distribution. * Note: if you provided a specific directory using --prefix option to configure, that is not in the PATH environment variable, then you would need to either add that directory to the PATH, or run nano-agent-setup.sh from that bin directory within that directory. 5 Compilation Problems and Error =============================== If you get the following error, it is likely because of mismatch of protocol buffer file versions. conn-stats.pb.h:16:2: #error This file was generated by an older version of protoc which is conn-stats.pb.h:17:2: #error incompatible with your Protocol Buffer headers. Please conn-stats.pb.h:18:2: #error regenerate this file with a newer version of protoc. To address the problem, do the following. user$ cd src user$ protoc --cpp_out=. conn-stats.proto user$ make user$ make install