aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
blob: c0fef87a3e67b6d14c03b77478eeefdf77cb4dd4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
vICN
=========

Description
-------------

This application is an ICN experimental testbed orchestrator. It allows to
quickly deploy experiments in a cluster using linux containers, IP tunnels and
linux kernel tools.

This tool provides the following features:

- Physical topology deployment
- Virtual topology deployment
- ICN Network setup
- Management tools

The architecture of this orchestrator is basically a master-slave architecture.
The master, vICN, controls the whole cluster of servers, by means of HTTPS REST
APIs and remote SSH.


Dependencies
-------------

vICN requires a version of Python >= 3.5, and has the following dependendies.
We refer to them using the name of debian/ubuntu packages:

- python3 (>= 3.5)
- libssl-dev
- python3-pip
- python3-daemon

Installation on Ubuntu
-------------

Download vICN by cloning the git repositoy.

    git clone -b vicn/master https://gerrit.fd.io/r/cicn vicn

If you plan to use vICN with Linux Containers, get the latest version of lxd from the LXD ppa:

   sudo add-apt-repository ppa:ubuntu-lxc/lxd-stable
   sudo apt-get update

Install the dependencies. Beware to install the daemon module of python through repositories as the pip version is broken.

    sudo apt-get install python3-pip libssl-dev python3-daemon

You can now install vICN:

    cd vicn
    sudo ./setup.py install

Getting started
--------------

You can have a look at the tutorials available in the fd.io wiki:

Gettting started:
  https://wiki.fd.io/view/Vicn

Setup a Dumbbell topology using vICN:
  https://wiki.fd.io/view/Setup_a_Dumbbell_topology_using_vICN