commit	726a45874fda781f19d1bc1c21b18ba8526e2c19	[log] [tgz]
author	peusterm <manuel.peuster@uni-paderborn.de>	Tue Feb 02 17:07:53 2016 +0100
committer	peusterm <manuel.peuster@uni-paderborn.de>	Tue Feb 02 17:07:53 2016 +0100
tree	d389fb9eee8a9cbb0da202afa476d3202090ca16
parent	dff1667d18cdb86d14ec0296f09ba847a629927c [diff]
parent	7303abc38b4751466953c8db55815c63df6687ac [diff]

Merge pull request #1 from mpeuster/master

Initial emulator code from old private repository.

tree: d389fb9eee8a9cbb0da202afa476d3202090ca16

README.md

Distributed Cloud Emulator

Contributors:

Manuel Peuster manuel.peuster@upb.de

Requirements

needs the latest Dockernet to be installed in the system
the wrapper uses standard Python imports to use the Dockernet modules
Uses ZeroMQ based RPC to open a cloud-like interface that can be used by a demo CLI client
pip install import zerorpc
This will be replaced / extended by a REST API later

Project structure

emuvim/ all emulator code
api/ Data center API endpoint implementations (zerorpc, OpenStack REST, ...)
cli/ CLI client to interact with a running emulator
dcemulator/ Dockernet wrapper that introduces the notion of data centers and API endpoints
test/ Unit tests
example_topology.py An example topology script to show how topologies can be specified

Installation

Automatic installation is provide through an Ansible playbook.

Requires: Ubuntu 14.04 LTS
sudo apt-get install ansible git
sudo vim /etc/ansible/hosts
Add: localhost ansible_connection=local

1. Dockernet

git clone https://github.com/mpeuster/dockernet.git
cd dockernet/ansible
sudo ansible-playbook install.yml
Wait (and have a coffee) ...

2. Emulator

Fork the repository.
cd
git clone https://github.com/<user>/son-emu.git
cd emulator-strawman/ansible
sudo ansible-playbook install.yml

Run

First terminal:
cd emulator-strawman/emuvim
sudo python example_topology.py
Second terminal:
cd emulator-strawman/emuvim/cli
./son-emu-cli compute start -d dc1 -n vnf1
./son-emu-cli compute start -d dc1 -n vnf2
./son-emu-cli compute list
First terminal:
dockernet> vnf1 ping -c 2 vnf2

TODO

DCemulator
Advanced network model
improve network management, multiple interfaces per container
API to create multiple networks (per DC?)
Add resource constraints to datacenters
Check if we can use the Mininet GUI to visualize our DCs?
(Unit tests for zerorpc API endpoint)

Features / Done

Define a topology (Python script)
Add data centers
Add switches and links between the,
Define API endpoints in topology
call startAPI from topology definition and start it in a own thread
make it possible to start different API endpoints for different DCs
DCemulator
correctly start and connect new compute resources at runtime
remove and disconnect compute resources at runtime
do IP management for new containers
list active compute resources
Cloud-like reference API with CLI for demonstrations
Write CLI client
Start compute (name, DC, image, network)
Stop compute
Create an Ansible-based automatic installation routine
Unit tests