x
/
fuel-plugin-elasticsearch-kibana
Code Issues Proposed changes
RETIRED, Integrate Elasticsearch and Kibana with Fuel
22 Commits 1 Branch 28 Tags 13 MiB
Go to file
Simon Pasquier 0dead29aa1 Update plugin's description 
The plugin's description is going to be displayed in the Fuel UI once
the deployment is completed [1]. This change modifies the description
to instruct the end-user what to do next.

[1] https://review.openstack.org/#/c/164256

Change-Id: If20bf781a75cae10275a57efd0dad47d87f666db
 		2015-03-25 10:18:15 +00:00
deployment_scripts/puppet Fix errors reported by puppet-lint 2015-03-24 11:37:04 +00:00
repositories Initial import 2015-03-03 17:01:36 +01:00
specs Add blueprint for the Elasticsearch/Kibana plugin. 2015-02-26 11:27:55 +01:00
.gitreview Added .gitreview 2015-02-13 08:49:06 +00:00
LICENSE Initial import 2015-03-03 17:01:36 +01:00
README.md update README. 2015-03-25 11:13:50 +01:00
environment_config.yaml Create disk partitions on Ubuntu. 2015-03-12 15:52:25 +01:00
metadata.yaml Update plugin's description 2015-03-25 10:18:15 +00:00
pre_build_hook Update version of tzdata 2015-03-24 11:34:16 +00:00
tasks.yaml Create disk partitions on Ubuntu. 2015-03-12 15:52:25 +01:00

README.md

Elasticsearch-Kibana Plugin for Fuel

Elasticsearch-Kibana plugin

Overview

Elasticsearch and Kibana provide a full-text search engine with a flexible web interface for exploring and visualizing data.

Requirements

Requirement Version/Comment
Mirantis OpenStack compatility 6.1 or higher

Recommendations

It is highly recommended to use dedicated disk(s) for data storage. Otherwise Elasticsearch will store its data on the root filesystem.

Limitations

None so far.

Installation Guide

Elasticsearch-Kibana plugin installation

To install the Elasticsearch-Kibana plugin, follow these steps:

  1. Download the plugin from the Fuel Plugins Catalog.

  2. Copy the plugin file to the Fuel Master node. Follow the Quick start guide if you don't have a running Fuel Master node yet.

    scp elasticsearch_kibana-6.1-6.1.0-0.noarch.rpm root@<Fuel Master node IP address>:

  3. Install the plugin using the fuel command line:

    fuel plugins --install elasticsearch_kibana-6.1-6.1.0-0.noarch.rpm

  4. Verify that the plugin is installed correctly:

    fuel plugins --list

Please refer to the Fuel Plugins wiki if you want to build the plugin by yourself. Version 2.0.0 (or higher) of the Fuel Plugin Builder is required.

User Guide

Elasticsearch-Kibana plugin configuration

  1. Create a new environment with the Fuel UI wizard.
  2. Add a node with the "Operating System" role.
  3. Before applying changes or once changes applied, edit the name of the node by clicking on "Untitled (xx:yy)" and modify it for "elasticsearch".
  4. Click on the Settings tab of the Fuel web UI.
  5. Scroll down the page, select the "Elasticsearch-Kibana Server plugin" checkbox and fill-in the required fields.

Testing

Once installed, you can check that ElasticSearch is working using curl:

curl http://$HOST:9200/

Where HOST is the IP address or the name of the node that runs the server.

The expected output is something like this:

{
  "status" : 200,
  "name" : "node-23-es-01",
  "cluster_name" : "elasticsearch",
  "version" : {
    "number" : "1.4.4",
    "build_hash" : "c88f77ffc81301dfa9dfd81ca2232f09588bd512",
    "build_timestamp" : "2015-02-19T13:05:36Z",
    "build_snapshot" : false,
    "lucene_version" : "4.10.3"
  },
  "tagline" : "You Know, for Search"
}

Known issues

None.

Release Notes

6.1.0

  • Initial release of the plugin

Contributors