extras/vagrant/README

   1 INTRO:
   2
   3 This is a vagrant environment for VPP.
   4
   5 VPP currently works under Linux and has support for:
   6
   7 - Ubuntu 16.04 and Centos7.2
   8
   9 The VM builds VPP from source which can be located at /vpp
  10
  11 VM PARTICULARS:
  12 This vagrant environment creates a VM based on environment variables found in ./env.sh
  13 To customize the vm for your use case, edit env.sh then
  14   source ./env.sh
  15   vagrant up
  16
  17 By default, the VM created is/has:
  18 - Ubuntu 16.04
  19 - 2 vCPUs
  20 - 4G of RAM
  21 - 3 NICs (1 x NAT - host access, 2 x VPP DPDK enabled)
  22
  23 PROVIDERS:
  24
  25 Supported vagrant providers are:
  26
  27 - Virtualbox, VMware Fusion/Workstation, Libvirt
  28
  29 ALTERNATE CONFIGURATIONS
  30
  31 The following Vagrantfiles provide alternate configurations for specific testing purposes.  To use them,
  32
  33 1. Copy the desired configuration to Vagrantfile
  34 2. Run "vagrant up"
  35 3. vagrant ssh <vm name>
  36
  37 When testing is complete
  38 4. Run "vagrant destroy" to stop the VM's and delete files.
  39 5. Run "git checkout -- Vagrantfile" to restore the default configuration
  40
  41 Available Vagrantfiles:
  42
  43 Vagrantfile.vcl_test  - Create two vm's for multi-host VppCommLib testing