summaryrefslogtreecommitdiffstats
path: root/docs/release/installation/virtualinstall.rst
diff options
context:
space:
mode:
authorTim Rozet <trozet@redhat.com>2017-10-17 15:25:16 -0400
committerTim Rozet <trozet@redhat.com>2017-10-17 19:39:19 +0000
commit94787144f6d92476854ca6f8ab65427beafea7a4 (patch)
tree1320ed6e8d50a492f98c81771e6007ac4e89c6a4 /docs/release/installation/virtualinstall.rst
parent37155cf6521e7cf7cb2d61a269f3a9992fa0a6c0 (diff)
Updates docs and scenarios for Euphrates
Change-Id: I2da89d7a6ab4b0549edded908acc760b949231e1 Signed-off-by: Tim Rozet <trozet@redhat.com>
Diffstat (limited to 'docs/release/installation/virtualinstall.rst')
-rw-r--r--docs/release/installation/virtualinstall.rst88
1 files changed, 0 insertions, 88 deletions
diff --git a/docs/release/installation/virtualinstall.rst b/docs/release/installation/virtualinstall.rst
deleted file mode 100644
index 61fc4be6..00000000
--- a/docs/release/installation/virtualinstall.rst
+++ /dev/null
@@ -1,88 +0,0 @@
-Installation High-Level Overview - Virtual Deployment
-=====================================================
-
-The VM nodes deployment operates almost the same way as the bare metal
-deployment with a few differences. ``opnfv-deploy`` still deploys an
-undercloud VM. In addition to the undercloud VM a collection of VMs
-(3 control nodes + 2 compute for an HA deployment or 1 control node and 1
-or more compute nodes for a non-HA Deployment) will be defined for the target
-OPNFV deployment. The part of the toolchain that executes IPMI power
-instructions calls into libvirt instead of the IPMI interfaces on baremetal
-servers to operate the power management. These VMs are then provisioned with
-the same disk images and configuration that baremetal would be. To Triple-O
-these nodes look like they have just built and registered the same way as bare
-metal nodes, the main difference is the use of a libvirt driver for the power
-management. Finally, the default network_settings file will deploy without
-modification. Customizations are welcome but not needed if a generic set of
-network_settings are acceptable.
-
-Installation Guide - Virtual Deployment
-=======================================
-
-This section goes step-by-step on how to correctly install and provision the
-OPNFV target system to VM nodes.
-
-Special Requirements for Virtual Deployments
---------------------------------------------
-
-In scenarios where advanced performance options or features are used, such
-as using huge pages with nova instances, DPDK, or iommu; it is required to
-enabled nested KVM support. This allows hardware extensions to be passed to
-the overcloud VMs, which will allow the overcloud compute nodes to bring up
-KVM guest nova instances, rather than QEMU. This also provides a great
-performance increase even in non-required scenarios and is recommended to be
-enabled.
-
-During deployment the Apex installer will detect if nested KVM is enabled,
-and if not, it will attempt to enable it; while printing a warning message
-if it cannot. Check to make sure before deployment that Nested
-Virtualization is enabled in BIOS, and that the output of ``cat
-/sys/module/kvm_intel/parameters/nested`` returns "Y". Also verify using
-``lsmod`` that the kvm_intel module is loaded for x86_64 machines, and
-kvm_amd is loaded for AMD64 machines.
-
-Install Jumphost
-----------------
-
-Follow the instructions in the `Install Bare Metal Jumphost`_ section.
-
-Running ``opnfv-deploy``
-------------------------
-
-You are now ready to deploy OPNFV!
-``opnfv-deploy`` has virtual deployment capability that includes all of
-the configuration necessary to deploy OPNFV with no modifications.
-
-If no modifications are made to the included configurations the target
-environment will deploy with the following architecture:
-
- - 1 undercloud VM
-
- - The option of 3 control and 2 or more compute VMs (HA Deploy / default)
- or 1 control and 1 or more compute VM (Non-HA deploy / pass -n)
-
- - 1-5 networks: provisioning, private tenant networking, external, storage
- and internal API. The API, storage and tenant networking networks can be
- collapsed onto the provisioning network.
-
-Follow the steps below to execute:
-
-1. ``sudo opnfv-deploy -v [ --virtual-computes n ]
- [ --virtual-cpus n ] [ --virtual-ram n ]
- -n network_settings.yaml -d deploy_settings.yaml``
-
-2. It will take approximately 45 minutes to an hour to stand up undercloud,
- define the target virtual machines, configure the deployment and execute
- the deployment. You will notice different outputs in your shell.
-
-3. When the deployment is complete the IP for the undercloud and a url for the
- OpenStack dashboard will be displayed
-
-Verifying the Setup - VMs
--------------------------
-
-To verify the set you can follow the instructions in the `Verifying the Setup`_
-section.
-
-.. _`Install Bare Metal Jumphost`: index.html#install-bare-metal-jumphost
-.. _`Verifying the Setup`: index.html#verifying-the-setup