-
Notifications
You must be signed in to change notification settings - Fork 0
Quick Start Guide
Tuscarora is a framework for developing highly scalable and portable Network Patterns (NP) and applications. The Framework serves as the narrow waist of the system, decoupling the Application Layer and the Network Patterns from the underlying radio and hardware platform, enabling portability, scalability and extensibility. Tuscarora was partly funded by DARPA.
It can used standalone on most compute devices or along with the ns3 network simulator. It is written from scratch in C++, with very little library dependencies. All one needs is a C++ compiler. Please refer to documentation page for more information.
Move the Tuscarora package to a new directory, say ‘C2E’. The release file is a password-protected rar-archive, so you will need the rar package.
$ cd
$ mkdir C2E
$ mv Tuscarora-release-0.x-y.rar C2E
$ sudo apt-get install rar # if not already installed
$ rar x Tuscarora-release-0.x-y.rar
To upgrade from an existing Tuscarora installation following the procedure below.
Before we can install the new version, the ns3/dce patches from previous version should be removed first. To do this:
$ cd Tuscarora/TuscaroraFW
$ ./install.sh -u # [this will remove the patches]
$ ./install.sh
The previous step(s) would have created a Tuscarora directory, this is the root of the framework. Launch the ‘install.sh’ script under Tuscarora root directory. Since the script adds some environment variables, it has to be called within the same shell. Please note the “.” before the command. If not, a new shell should be started after the installation completes in order to set the environment variables.
$ cd TuscaroraFW
$ . ./install.sh
The installation script will ask for your ‘sudo’ password for installing some dependencies. Enter your password. The script will download and install the required ubuntu dependencies first. Next, it will proceed to download and install bake, ns3, and dce from the nsnam repositories. NS3 and dce will be installed under a directory called ‘dce’ under your home directory; let’s call this the $DCE DIR directory. Next the script will make some symbolic links between the Tuscarora source directory and the $DCE DIR. Finally, if all previous steps work fine, it will run some existing modules, and will return the status of execution.
Finally, once the installation finishes, you can validate the installation by running the command “./validate.sh” from the TuscaroraFW directory. This would run a number of predefined tests and would print the result of the tests as FAILED or PASSED on the screen. If any of the tests fail, please contact support. Running the validate script with the ‘-h’ option prints the list of validation tests available.
The ‘orchestrate.sh’ in the root directory is the primary script to execute the modules and tests under framework. The script cleans, builds, runs and collects the output for the 'test-name' speci- fied. Run the script without parameters for information on supported options. Run the script with the test-name and ‘-h’ option to get test-specific help