X-Git-Url: https://osm.etsi.org/gitweb/?a=blobdiff_plain;f=README.md;h=59cd0927bc6e4a75581e3512213e2318fa5bd5ca;hb=45dce6172f28aab5b2c6af52a04e426cf9f18aee;hp=22a94b168309ca0b24a44367f4515b77a0476a80;hpb=293cbc3515b371d2029fdfd624ae6ae38ced77a9;p=osm%2Fvim-emu.git diff --git a/README.md b/README.md index 22a94b1..59cd092 100644 --- a/README.md +++ b/README.md @@ -20,20 +20,49 @@ * **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 +* `cd` +* `git clone https://github.com/mpeuster/emulator-strawman.git` +* `cd emulator-strawman/ansible` +* `sudo ansible-playbook install.yml` + + ### Run * First terminal: + * `cd emulator-strawman/emuvim` * `sudo python example_topology.py` * Second terminal: - * TODO add CLI commands here (e.g. request the start of a new compute resource) + * `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 - * ... -* Write unit tests -* Create an Ansible-based automatic installation routine + * 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 @@ -50,5 +79,7 @@ * list active compute resources * Cloud-like reference API with CLI for demonstrations * Write CLI client - * Start compute + * Start compute (name, DC, image, network) * Stop compute +* Create an Ansible-based automatic installation routine +* Unit tests