ci/nosdn/README

   1 OpenDaylight Deployment with Juju
   2 =================================
   3
   4 This readme contains instructions for checking out and deploying Juju charms for
   5 OpenDaylight.
   6
   7 The charms are targetted at Trusty.
   8
   9
  10 Checkout charms
  11 ---------------
  12
  13 Charms are hosted on Launchpad.
  14 You need to 'sudo apt-get install bzr' first.
  15
  16 Follow these steps to checkout code:
  17
  18 cd <deployer dir>
  19 ./fetch-charms.sh
  20
  21 This will checkout the relevant charms into 'src' and create any Juju symlinks
  22 in 'charms'.
  23
  24
  25 Deploy with cloud-sh-odl
  26 ------------------------
  27
  28 cloud-sh-odl is a collection of development shell scripts to deploy
  29 and setup OpenStack with OpenDaylight using Juju's local provider. This will
  30 create 3 KVMs as follows:
  31
  32 *KVM #1 - Keystone, Glance, Neutron Server, Nova Cloud Controller, Horizon,
  33           MySQL, RabbitMQ, OpenDaylight Controller
  34
  35 *KVM #2 - Neutron agents
  36
  37 *KVM #3 - Nova Compute
  38
  39 You'll require approx. 13Gb RAM with 40Gb+ disk space.
  40 Deployment can take anywhere between 20 mins to 1 hour.
  41
  42 You need to 'sudo apt-get install juju juju-local uvtool', and
  43 logout/login in order to pick up libvirt group permissions before
  44 proceeding. See https://bugs.launchpad.net/juju-core/+bug/1308088.
  45
  46 Follow these steps:
  47
  48 ssh-keygen
  49   (if you don't already have a key at ~/.ssh/id_rsa).
  50
  51 cp cloud-sh-odl/environments.yaml ~/.juju
  52   (or create your own default local environment in your existing
  53    environments.yaml file)
  54
  55 cd cloud-sh-odl
  56
  57 ./deploy.sh
  58
  59 This will log to 'out.log'.
  60
  61 This will deploy OpenStack and import Trusty's daily image into Glance.
  62
  63 Horizon will be located on the machine 'juju status openstack-dashboard' -
  64 http://<ip>/horizon.
  65 Admin credentials will be written to cloud/admin-openrc.
  66
  67 The deployment can be destroyed with:
  68
  69 juju destroy-environment local
  70
  71
  72 Deploy with Juju Deployer
  73 -------------------------
  74
  75 Juju Deployer can deploy a preset configuration of charms given a yaml
  76 configuration file. There is a configuration file in
  77 'juju-deployer/odl.yaml'.
  78
  79 You need to 'sudo apt-get install juju-deployer' first.
  80
  81 Then:
  82
  83 cd juju-deployer
  84
  85 juju-deployer -c odl.yaml -d trusty-icehouse-odl
  86
  87 Juju Deployer will branch its own copy of the remote charms.