From e056249e9c28e76fbda59c8c4130ea96708bdc06 Mon Sep 17 00:00:00 2001 From: Eric Multanen Date: Tue, 15 Aug 2017 11:23:07 -0700 Subject: 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 --- bootstrap/vagrant-onap/README.md | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) (limited to 'bootstrap') 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. -- cgit 1.2.3-korg