You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Russell Bryant ac226200ab
Remove DHCP and L3 agent remnants.
6 years ago
provisioning Remove DHCP and L3 agent remnants. 6 years ago
README.rst Vagrant: Add support for running a HW VTEP node 7 years ago
Vagrantfile Fix provider configuration in Vagrant file 7 years ago


Automatic deployment using Vagrant and VirtualBox

The Vagrant scripts deploy OpenStack with Open Virtual Network (OVN) using four nodes to implement a minimal variant of the reference architecture:

  1. Database node containing the OVN northbound (NB) and southbound (SB) databases via the Open vSwitch (OVS) database and ovn-northd services.
  2. Controller node containing the Identity service, Image service, control plane portion of the Compute service, control plane portion of the Networking service including the networking-ovn ML2 driver, and the dashboard. In addition, the controller node is configured as an NFS server to support instance live migration between the two compute nodes.
  3. Two compute nodes containing the Compute hypervisor, ovn-controller service for OVN, DHCP and metadata agents for the Networking service, OVS services. In addition, the compute nodes are configured as NFS clients to support instance live migration between them.
  4. Optionally a node to run the HW VTEP simulator. This node is not started by default but can be started by running "vagrant up ovn-vtep" after doing a normal "vagrant up".

During deployment, Vagrant creates three VirtualBox networks:

  1. Vagrant management network for deployment and VM access to external networks such as the Internet. Becomes the VM eth0 network interface.
  2. OpenStack management network for the OpenStack control plane, OVN control plane, and OVN overlay networks. Becomes the VM eth1 network interface.
  3. OVN provider network that connects OpenStack instances to external networks such as the Internet. Becomes the VM eth2 network interface.


The default configuration requires approximately 12 GB of RAM and supports launching approximately four OpenStack instances using the m1.tiny flavor. You can change the amount of resources for each VM in the virtualbox.conf.yml file.


  1. Install VirtualBox and Vagrant.

  2. Clone the networking-ovn repository into your home directory and change to the vagrant directory:

    $ git clone
    $ cd networking-ovn/vagrant
  3. Install plug-ins for Vagrant:

    $ vagrant plugin install vagrant-cachier
    $ vagrant plugin install vagrant-vbguest
  4. If necessary, adjust any configuration in the virtualbox.conf.yml file.

    • If you change any IP addresses or networks, avoid conflicts with the host.

    • For evaluating large MTUs, adjust the mtu option. You must also change the MTU on the equivalent vboxnet interfaces on the host to the same value after Vagrant creates them. For example:

      # ip link set dev vboxnet0 mtu 9000
      # ip link set dev vboxnet1 mtu 9000
  5. Launch the VMs and grab some coffee:

    $ vagrant up
  6. After the process completes, you can use the vagrant status command to determine the VM status:

    $ vagrant status
    Current machine states:
    ovn-db                    running (virtualbox)
    ovn-controller            running (virtualbox)
    ovn-vtep                  running (virtualbox)
    ovn-compute1              running (virtualbox)
    ovn-compute2              running (virtualbox)
  7. You can access the VMs using the following commands:

    $ vagrant ssh ovn-db
    $ vagrant ssh ovn-controller
    $ vagrant ssh ovn-vtep
    $ vagrant ssh ovn-compute1
    $ vagrant ssh ovn-compute2
    Note: If you prefer to use the VM console, the password for the root

    account is vagrant. Since ovn-controller is set as the primary in the Vagrantfile, the command vagrant ssh (without specifying the name) will connect ssh to that virtual machine.

  8. Access OpenStack services via command-line tools on the ovn-controller node or via the dashboard from the host by pointing a web browser at the IP address of the ovn-controller node.

    Note: By default, OpenStack includes two accounts: admin and demo,

    both using password password.

  9. On Linux hosts, you can enable instances to access external networks such as the Internet by enabling IP forwarding and configuring SNAT from the IP address range of the provider network interface (typically vboxnet1) on the host to the external network interface on the host. For example, if the eth0 network interface on the host provides external network connectivity:

    # sysctl -w net.ipv4.ip_forward=1
    # sysctl -p
    # iptables -t nat -A POSTROUTING -s -o eth0 -j MASQUERADE

    Note: These commands do not persist after rebooting the host.

  10. After completing your tasks, you can destroy the VMs:

    $ vagrant destroy