summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorEric Multanen <eric.w.multanen@intel.com>2017-08-15 11:23:07 -0700
committerEric Multanen <eric.w.multanen@intel.com>2017-08-15 12:44:59 -0700
commite056249e9c28e76fbda59c8c4130ea96708bdc06 (patch)
tree1678acbb6d4c7a5fcce7d223aba202e8a521ad14
parent558419b5512121172399dcb943ab77386e6d5d33 (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.md36
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.