diff options
author | Eric Multanen <eric.w.multanen@intel.com> | 2017-08-15 11:23:07 -0700 |
---|---|---|
committer | Eric Multanen <eric.w.multanen@intel.com> | 2017-08-15 12:44:59 -0700 |
commit | e056249e9c28e76fbda59c8c4130ea96708bdc06 (patch) | |
tree | 1678acbb6d4c7a5fcce7d223aba202e8a521ad14 | |
parent | 558419b5512121172399dcb943ab77386e6d5d33 (diff) |
Add known issue section to vagrant-onap docs
Document known issues when the Virtualbox vagrant-vbguest plugin
is installed on the host system. Provide a workaround.
Issue-Id: INT-98
Change-Id: I74aecd464cb560ba247cc052d92ebd6957f1a46e
Signed-off-by: Eric Multanen <eric.w.multanen@intel.com>
-rw-r--r-- | bootstrap/vagrant-onap/README.md | 36 |
1 files changed, 36 insertions, 0 deletions
diff --git a/bootstrap/vagrant-onap/README.md b/bootstrap/vagrant-onap/README.md index 00a8a2ac7..05f8cda4a 100644 --- a/bootstrap/vagrant-onap/README.md +++ b/bootstrap/vagrant-onap/README.md @@ -71,6 +71,42 @@ This results in the creation of a new *doc/build/html* folder with the documentation converted in HTML pages that can be viewed through the prefered Web Browser. +#### Known Issues + +##### Virtualbox guest additions conflict with shared directories + +If the vagrant-vbguest plugin is installed on the host, then +an updated version of the Virtualbox guest additions will be installed +on the guest in the /opt directory. Once this projects +Vagrantfile mounts the ./opt directory on the host to the /opt +directory on the guest during the provisioning process, the +guest addtions on the guest are hidden and subsequent +mounts of shared directories with the host will fail. + +The simplest workaround appears to be uninstalling the +vagrant-vbguest plugin on the host system. This has been +observed to work on a Windows 10 host using virtualbox 5.1.26. + +Check if vagrant-vbguest plugin is installed + +Linux or Mac + + $ vagrant plugin list + +Windows + + C:\> vagrant plugin list + +Remove vagrant-vbguest plugin + +Linux or Mac + + $ vagrant plugin uninstall vagrant-vbguest + +Windows + + C:\> vagrant plugin uninstall vagrant-vbguest + ## Contributing Bug reports and patches are most welcome. |