User:Tsu2/Kibana

Kibana

This is a page describing how to install Kibana on openSUSE Specific commands may reference openSUSE 12.3, but modifying the version number should work with any distro version.

What is Kibana

Kibana is a highly capable web tool that can read data mapped and reduced by Elasticsearch. This guide is intended to be the third part of a logstash-elasticsearch-kibana setup.

Update!

As of October, 2013 Kibana is now distributed as a raw website, not as a Ruby application.

.

So, the instructions are now much simpler...
1. Download tar.gz for extraction or from github, links are at http://www.elasticsearch.org/overview/kibana/installation/

2. Configure config.js (or if elasticsearch is running on the same machine defaults are fine)

3. copy the website to the root of whatever webserver you are running (if apache on openSUSE, /srv/www/htdocs/)

You're done!

---

Install Overview (This applies only to kibana 2.x and earlier for archival purposes)

This guide is based largely on the original instructions at
http://kibana.org/intro.html

Kibana is a ruby application which means that although prerequisites need to be installed using zypper, the majority of the application is to be installed using ruby gems.

The following procedure
Installs webserver+mysql, ruby tools, ruby source files.
NOTE-
- Installing bundler as a gem as described in the Kibana documentation does not work. You must install from the openSUSE repos.
- Do not install eventmachine separately. The ruby install will build the appropriate version

Preparation - Install Prerequisites

The following 2 commands should each be a single line (likely will wrap on the page)

zypper ar http://download.opensuse.org/repositories/devel:/languages:/ruby:/extensions/openSUSE_12.3/ devel:languages:ruby:extensions

zypper in apache2 mariadb ruby rubygems gcc gcc-c++ make ruby-devel ruby19-devel rubygem-bundler

The Main Install

Download the zip or tar file (or clone from git). Uncompress the download, I recommend to a subdirectory of the User, eg

mkdir ~/Kibana
tar -xzvf file.tar.gz ~/Kibana

Run the Installation

bundle install

Install Result

By default, Kibana should already be configured to read a locally installed Elasticsearch using running with default settings. If you need to modify the Kibana configuration, edit KibanaConfig.rb.

Running Kibana

Each time you want to run Kibana, from a root console

cd ~/Kibana && ruby kibana.rb