debian

This tutorial is build on Debian Buster but you can adapt it for other distributions.

System Configuration

First of all, we have to install several required packages in order to build and to use NEmu. Be aware that name of packages and the installation process can be a bit different on other Linux distributions.

bash~$ su root
root-$ apt-get install git cmake make g++
root-$ apt-get install libboost-system-dev libboost-thread-dev
root-$ apt-get install libboost-chrono-dev libboost-regex-dev
root-$ apt-get install libreadline-dev libcrypto++-dev
root-$ apt-get install libssl-dev libvdeplug-dev
root-$ apt-get install graphviz vde2 sshfs squashfs-tools
root-$ apt-get install qemu qemu-utils python3 python3-psutil
root-$ apt-get install openssh

Getting NEmu

Now, we have to clone NEmu from its repository.

bash~$ git clone https://gitlab.com/v-a/nemu.git

Building NEmu Components

Then, we have to build NEmu components.

bash~$ cd nemu
bash~$ ./init.sh

A file called init.log will be created in order to summarize the result of the init process.

Environment configuration

Finally, we have also to set a shell environment variable called NEMUROOT which targets the NEmu install directory. You can also (or rather should) setup an alias.

bash~$ export NEMUROOT=<path to NEmu directory>
bash~$ alias nemu="$NEMUROOT/nemu.py"

You're now ready to start!

bash~$ nemu
Welcome to the Network Emulator for Mobile Universes [NEmu]
[nemu]~>