HowTo: Quick start guide

---

  ______ ___    ____  ______
 /_  __//   |  / __ \/ ____/ [T]estbed for
  / /  / /| | / /_/ / __/    [A]d-Hoc
 / /  / ___ |/ ____/ /___    [P]rotocol
/_/  /_/  |_/_/   /_____/    [E]valuation

---

Quick start guide for performing testruns with the APE testbed

Download and Install:

ISO version

1. Go to https://sourceforge.net/projects/tape/files/
2. Download tape-0.65.iso
3. Burn to disc as image
4. Insert to dvd-drive, reboot
5. In boot menu (GRUB Legacy/LILO) select boot from dvd-drive
6. TAPE Login screen

INSTALL Version

1. Go to https://sourceforge.net/projects/tape/files/
2. Download tape-0.65.zip
3. Unzip the file.
4. Sudo, and mv the TAPE to /
5. Cd to TAPE, and enter ./install-linux.sh
6. reboot, and select TAPE from GRUB/LILO menu

TAPE-Source Code

1. git clone git://git.code.sf.net/p/tape/code tape-code
2. cd tape-code directory
3. run 'make' for Install version or 'make bootcd' for ISO version.
4. Follow above instruction depend on the version (INSTALL/ISO)

note: For install version, only GRUB legacy and LILO are
supported for now.

Requirements:

Participant nodes:

Hardware: i386 compatible computers (preferably laptops) equipped with wireless.
OS: Linux or anything that support boot from ISO.
Software: A TAPE distribution.

Collect node:

This computer will receive log-files
from client machines using scp (secure copy).

Hardware: i386 compatible computers (preferably a laptop) equipped with wireless,
running in ad hoc mode with same network configuration as participant nodes.
OS: Linux
Software: configured to run in ad hoc mode, with same network configuration as
participant nodes. Default network setup in TAPE is 192.168.5.0/24 and default IP
is 192.168.5.101, this information can be change in dist/ape.conf/ape.conf.

Computer to build the TAPE distribution on:

Linux machine to compile the TAPE sources on. You need root-access only to copy
to root directory on this machine for the install version. Recommended setup is
Intel based machine running a recent version of Red Hat Linux/ Fedora.

Pre testrun setup:

1. Make sure you have read the REQUIREMENTS.

2. Create custom scenario files (see separate documentation on this step), or use the bundled ones. Check the configuration file in dist/ape.conf/ape.conf to customize the hardware information such as interface, log path and etc.

3. Compile the TAPE sources (see README) and make sure you have a binary distribution package named ape-<version>-<date>.zip or a bootable CD iso image.</date></version>

4. Distribute the newly built APE testbed distribution to the client machines participating in the test. Client machines must run Linux or support boot from ISO.

5. For install version, the TAPE/ move to /, and install the TAPE on the client machines by run ./install-linux.sh. For ISO version, just make sure the machines booted from ISO image.

Run test:

1. Launch the TAPE. In Linux, reboot and choose TAPE at the boot loader prompt.
   If you use a bootable CD, make sure the computer's BIOS is set to boot from
   CD-ROM. Insert the TAPE CD and reboot.

2. When the TAPE, login as 'root', without giving a password, if you were not
   already logged in.

3. Run the 'start_test' script and follow the on-screen instructions.
   > ./start_test (wireless)
   > ./start_test_cable (wire)

4. At the scenario selection, choose the scenario to run.

5. Next, give the client machines unique node numbers as defined by
   the selected scenario.
6. At the routing daemon selection, choose which daemon to run.
7. Then, follow the rest instruction on screen.

note: if error regarding interfaces, please check the /etc/ape.conf/ape.conf and replace the define interface (eg: wlan0) to correct interface.

The machine will now go into a setup phase, where the network is initialized,
the TSB (time stamp broadcaster) is started and all necessary parameters are set up (view the start_test/_cable (script for details). If the scenario use MAC address filtering function, the screen will halt and wait until all nodes are ready, then press enter to let the nodes retrieve each other MAC address. Then wait for all nodes to ready and halt, press last 'Enter' before the test is started.

1. Position the nodes together, preferably within radio range. The scenarios usually include time for initial positioning, if the scenario starts with nodes spread out.

2. Start the test: the test run is synchronized from one machine. Therefore it is only necessary to press enter on one of the nodes.

Upload log files:

1. Gather all nodes in reach of the 'collect node', to where all log files should be uploaded. The client machines should run 'upload.sh' to initiate the upload. This procedure may fail if the 'collect node' is heavy loaded or not properly configured. Logs are stored in /var/log/, but are copied to the partition of the host OS at the end of each testrun (/initrd/mnt/TAPE/logs/).

2. To upload use ./upload <mode>
   mode: ad-hoc /cable.</mode>

Perform analysis

1. Transfer the log files to the computer where the analysis will be performed.

2. Unpack the logfiles (they are gzip-compressed as default). and analysis the result.