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>

diff --git a/bootstrap/vagrant-onap/README.md b/bootstrap/vagrant-onap/README.md
index 00a8a2a..05f8cda 100644 (file)
--- 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.