| Keith Burns (alagalah) | e0965d4 | 2016-06-19 07:58:51 -0700 | [diff] [blame] | 1 | INTRO: |
| Ed Warnicke | cb9cada | 2015-12-08 15:45:58 -0700 | [diff] [blame] | 2 | |
| Keith Burns (alagalah) | e0965d4 | 2016-06-19 07:58:51 -0700 | [diff] [blame] | 3 | This is a vagrant environment for VPP. |
| Ed Warnicke | cb9cada | 2015-12-08 15:45:58 -0700 | [diff] [blame] | 4 | |
| Keith Burns (alagalah) | e0965d4 | 2016-06-19 07:58:51 -0700 | [diff] [blame] | 5 | VPP currently works under Linux and has support for: |
| Ed Warnicke | b463ec8 | 2015-12-22 20:04:54 -0700 | [diff] [blame] | 6 | |
| Dave Wallace | d4c623e | 2017-09-25 16:12:16 -0400 | [diff] [blame] | 7 | - Ubuntu 16.04 and Centos7.2 |
| Ed Warnicke | b463ec8 | 2015-12-22 20:04:54 -0700 | [diff] [blame] | 8 | |
| Keith Burns (alagalah) | e0965d4 | 2016-06-19 07:58:51 -0700 | [diff] [blame] | 9 | The VM builds VPP from source which can be located at /vpp |
| Ed Warnicke | b463ec8 | 2015-12-22 20:04:54 -0700 | [diff] [blame] | 10 | |
| Keith Burns (alagalah) | e0965d4 | 2016-06-19 07:58:51 -0700 | [diff] [blame] | 11 | VM PARTICULARS: |
| 12 | This vagrant environment creates a VM based on environment variables found in ./env.sh |
| Dave Wallace | d4c623e | 2017-09-25 16:12:16 -0400 | [diff] [blame] | 13 | To customize the vm for your use case, edit env.sh then |
| Keith Burns (alagalah) | e0965d4 | 2016-06-19 07:58:51 -0700 | [diff] [blame] | 14 | source ./env.sh |
| 15 | vagrant up |
| Ed Warnicke | b463ec8 | 2015-12-22 20:04:54 -0700 | [diff] [blame] | 16 | |
| Keith Burns (alagalah) | e0965d4 | 2016-06-19 07:58:51 -0700 | [diff] [blame] | 17 | By default, the VM created is/has: |
| Dave Wallace | d4c623e | 2017-09-25 16:12:16 -0400 | [diff] [blame] | 18 | - Ubuntu 16.04 |
| Keith Burns (alagalah) | e0965d4 | 2016-06-19 07:58:51 -0700 | [diff] [blame] | 19 | - 2 vCPUs |
| Keith Burns (alagalah) | f803564 | 2016-06-25 03:50:28 -0700 | [diff] [blame] | 20 | - 4G of RAM |
| Dave Wallace | d4c623e | 2017-09-25 16:12:16 -0400 | [diff] [blame] | 21 | - 3 NICs (1 x NAT - host access, 2 x VPP DPDK enabled) |
| Ed Warnicke | b463ec8 | 2015-12-22 20:04:54 -0700 | [diff] [blame] | 22 | |
| Keith Burns (alagalah) | e0965d4 | 2016-06-19 07:58:51 -0700 | [diff] [blame] | 23 | PROVIDERS: |
| Ed Warnicke | b463ec8 | 2015-12-22 20:04:54 -0700 | [diff] [blame] | 24 | |
| Keith Burns (alagalah) | e0965d4 | 2016-06-19 07:58:51 -0700 | [diff] [blame] | 25 | Supported vagrant providers are: |
| Ed Warnicke | cb9cada | 2015-12-08 15:45:58 -0700 | [diff] [blame] | 26 | |
| Keith Burns (alagalah) | e0965d4 | 2016-06-19 07:58:51 -0700 | [diff] [blame] | 27 | - Virtualbox, VMware Fusion/Workstation, Libvirt |
| Ed Warnicke | cb9cada | 2015-12-08 15:45:58 -0700 | [diff] [blame] | 28 | |
| Dave Wallace | d4c623e | 2017-09-25 16:12:16 -0400 | [diff] [blame] | 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 |