CRAWDAD tools/collect/multihop/EXC (v. 2008-09-08)

EXC is a software toolkit to control and steer experiments with wireless multihop networks.EXC is a software toolkit to control and steer experiments with wireless multihop networks. EXC enables researchers to evaluate their algorithms in a real-world environment without having to deal with too much thought on how to coordinate an experiment.Lastmodified :2009-02-12Dataname :tools/collect/multihop/EXCFile :exc_v0.2.tar.gzReleasedate :2008-09-08Equiversion :v0.2Change :the initial version.References :kiess-EXC
README
TutorialWebsite :http://www.crawdad.org/tools/collect/multihop/EXCKeyword :MANET
wireless multihop networksLicense :EXC is released under the GNU General Public License (GPL). It has been
developed at the University Duesseldorf, Germany.Support :EXC is still under development and can be considered as late beta. In case
you encounter bugs, want to participate in the development or have
suggestions for additional features, please contact Wolfgang Kiess:
[e-mail] :EXC requires the following software for running on a Linux operating system:

- ruby: Ruby is the programming language EXC is written in. Your distribution
might come with an installed version. Otherwise please install it manually.
An installation of Ruby is also necessary to execute the install script.

- Click: Click (http://read.cs.ucla.edu/click/) is a software for implementing
router con gurations.

- GTK+: A GUI-Toolkit used for the graphical user interface on the client nodes.

- Qt3: Another GUI-Toolkit used for the user interface on the monitor node.

- Qt4: If the new version of the monitor GUI should be used, an installation of
the Qt4 GUI-Toolkit is necessary.

- qtruby: A language binding to access Qt from ruby.

- sys-proctable: An extension for ruby. It provides extensive process-handling.

The following installation instructions are designed for a normal PC with a
Linux system.

1. Unpack the EXC-tarball:

tar xvzf exc_v0.x.tar.gz

2. Change into the EXC directory and execute the installation file:

ruby ./install.rb

If you are using one of the supported Linux distributions, the installation should
be complete. Otherwise you have to install Qt3, GTK+ and qtruby manually.

If you have troubles installing EXC, please contact the authors of this tutorial
under [[e-mail], [e-mail]].Usage :-- Quick Start --
1) Install the necessary software (see REQUIREMENTS.txt)
2) Adjust the configuration in "scripts/tutorial/monitor.xml"
to your computers' network interface configuration
3) Start EXC as monitor:
ruby Main.rb -monitor scripts/tutorial/monitor.xml

-- Advanced Experiments --
If you want to have several nodes/participants in your experiment, copy the
complete EXC folder to the nodes (and the monitor) and start EXC in 'node' or
'monitor' configuration:
ruby Main.rb <node-configuration>
ruby Main.rb -monitor <node-configuration>

For further information please refer to the EXC tutorial:
documentation/exc_tutorial.pdf
The API-documentation for the different EXC components can be found
in the folder doc.Algorithm :To examine wireless multihop networks in well-defined setups and conduct such
experiments in a systematic way, we use in EXC a semi-automatic control. Each
experiment is partitioned in a number of runs. In a run, all actions of the
nodes like sending certain packets or moving the node are precisely scheduled
based on a prede ned script. After each run, the nodes pause and the person
responsible for controlling the experiment (called operator) remotely queries the
state of the nodes. If errors such as wrong position or a software crash occur, the
operator has the chance to overcome these. Then, he remotely selects and starts
the next run. As most actions can be executed without any interaction from
the users, this increases repeatability and minimizes errors. Those errors that
still occur only corrupt one run, not the whole experiment. Furthermore, the
necessary communication can take place between runs, thus the runs themselves
are una ected.

EXC是一款用于管控无线多跳网络实验的软件工具包。EXC可让研究人员在真实环境中评估自身算法，无需耗费过多精力协调实验流程。
最后修改日期：2009-02-12
数据集名称：tools/collect/multihop/EXC
下载文件：exc_v0.2.tar.gz
发布日期：2008-09-08
版本号：v0.2
更新说明：初始版本。
参考文献：kiess-EXC
自述文件
教程官网：http://www.crawdad.org/tools/collect/multihop/EXC
关键词：MANET（移动自组织网络）
许可协议：EXC采用GNU通用公共许可证（GPL）进行发布，该工具由德国杜塞尔多夫大学开发完成。
支持信息：EXC仍处于开发阶段，可视为后期测试版。若您遇到程序漏洞、希望参与开发或提出新增功能建议，请联系Wolfgang Kiess：[e-mail]。
依赖说明：EXC在Linux操作系统上运行需依赖以下软件：
- Ruby：EXC的开发语言，您的Linux发行版可能已预装该语言。若未预装，请手动安装；执行安装脚本也需Ruby环境。
- Click：Click（http://read.cs.ucla.edu/click/）是一款用于实现路由器配置的软件。
- GTK+：用于客户端节点图形用户界面的GUI工具包。
- Qt3：用于监控节点用户界面的另一款GUI工具包。
- Qt4：若需使用新版监控图形界面，则需安装Qt4 GUI工具包。
- qtruby：用于在Ruby中调用Qt的语言绑定库。
- sys-proctable：Ruby扩展库，提供完善的进程处理功能。
以下安装指南针对搭载Linux系统的普通PC设计：
1. 解压EXC压缩包：
tar xvzf exc_v0.x.tar.gz
2. 进入EXC目录并执行安装脚本：
ruby ./install.rb
若您使用的是受支持的Linux发行版，安装流程即可完成；否则需手动安装Qt3、GTK+及qtruby。
若在安装EXC时遇到问题，请联系本教程的作者：[[e-mail], [e-mail]]。
使用说明：
-- 快速入门 --
1) 安装所需依赖软件（详见REQUIREMENTS.txt）
2) 根据您的计算机网络接口配置，修改"scripts/tutorial/monitor.xml"中的配置项
3) 以监控节点模式启动EXC：ruby Main.rb -monitor scripts/tutorial/monitor.xml
-- 高级实验模式 --
若您的实验需要多个节点/参与设备，请将完整的EXC文件夹复制到各节点（及监控节点），并分别以“节点”或“监控节点”模式启动EXC：
ruby Main.rb <节点配置文件>
ruby Main.rb -monitor <节点配置文件>
更多信息请参阅EXC教程文档：documentation/exc_tutorial.pdf
EXC各组件的API文档可在doc文件夹中获取。
实验机制说明：
为了在标准化部署环境中研究无线多跳网络，并系统化开展相关实验，EXC采用半自动控制机制。每个实验被划分为多个运行回合（run）。在单个运行回合中，节点的所有操作（如发送特定数据包、移动节点等）均基于预定义脚本进行精准调度。每个运行回合结束后，节点将暂停，负责管控实验的人员（称为操作员）可远程查询各节点的运行状态。若出现节点位置错误、软件崩溃等问题，操作员可及时进行修复，随后远程选择并启动下一个运行回合。由于多数操作无需用户手动干预，该机制可提升实验可重复性并最大限度减少错误。即便仍出现错误，也仅会影响单个运行回合，不会波及整个实验。此外，必要的通信可在运行回合间隙完成，因此各运行回合本身不会受到干扰。