fuel/prototypes/libvirt/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 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
  25 In order to run the automated install, it's just a matter of running
  26 genesis/fuel/prototypes/libvirt/deploy.sh <isofile> [<deafile>] The
  27 deafile will be optional, if not specified the example one in
  28 genesis/fuel/prototypes/libvirt/examples/libvirt_dea.yaml will be
  29 used.
  30
  31 Now either this will succeed (return code 0) or fail. I'll have a
  32 three hours safety catch to kill off things if something is hanging,
  33 may need to be adjusted for slow environments (see deploy.sh).
  34
  35 All the steps above should be run with sudo.
  36
  37 In principle the deploy.sh is assuming the example vm setup (one fuel,
  38 three controllers, two computes) and will always deploy with full HA
  39 and Ceilometer.
  40
  41 TODO: Copy also  the deployment mode in my dea.yaml creation script
  42 genesis/fuel/prototypes/libvirt/create_dea/create_dea.sh so it's a
  43 real xerox of the running deploy.