ci/onos/README

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