Merge "BUG-6070 dpid changes as ports added to bridge"
[netvirt.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
8 # Usage
9
10 Vagrant is a tool for creating development/test environments.
11 The environment created for this project is as follows:
12
13 1 x DevStack Control/Compute VM
14 1-3 x DevStack Compute VM
15 1 x Mininet VM
16
17 It's assumed you already have an OVSDB development environment set up.
18
19 1. Run `mvn clean install`
20 2. Run `vagrant up`
21 3. Start the controller (in distirbution/target/opendaylight/...)
22
23 > Note: It's assumed that the subnet 192.168.50.x/24 is not in use
24 > Your PC is 192.168.50.1. If you would like to change the addressing,
25 > you will need to edit the Vagrantfile and hosts.json
26
27 Follow the instructions below for Devstack and Mininet
28
29 ## DevStack VMs
30
31 There are two DevStack VMs. One combined control/compute node and a variable number of dedicated compute nodes.
32 The following steps are performed when the VM is created or when `vagrant provision` is run.
33
34 - Check dependencies are installed
35 - Clone the devstack repository to `devstack`
36 - Generate a `local.conf` file
37
38 To start DevStack
39
40     vagrant ssh devstack-control
41     # or vagrant ssh devstack-compute
42     cd devstack
43     ./stack.sh
44
45 > Note: To start more than one compute node
46 >       export DEVSTACK_NUM_COMPUTE_NODES=3
47 >       vagrant up
48
49 ## Mininet
50
51 There is a single VM provided for running mininet.
52 This is for testing that does not require OpenStack Neutron.
53
54 The following steps are performed when the VM is created or when `vagrant provision` is run.
55 - Check dependencies are installed
56 - Clone the mininet repository
57 - Install mininet and Open vSwitch
58
59 To start Mininet
60
61     vagrant ssh mininet
62     sudo mn
63
64 # Port Forwarding
65
66 The following ports are forwarded:
67
68 localhost:8080 -> opendaylight:8080
69 localhost:8000 -> opendaylight:8000
70 localhost:8081 -> devstack-control:8080