VIM emulator: Difference between revisions
From OSM Public Wiki
| Line 12: | Line 12: | ||
* Requires: Ubuntu 16.04 LTS | * Requires: Ubuntu 16.04 LTS | ||
* | * <code>sudo apt-get install ansible git aptitude</code> | ||
==== Step 1: Containernet installation ==== | ==== Step 1: Containernet installation ==== | ||
* | * <code>cd</code> | ||
* | * <code>git clone https://github.com/containernet/containernet.git</code> | ||
* | * <code>cd ~/containernet/ansible</code> | ||
* | * <code>sudo ansible-playbook -i "localhost," -c local install.yml</code> | ||
===== Step 2: vim-emu installation ==== | ===== Step 2: vim-emu installation ==== | ||
* | * <code>cd</code> | ||
* | * <code>git clone https://osm.etsi.org/gerrit/osm/vim-emu.git</code> | ||
* | * <code>cd ~/vim-emu/ansible</code> | ||
* | * <code>sudo ansible-playbook -i "localhost," -c local install.yml</code> | ||
=== Option 2: Nested Docker Deployment === | === Option 2: Nested Docker Deployment === | ||
This option requires a Docker installation on the host machine on which the emulator should be deployed. | This option requires a Docker installation on the host machine on which the emulator should be deployed. | ||
* | * <code>git clone https://osm.etsi.org/gerrit/osm/vim-emu.git</code> | ||
* | * <code>cd ~/vim-emu</code> | ||
* Build the container: | * Build the container: <code>docker build -t vim-emu-img .</code> | ||
* Run the (interactive) container: | * Run the (interactive) container: <code>docker run --name vim-emu -it --rm --privileged --pid='host' -v /var/run/docker.sock:/var/run/docker.sock vim-emu-img /bin/bash</code> | ||
== Usage example == | == Usage example == | ||
== Additional information and links == | == Additional information and links == | ||
Revision as of 11:21, 26 September 2017
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.
Architecture
Installation
Option 1: Bare-metal installation
- Requires: Ubuntu 16.04 LTS
sudo apt-get install ansible git aptitude
Step 1: Containernet installation
cdgit clone https://github.com/containernet/containernet.gitcd ~/containernet/ansiblesudo ansible-playbook -i "localhost," -c local install.yml
= Step 2: vim-emu installation
cdgit clone https://osm.etsi.org/gerrit/osm/vim-emu.gitcd ~/vim-emu/ansiblesudo 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.gitcd ~/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