From: Eric Multanen Date: Tue, 15 Aug 2017 18:23:07 +0000 (-0700) Subject: Add known issue section to vagrant-onap docs X-Git-Tag: 1.0.0-Amsterdam~429 X-Git-Url: https://gerrit.onap.org/r/gitweb?a=commitdiff_plain;h=e056249e9c28e76fbda59c8c4130ea96708bdc06;p=integration.git 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 --- 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.