Utility method in net-virt-providers to set a NSP match.
[ovsdb.git] / README.Vagrant
1 ODL OVSDB Vagrant
2 =================
3
4 # Installation
5
6 You can download an install for your system from [here](http://www.vagrantup.com/downloads.html)
7 Vagrant can also be installed using RubyGems
8
9     gem install vagrant
10
11 # Usage
12
13 Vagrant is a tool for creating development/test environments.
14 The environment created for this project is as follows:
15
16 1 x DevStack Control/Compute VM
17 1 x DevStack Compute VM
18 1 x Mininet VM
19
20 It's assumed you already have an OVSDB development environment set up.
21
22 1. Run `mvn clean install`
23 2. Run `vagrant up`
24 3. Start the controller (in distirbution/target/opendaylight/...)
25
26 > Note: It's assumed that the subnet 192.168.50.x/24 is not in use
27 > Your PC is 192.168.50.1. If you would like to change the addressing,
28 > you will need to edit the Vagrantfile and hosts.json
29
30 Follow the instructions below for Devstack and Mininet
31
32 ## DevStack VMs
33
34 There are two DevStack VMs. One combined control/compute node and one dedicated compute node.
35 The following steps are performed when the VM is created or when `vagrant provision` is run.
36
37 - Check dependencies are installed
38 - Clone the devstack repository to `devstack`
39 - Generate a `local.conf` file
40
41 To start DevStack
42
43     vagrant ssh devstack-control
44     # or vagrant ssh devstack-compute
45     cd devstack
46     ./stack.sh
47
48 ## Mininet
49
50 There is a single VM provided for running mininet.
51 This is for testing that does not require OpenStack Neutron.
52
53 The following steps are performed when the VM is created or when `vagrant provision` is run.
54 - Check dependencies are installed
55 - Clone the mininet repository
56 - Install mininet and Open vSwitch
57
58 To start Mininet
59
60     vagrant ssh mininet
61     sudo mn
62
63 # Port Forwarding
64
65 The following ports are forwarded:
66
67 localhost:8080 -> opendaylight:8080
68 localhost:8000 -> opendaylight:8000
69 localhost:8081 -> devstack-control:8080