summaryrefslogtreecommitdiffstats
path: root/src/fuel-plugin/README.md
blob: becb10a30ff8e69c67b90c25591edc8b8f6fed61 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
plugin-collectd-ceilometer
=========================

Plugin description
Installs collectd-ceilometer on compute via a fuel plugin.

Requirements
------------

| Requirement                      | Version/Comment |
|----------------------------------|-----------------|
| Mirantis OpenStack compatibility | 9.0             |


Documents
---------

1. https://wiki.openstack.org/wiki/Fuel
2. https://wiki.openstack.org/wiki/Fuel/Plugins

Build/Deploy/Verify
-------------------

step 1, 2, 3 may be bypassed if fuel plugin is installed from /opt/opnfv in fuel@opnfv.

1) install fuel plugin builder
    sudo apt-get install -y ruby-dev rubygems-integration python-pip rpm createrepo dpkg-dev
    sudo gem install fpm
    sudo pip install fuel-plugin-builder

2) build plugin
    fpb --build <plugin-dir>
    e.g.: fpb --build fastpathmetrics/src/fuel-plugin

3) copy plugin rpm to fuel master
	e.g. scp fuel-plugin-collectd-ceilometer-0.9-0.9.0-1.noarch.rpm  <user>@<server-name>:~/

4) install plugin
	fuel plugins --install <plugin-name>.rpm

5) prepare fuel environment
  a) enable ceilometer service
    go to settings/openstack services
    enable ceilometer plugin with checkbox
  b) enable collectd-ceilometer
    go to settings/other
    enable collectd-ceilometer plugin with checkbox
  c) save settings

6) add nodes to environment

7) deploy

8) verify
SSH to openstack controller node:
    source openrc
    ceilometer sample-list --meter interface.if_packets

9) known issues

a) connection aborted
  root@node-11:~# ceilometer sample-list --meter interface.if_packets
('Connection aborted.', BadStatusLine("''",))

  workaround:
  root@node-11:~# sudo service ceilometer-api restart

b) Service Unavailable
  root@node-11:~# ceilometer sample-list --meter interface.if_packets
Service Unavailable (HTTP 503)

  workaround:
  root@node-11:~# sudo service ceilometer-api restart