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 | 10.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 step 1, 2, 3 may be bypassed if fuel plugin is installed from /opt/opnfv in fuel@opnfv.
  25
  26 1) install fuel plugin builder
  27     sudo apt-get install -y ruby-dev rubygems-integration python-pip rpm createrepo dpkg-dev
  28     sudo gem install fpm
  29     sudo pip install fuel-plugin-builder
  30
  31 2) build plugin
  32     fpb --build <plugin-dir>
  33     e.g.: fpb --build fastpathmetrics/src/fuel-plugin
  34
  35 3) copy plugin rpm to fuel master
  36         e.g. scp fuel-plugin-collectd-ceilometer-0.9-0.9.0-1.noarch.rpm  <user>@<server-name>:~/
  37
  38 4) install plugin
  39         fuel plugins --install <plugin-name>.rpm
  40
  41 5) prepare fuel environment
  42   a) enable ceilometer service
  43     go to settings/openstack services
  44     enable ceilometer plugin with checkbox
  45   b) enable collectd-ceilometer
  46     go to settings/other
  47     enable collectd-ceilometer plugin with checkbox
  48   c) save settings
  49
  50 6) add nodes to environment
  51
  52 7) deploy
  53
  54 8) verify
  55 SSH to openstack controller node:
  56     source openrc
  57     ceilometer sample-list --meter interface.if_packets
  58
  59 9) known issues
  60
  61 a) connection aborted
  62   root@node-11:~# ceilometer sample-list --meter interface.if_packets
  63 ('Connection aborted.', BadStatusLine("''",))
  64
  65   workaround:
  66   root@node-11:~# sudo service ceilometer-api restart
  67
  68 b) Service Unavailable
  69   root@node-11:~# ceilometer sample-list --meter interface.if_packets
  70 Service Unavailable (HTTP 503)
  71
  72   workaround:
  73   root@node-11:~# sudo service ceilometer-api restart