src/fuel-plugin/README.md

   1 plugin-collectd-ceilometer
   2 =========================
   3
   4 Plugin description
   5 Installs collectd-ceilometer on compute via a fuel plugin.
   6
   7 Requirements
   8 ------------
   9
  10 | Requirement                      | Version/Comment |
  11 |----------------------------------|-----------------|
  12 | Mirantis OpenStack compatibility | 9.0             |
  13
  14
  15 Documents
  16 ---------
  17
  18 1. https://wiki.openstack.org/wiki/Fuel
  19 2. https://wiki.openstack.org/wiki/Fuel/Plugins
  20
  21 Build/Deploy/Verify
  22 -------------------
  23
  24 1) install fuel plugin builder (fpb)
  25     sudo apt-get install -y ruby-dev rubygems-integration python-pip rpm createrepo dpkg-dev
  26     sudo gem install fpm
  27     sudo pip install fuel-plugin-builder
  28
  29 2) build plugin
  30     fpb --build <plugin-dir>
  31     e.g.: fpb --build fastpathmetrics/src/fuel-plugin
  32
  33 3) copy plugin rpm to fuel master
  34         e.g. scp fuel-plugin-collectd-ceilometer-0.9-0.9.0-1.noarch.rpm  <user>@<server-name>:~/
  35
  36 4) install plugin
  37         fuel plugins --install <plugin-name>.rpm
  38
  39 5) prepare fuel environment
  40         on fuel dashboard, go to settings/other
  41         enable collectd-ceilometer plugin with checkbox
  42         save settings
  43
  44 6) add nodes to environment
  45
  46 7) deploy
  47
  48 8) verify
  49 SSH to openstack controller node:
  50     source openrc
  51     ceilometer sample-list --meter interface.if_packets
  52
  53 9) known issues
  54
  55 a) connection aborted
  56   root@node-11:~# ceilometer sample-list --meter interface.if_packets
  57 ('Connection aborted.', BadStatusLine("''",))
  58
  59   workaround:
  60   root@node-11:~# sudo service ceilometer-api restart
  61
  62 b) Service Unavailable
  63   root@node-11:~# ceilometer sample-list --meter interface.if_packets
  64 Service Unavailable (HTTP 503)
  65
  66   workaround:
  67   root@node-11:~# sudo service ceilometer-api restart