VIM emulator

Vim-emu: A NFV multi-PoP emulation platform

This emulation platform was created to support network service developers to locally prototype and test their network services in realistic end-to-end multi-PoP scenarios. It allows the execution of real network functions, packaged as Docker containers, in emulated network topologies running locally on the developer's machine. The emulation platform also offers OpenStack-like APIs for each emulated PoP so that it can integrate with MANO solutions, like OSM. The core of the emulation platform is based on Containernet.

The emulation platform vim-emu is developed as part of OSM's DevOps MDG.

Installation

Option 1: Bare-metal installation

• Requires: Ubuntu 16.04 LTS
• `sudo apt-get install ansible git aptitude`

Step 1: Containernet installation

• `cd`
• `git clone https://github.com/containernet/containernet.git`
• `cd ~/containernet/ansible`
• `sudo ansible-playbook -i "localhost," -c local install.yml`

= Step 2: vim-emu installation

• `cd`
• `git clone https://osm.etsi.org/gerrit/osm/vim-emu.git`
• `cd ~/vim-emu/ansible`
• `sudo ansible-playbook -i "localhost," -c local install.yml`

Option 2: Nested Docker Deployment

This option requires a Docker installation on the host machine on which the emulator should be deployed.

• `git clone https://osm.etsi.org/gerrit/osm/vim-emu.git`
• `cd ~/vim-emu`
• Build the container: `docker build -t vim-emu-img .`
• Run the (interactive) container: `docker run --name vim-emu -it --rm --privileged --pid='host' -v /var/run/docker.sock:/var/run/docker.sock vim-emu-img /bin/bash`