aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGary Wu <gary.i.wu@huawei.com>2017-08-15 23:18:12 +0000
committerGerrit Code Review <gerrit@onap.org>2017-08-15 23:18:12 +0000
commita57fb1414b932fa449f51efa5d8314d2f5c4843a (patch)
tree5992a09e0f88bcba5b2450d6bddd68d1d80430e8
parent5d5c5da9317e4681c10e6fe2a8f76aeb680d3517 (diff)
parentd4036482535db1d1fc28c88960c8b05233543ace (diff)
Merge "Move Known Issues section to docs folder"
-rw-r--r--bootstrap/vagrant-onap/README.md38
-rw-r--r--bootstrap/vagrant-onap/Vagrantfile25
-rw-r--r--bootstrap/vagrant-onap/doc/source/index.rst1
-rw-r--r--bootstrap/vagrant-onap/doc/source/install/known_issues.rst50
4 files changed, 67 insertions, 47 deletions
diff --git a/bootstrap/vagrant-onap/README.md b/bootstrap/vagrant-onap/README.md
index 05f8cda4a..cab72c5e9 100644
--- a/bootstrap/vagrant-onap/README.md
+++ b/bootstrap/vagrant-onap/README.md
@@ -58,7 +58,7 @@ current options include:
| all_in_one | All ONAP services in a VM |
| testing | Unit Test VM |
-#### generating documentation
+#### Generating documentation
The documentation of this project was written in reStructuredText
format which is located under the [docs folder](../blob/master/doc/source/index.rst).
@@ -71,42 +71,6 @@ 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.
diff --git a/bootstrap/vagrant-onap/Vagrantfile b/bootstrap/vagrant-onap/Vagrantfile
index 3ee305c39..50c18c76b 100644
--- a/bootstrap/vagrant-onap/Vagrantfile
+++ b/bootstrap/vagrant-onap/Vagrantfile
@@ -81,6 +81,11 @@ Vagrant.configure("2") do |config|
config.proxy.no_proxy = ENV['no_proxy']
end
+ if Vagrant.has_plugin?('vagrant-vbguest')
+ puts 'vagrant-vbguest auto_update feature will be disable to avoid sharing conflicts'
+ config.vbguest.auto_update = false
+ end
+
config.vm.box = 'ubuntu/trusty64'
if provider == :libvirt
config.vm.box = 'sputnik13/trusty64'
@@ -214,27 +219,27 @@ Vagrant.configure("2") do |config|
s.env = conf
end
end
-
+
config.vm.define :aai do |aai|
aai.vm.hostname = 'aai'
aai.vm.network :private_network, ip: '192.168.50.6'
aai.vm.provider "openstack" do |v|
v.server_name = 'aai'
end
- aai.vm.provision 'shell' do |s|
+ aai.vm.provision 'shell' do |s|
s.path = 'vagrant_utils/postinstall.sh'
s.args = ['aai']
s.env = conf
end
end
-
+
config.vm.define :mso do |mso|
mso.vm.hostname = 'mso'
mso.vm.network :private_network, ip: '192.168.50.7'
mso.vm.provider "openstack" do |v|
v.server_name = 'mso'
end
- mso.vm.provision 'shell' do |s|
+ mso.vm.provision 'shell' do |s|
s.path = 'vagrant_utils/postinstall.sh'
s.args = ['mso']
s.env = conf
@@ -253,7 +258,7 @@ Vagrant.configure("2") do |config|
s.env = conf
end
end
-
+
config.vm.define :vid do |vid|
vid.vm.hostname = 'vid'
vid.vm.network :private_network, ip: '192.168.50.9'
@@ -266,7 +271,7 @@ Vagrant.configure("2") do |config|
s.env = conf
end
end
-
+
config.vm.define :sdnc do |sdnc|
sdnc.vm.hostname = 'sdnc'
sdnc.vm.network :private_network, ip: '192.168.50.10'
@@ -279,7 +284,7 @@ Vagrant.configure("2") do |config|
s.env = conf
end
end
-
+
config.vm.define :portal do |portal|
portal.vm.hostname = 'portal'
portal.vm.network :private_network, ip: '192.168.50.11'
@@ -292,7 +297,7 @@ Vagrant.configure("2") do |config|
s.env = conf
end
end
-
+
config.vm.define :dcae do |dcae|
dcae.vm.hostname = 'dcae'
dcae.vm.network :private_network, ip: '192.168.50.12'
@@ -305,7 +310,7 @@ Vagrant.configure("2") do |config|
s.env = conf
end
end
-
+
config.vm.define :policy do |policy|
policy.vm.hostname = 'policy'
policy.vm.network :private_network, ip: '192.168.50.13'
@@ -318,7 +323,7 @@ Vagrant.configure("2") do |config|
s.env = conf
end
end
-
+
config.vm.define :appc do |appc|
appc.vm.hostname = 'appc'
appc.vm.network :private_network, ip: '192.168.50.14'
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