Merge "Change from using chef to local config files"
[integration.git] / bootstrap / vagrant-onap / doc / source / install / known_issues.rst
1 ============
2 Known Issues
3 ============
4
5 Virtualbox guest additions conflict with shared directories
6 -----------------------------------------------------------
7
8 If the **vagrant-vbguest** plugin is installed on the host, then an
9 updated version of the Virtualbox guest additions will be installed
10 on the guest in the /opt directory.  Once this projects Vagrantfile
11 mounts the ./opt directory on the host to the /opt directory on the
12 guest during the provisioning process, the guest addtions on the
13 guest are hidden and subsequent mounts of shared directories with the
14 host will fail.
15
16 The simplest workaround appears to be uninstalling the
17 *vagrant-vbguest* plugin on the host system.  This has been observed
18 to work on a Windows 10 host using virtualbox 5.1.26.
19
20 Check if vagrant-vbguest plugin is installed
21
22 - Linux or Mac
23
24 .. code-block:: console
25
26     $ vagrant plugin list
27 .. end
28
29 - Windows
30
31 .. code-block:: console
32
33     C:\> vagrant plugin list
34 .. end
35
36 Remove vagrant-vbguest plugin
37
38 - Linux or Mac
39
40 .. code-block:: console
41
42     $ vagrant plugin uninstall vagrant-vbguest
43 .. end
44
45 - Windows
46
47 .. code-block:: console
48
49     C:\> vagrant plugin uninstall vagrant-vbguest
50 .. end
51
52
53 Network configuration in Windows
54 --------------------------------
55
56 Some Virtual Machines present a problem in their network configuration so to
57 make sure the install will work as it should install the virtualbox from the
58 cmd window with the following command:
59
60 .. code-block:: console
61
62     c:\downloads\VirtualBox-5.1.20-114628-Win.exe -msiparams NETWORKTYPE=NDIS5
63 .. end