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.

Scope

Architecture

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