summaryrefslogtreecommitdiffstats
path: root/bootstrap/vagrant-onap/doc/source
diff options
context:
space:
mode:
authorVictor Morales <victor.morales@intel.com>2017-08-15 17:54:14 -0500
committerVictor Morales <victor.morales@intel.com>2017-08-15 17:54:14 -0500
commitd4036482535db1d1fc28c88960c8b05233543ace (patch)
tree50f5ac8ce7e3d0a8292ef69b783829c5cf5b7433 /bootstrap/vagrant-onap/doc/source
parente056249e9c28e76fbda59c8c4130ea96708bdc06 (diff)
Move Known Issues section to docs folder
The known issues section should be placed in its own file for future additions. It was also included a validation that prevents the auto update feature of vagrant-vbguest plugin. Change-Id: Ibdbd89c15b657b11b346c2cbcc084176f82d8102 Signed-off-by: Victor Morales <victor.morales@intel.com> Issue-Id: INT-98
Diffstat (limited to 'bootstrap/vagrant-onap/doc/source')
-rw-r--r--bootstrap/vagrant-onap/doc/source/index.rst1
-rw-r--r--bootstrap/vagrant-onap/doc/source/install/known_issues.rst50
2 files changed, 51 insertions, 0 deletions
diff --git a/bootstrap/vagrant-onap/doc/source/index.rst b/bootstrap/vagrant-onap/doc/source/index.rst
index 2daccedda..af5777ccd 100644
--- a/bootstrap/vagrant-onap/doc/source/index.rst
+++ b/bootstrap/vagrant-onap/doc/source/index.rst
@@ -18,5 +18,6 @@ Table of contents
:maxdepth: 2
Installation Guide <install/index>
+ Known Issues <install/known_issues>
Advanced Features <features/features>
diff --git a/bootstrap/vagrant-onap/doc/source/install/known_issues.rst b/bootstrap/vagrant-onap/doc/source/install/known_issues.rst
new file mode 100644
index 000000000..84d50940b
--- /dev/null
+++ b/bootstrap/vagrant-onap/doc/source/install/known_issues.rst
@@ -0,0 +1,50 @@
+============
+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
+
+.. code-block:: console
+
+ $ vagrant plugin list
+.. end
+
+- Windows
+
+.. code-block:: console
+
+ C:\> vagrant plugin list
+.. end
+
+Remove vagrant-vbguest plugin
+
+- Linux or Mac
+
+.. code-block:: console
+
+ $ vagrant plugin uninstall vagrant-vbguest
+.. end
+
+- Windows
+
+.. code-block:: console
+
+ C:\> vagrant plugin uninstall vagrant-vbguest
+.. end