Automatic Deployment
[genesis.git] / fuel / deploy / README.rst
1 **DEA libvirt deployment prototype**
2
3 This is an example of how to deploy a libvirt KVM setup with a DEA
4 YAML file.
5
6 The file is created from an already deployed Fuel installation using
7 the create_dea script and helper files which are to be present on the
8 Fuel master and run from there.
9
10 The install is kicked off from the host by running deploy.sh and
11 providing the ISO file to deploy and (optionally) an DEA file name as
12 an argument. If the DEA file is omitted the example one will be used
13 instead.
14
15 Pre-condition 1: The host needs to be Ubuntu 14.x
16
17 Pre-condition 2: Necessary packages installed by running
18 sudo genesis/fuel/prototypes/libvirt/setup_vms/setup-vm-host.sh
19
20 Pre-condition 3: Example VM configuration deployed by running
21 genesis/fuel/prototypes/libvirt/setup_vms/apply_setup.sh The VMs and
22 networks to be setup are in genesis/fuel/prototypes/libvirt/examples:
23 "vms" and "networks"
24 sudo mkdir /mnt/images
25 cd setup-vms
26 sudo ./apply_setup.sh /mnt/images 50
27
28 In order to run the automated install, it's just a matter of running
29 genesis/fuel/prototypes/libvirt/deploy.sh <isofile> [<deafile>] The
30 deafile will be optional, if not specified the example one in
31 genesis/fuel/prototypes/libvirt/examples/libvirt_dea.yaml will be
32 used.
33 sudo ./deploy.sh ~/ISO/opnfv-P0000.iso ~/DEPLOY/deploy/dea.yaml
34
35 Now either this will succeed (return code 0) or fail. I'll have a
36 three hours safety catch to kill off things if something is hanging,
37 may need to be adjusted for slow environments (see deploy.sh).
38
39 All the steps above should be run with sudo.
40
41 In principle the deploy.sh is assuming the example vm setup (one fuel,
42 three controllers, two computes) and will always deploy with full HA
43 and Ceilometer.
44
45 TODO: Copy also  the deployment mode in my dea.yaml creation script
46 genesis/fuel/prototypes/libvirt/create_dea/create_dea.sh so it's a
47 real xerox of the running deploy.