aboutsummaryrefslogtreecommitdiffstats
path: root/src/fuel-plugin/README.md
blob: d749197750d67268e65d50dd5982e93febcbbb12 (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
Barometer Plugin
================

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

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

| Requirement                      | Version/Comment |
|----------------------------------|-----------------|
| Mirantis OpenStack compatibility | 10.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 barometer/src/fuel-plugin

3) copy plugin rpm to fuel master
	e.g. scp fuel-plugin-collectd-ceilometer-1.0-1.0.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
    check 'Install Ceilometer and Aodh' to enable ceilometer
  b) enable collectd-ceilometer
    go to settings/other
    enable the barometer plugins using the checkboxes
  c) save settings

6) add nodes to environment

7) deploy

8) verify
SSH to openstack controller node:
    source openrc
    ceilometer sample-list -m interface.if_packets
    ceilometer sample-list -m hugepages.vmpage_number
    ceilometer sample-list -m ovs_events.gauge
    ceilometer sample-list -m mcelog.errors