|
|
|
|
|
# Table of Contents
|
|
|
|
|
|
1. [Foreword](#org1b7782d)
|
|
|
2. [Glossary](#org4516c20)
|
|
|
3. [Preliminary notes](#org66d0166)
|
|
|
4. [The steps to run CUSCUS](#org18f076e)
|
|
|
1. [Step zero - Gitpull the project somewhere](#orgfc970dc)
|
|
|
2. [First Step - Set up a virtual machine with Ubuntu 14.04.3 (or do it with a real machine)](#org6541091)
|
|
|
3. [Second Step - Install NS-3 (following the NS-3 site instructions)](#org493e414)
|
|
|
4. [Third Step - Install FL-AIR (following the FL-AIR site instructions)](#orge4d57bb)
|
|
|
1. [Extra - Make sure that](#orgafdd5dd)
|
|
|
5. [Fourth Step](#org6af66b0)
|
|
|
1. [Foreword](#orgd07cf56)
|
|
|
2. [Glossary](#org4760241)
|
|
|
3. [Preliminary notes](#org0cef346)
|
|
|
4. [The steps to run CUSCUS](#org00826e1)
|
|
|
1. [Step zero - Gitpull the project somewhere](#orgc4c87ce)
|
|
|
2. [First Step - Set up a virtual machine with Ubuntu 14.04.3 (or do it with a real machine)](#org6527196)
|
|
|
3. [Second Step - Install NS-3 (following the NS-3 site instructions)](#org8ab772a)
|
|
|
4. [Third Step - Install FL-AIR (following the FL-AIR site instructions)](#org00880fe)
|
|
|
1. [Extra - Make sure that](#org0eb1ae8)
|
|
|
5. [Fourth Step](#orge8061b3)
|
|
|
|
|
|
|
|
|
|
|
|
<a id="org1b7782d"></a>
|
|
|
<a id="orgd07cf56"></a>
|
|
|
|
|
|
# Foreword
|
|
|
|
... | ... | @@ -25,7 +25,7 @@ are our *experiences*. |
|
|
If you find a workaround, some new insights, etc…please let us know.
|
|
|
|
|
|
|
|
|
<a id="org4516c20"></a>
|
|
|
<a id="org4760241"></a>
|
|
|
|
|
|
# Glossary
|
|
|
|
... | ... | @@ -34,7 +34,7 @@ If you find a workaround, some new insights, etc…please let us know. |
|
|
- **`$CUSCUS/`:** the place where you gitpulled *CUSCUS*
|
|
|
|
|
|
|
|
|
<a id="org66d0166"></a>
|
|
|
<a id="org0cef346"></a>
|
|
|
|
|
|
# Preliminary notes
|
|
|
|
... | ... | @@ -45,19 +45,19 @@ If you find a workaround, some new insights, etc…please let us know. |
|
|
**USE** `/bin/bash`. Other shells do not work for the FLAIR framework. Save the hassle and use bash temporarely.
|
|
|
|
|
|
|
|
|
<a id="org18f076e"></a>
|
|
|
<a id="org00826e1"></a>
|
|
|
|
|
|
# The steps to run CUSCUS
|
|
|
|
|
|
|
|
|
<a id="orgfc970dc"></a>
|
|
|
<a id="orgc4c87ce"></a>
|
|
|
|
|
|
## Step zero - Gitpull the project somewhere
|
|
|
|
|
|
- `git pull https://gitlab.utc.fr/zemanico/CUSCUS.git`
|
|
|
|
|
|
|
|
|
<a id="org6541091"></a>
|
|
|
<a id="org6527196"></a>
|
|
|
|
|
|
## First Step - Set up a virtual machine with Ubuntu 14.04.3 (or do it with a real machine)
|
|
|
|
... | ... | @@ -65,17 +65,17 @@ A kind suggestion: use [Vagrant](https://www.vagrantup.com/) to easily set up yo |
|
|
|
|
|
We used this [box](https://app.vagrantup.com/ubuntu/boxes/trusty64).
|
|
|
|
|
|
It takes up a lot of space, please reserve at least `30GB`.
|
|
|
CUSCUS can take up a lot of space, please reserve at least `30GB` for an initial install.
|
|
|
|
|
|
|
|
|
<a id="org493e414"></a>
|
|
|
<a id="org8ab772a"></a>
|
|
|
|
|
|
## Second Step - Install [NS-3](https://www.nsnam.org) (following the NS-3 site instructions)
|
|
|
|
|
|
This [tutorial](https://www.nsnam.org/docs/tutorial/html/getting-started.html)
|
|
|
is enough to get NS3 up and running.
|
|
|
|
|
|
1. install "vtun" and "lxc" packages ( I installedd all the suggested packages)
|
|
|
1. install `vtun` and `lxc` packages (I installed also all the suggested packages)
|
|
|
- `sudo apt-get install vtun lxc`
|
|
|
|
|
|
2. Better safe than sorry:
|
... | ... | @@ -83,12 +83,12 @@ is enough to get NS3 up and running. |
|
|
|
|
|
3. Please follow:
|
|
|
- <https://askubuntu.com/questions/466651/how-do-i-use-the-latest-gcc-on-ubuntu?answertab=votes#tab-top>
|
|
|
- REASON: ns3>2.27 NEEDS gcc4.9 and 14.04 has only 4.8
|
|
|
- REASON: ns3>2.27 NEEDS `gcc4.9` and 14.04 has only 4.8
|
|
|
- I had already enough headaches to make it running this way.
|
|
|
The other way around (use a more modern distro) collided with
|
|
|
the Flair toolchain (that I cannot easily modify)
|
|
|
|
|
|
4. Install NS-3 as per [tutorial](https://www.nsnam.org/docs/tutorial/html/getting-started.html).
|
|
|
4. Install NS-3 as per [tutorial](https://www.nsnam.org/docs/tutorial/html/getting-started.html) wherever you like.
|
|
|
- Configure NS-3 with waf: `--enable-sudo --enable-tests --enable-examples`
|
|
|
- To save time, do it *before* running waf in the tutorial.
|
|
|
- Save your ns3 main path as `$NS3_MAIN_PATH`
|
... | ... | @@ -104,14 +104,14 @@ is enough to get NS3 up and running. |
|
|
- Copy the files `$CUSCUS/mods/ns3-src/src/buildings/model/hybrid-raylight-buildings-propagation-loss-model.cc & .h` into the directory `$NS3_MAIN_PATH/src/buildings/model/`
|
|
|
- Modify the text file `NS3_MAIN_PATH/src/buildings/wscript`, as before, in order to include the new files.
|
|
|
|
|
|
6. install the start scratch (dont' ask why we didn't setup a proper application model, we'll do that later, with all bells and whistles):
|
|
|
6. install the main cuscus runtime in the `scratch` folder of NS3 (dont' ask why we didn't setup a proper application model, we'll do that later, with all bells and whistles):
|
|
|
- Copy the file `$CUSCUS/mods/ns3-src/scratch/uavConnectedSimBuildingRaylight.cc` in the directory `$NS3_MAIN_PATH/scratch/`
|
|
|
|
|
|
7. Re-compile ns-3 with waf
|
|
|
8. The ns-3 simulator <del>should be</del> is ready
|
|
|
|
|
|
|
|
|
<a id="orge4d57bb"></a>
|
|
|
<a id="org00880fe"></a>
|
|
|
|
|
|
## Third Step - Install [FL-AIR](https://www.hds.utc.fr/heudiasyc/production/logiciels-970/logiciels-971/article/fl-air-framework-libre-air-3123?lang=fr) (following the FL-AIR site instructions)
|
|
|
|
... | ... | @@ -119,7 +119,7 @@ Plase feel free to use the documentation for installation available [here](https |
|
|
|
|
|
Just make sure that you also complete all the substeps in this section:
|
|
|
|
|
|
- set up the $FLAIR<sub>ROOT</sub> envoronment variable as described [here](https://devel.hds.utc.fr/software/flair/wiki/setup).
|
|
|
- set up the `$FLAIR_ROOT` environment variable as described [here](https://devel.hds.utc.fr/software/flair/wiki/setup).
|
|
|
- install the [toolchains](https://devel.hds.utc.fr/software/flair/wiki/toolchain/install) (stick to the `x86_64` one)
|
|
|
- Copy the interesting parts of `/root/.bashrc` to `/home/<username>/.bashrc`
|
|
|
- check the graphic card driver ([TODO](https://devel.hds.utc.fr/software/flair/wiki/toolchain/install))
|
... | ... | @@ -136,7 +136,7 @@ Just make sure that you also complete all the substeps in this section: |
|
|
- It should be ok to run now.
|
|
|
|
|
|
|
|
|
<a id="orgafdd5dd"></a>
|
|
|
<a id="org0eb1ae8"></a>
|
|
|
|
|
|
### Extra - Make sure that
|
|
|
|
... | ... | @@ -144,7 +144,7 @@ Just make sure that you also complete all the substeps in this section: |
|
|
- Modify `$CUSCUS/mods/scripts/parametersCUSCUS.dat` accordingly
|
|
|
|
|
|
|
|
|
<a id="org6af66b0"></a>
|
|
|
<a id="orge8061b3"></a>
|
|
|
|
|
|
## Fourth Step
|
|
|
|
... | ... | |