docs/release/installation/virtualinstall.rst

   1 Installation High-Level Overview - Virtual Deployment
   2 =====================================================
   3
   4 The VM nodes deployment operates almost the same way as the bare metal
   5 deployment with a few differences.  ``opnfv-deploy`` still deploys an
   6 undercloud VM. In addition to the undercloud VM a collection of VMs
   7 (3 control nodes + 2 compute for an HA deployment or 1 control node and 1
   8 or more compute nodes for a non-HA Deployment) will be defined for the target
   9 OPNFV deployment.  The part of the toolchain that executes IPMI power
  10 instructions calls into libvirt instead of the IPMI interfaces on baremetal
  11 servers to operate the power managment.  These VMs are then provisioned with
  12 the same disk images and configuration that baremetal would be. To Triple-O
  13 these nodes look like they have just built and registered the same way as bare
  14 metal nodes, the main difference is the use of a libvirt driver for the power
  15 management.  Finally, the default network_settings file will deploy without
  16 modification.  Customizations are welcome but not needed if a generic set of
  17 network_settings are acceptable.
  18
  19 Installation Guide - Virtual Deployment
  20 =======================================
  21
  22 This section goes step-by-step on how to correctly install and provision the
  23 OPNFV target system to VM nodes.
  24
  25 Install Jumphost
  26 ----------------
  27
  28 Follow the instructions in the `Install Bare Metal Jumphost`_ section.
  29
  30 Running ``opnfv-deploy``
  31 ------------------------
  32
  33 You are now ready to deploy OPNFV!
  34 ``opnfv-deploy`` has virtual deployment capability that includes all of
  35 the configuration nessesary to deploy OPNFV with no modifications.
  36
  37 If no modifications are made to the included configurations the target
  38 environment will deploy with the following architecture:
  39
  40     - 1 undercloud VM
  41
  42     - The option of 3 control and 2 or more compute VMs (HA Deploy / default)
  43       or 1 control and 1 or more compute VM (Non-HA deploy / pass -n)
  44
  45     - 1-5 networks: provisioning, private tenant networking, external, storage
  46       and internal API. The API, storage and tenant networking networks can be
  47       collapsed onto the provisioning network.
  48
  49 Follow the steps below to execute:
  50
  51 1.  ``sudo opnfv-deploy -v [ --virtual-computes n ]
  52     [ --virtual-cpus n ] [ --virtual-ram n ]
  53     -n network_settings.yaml -d deploy_settings.yaml``
  54
  55 2.  It will take approximately 45 minutes to an hour to stand up undercloud,
  56     define the target virtual machines, configure the deployment and execute
  57     the deployment.  You will notice different outputs in your shell.
  58
  59 3.  When the deployment is complete the IP for the undercloud and a url for the
  60     OpenStack dashboard will be displayed
  61
  62 Verifying the Setup - VMs
  63 -------------------------
  64
  65 To verify the set you can follow the instructions in the `Verifying the Setup`_
  66 section.
  67
  68 .. _`Install Bare Metal Jumphost`: index.html#install-bare-metal-jumphost
  69 .. _`Verifying the Setup`: index.html#verifying-the-setup