7232952dc960dbe5e94d95e60f486cfa87e044e7
[apex.git] / docs / installation-instructions / 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 deploymen
5 t with a
6 few differences.  ``opnfv-deploy`` still deploys an Instack VM. In addition to t
7 he Instack VM
8 a collection of VMs (3 control nodes + 2 compute for an HA deployment or 1 contr
9 ol node and
10 1 compute node for a Non-HA Deployment) will be defined for the target OPNFV dep
11 loyment.
12 The part of the toolchain that executes IPMI power instructions calls into libvi
13 rt instead of
14 the IPMI interfaces on baremetal servers to operate the power managment.  These
15 VMs are then
16 provisioned with the same disk images and configuration that baremetal would be.
17
18 To RDO Manager these nodes look like they have just built and registered the sam
19 e way as
20 bare metal nodes, the main difference is the use of a libvirt driver for the pow
21 er management.
22
23 Installation Guide - Virtual Deployment
24 =======================================
25
26 This section goes step-by-step on how to correctly install and provision the OPNFV target system to VM nodes.
27
28 Install Jumphost
29 ----------------
30
31 Follow the instructions in the `Install Bare Metal Jumphost`_ section.
32
33 Running ``opnfv-deploy``
34 ------------------------
35
36 You are now ready to deploy OPNFV!
37 ``opnfv-deploy`` has virtual deployment capability that includes all of
38 the configuration nessesary to deploy OPNFV with no modifications.
39
40 If no modifications are made to the included configurations the target environment
41 will deploy with the following architecture:
42
43     - 1 Instack VM
44
45     - The option of 3 control and 2 compute VMs (HA Deploy / default)
46       or 1 control and 1 compute VM (Non-HA deploy / pass -n)
47
48     - 2 networks, one for provisioning, internal API,
49       storage and tenant networking traffic and a second for the external network
50
51 Follow the steps below to execute:
52
53 1.  ``sudo opnfv-deploy --virtual [ --no-ha ]``
54
55 2.  It will take approximately 30 minutes to stand up instack,
56     define the target virtual machines, configure the deployment and execute the deployment.
57     You will notice different outputs in your shell.
58
59 3.  When the deployment is complete you will see "Overcloud Deployed"
60
61 Verifying the Setup - VMs
62 -------------------------
63
64 To verify the set you can follow the instructions in the `Verifying the Setup`_ section.
65
66 .. _`Install Bare Metal Jumphost`: baremetal.html
67 .. _`Verifying the Setup`: verification.html