DEPRECATED. see eea.docker.searchservices
JavaScript HTML Shell CSS Ruby Python
Latest commit 3a9ac4e Jun 18, 2015 @avoinea avoinea Update README.rst

README.rst

EEA ElasticSearch

elasticsearch logo

WARNING

Notice: This repository has been replaced by a better and dockerised version https://github.com/eea/eea.docker.searchservices

REPLACED BY https://github.com/eea/eea.docker.searchservices

http://ci.eionet.europa.eu/job/Elasticsearch%20RDF%20River%20Plugin/badge/icon

Introduction

EEA elasticsearch is an elasticsearch specific setup by the European Environment Agency for querying data in the EEA's Semantic Data Service and designing specific search interfaces and widgets to be used in a CMS.

Components

The setup is composed of the following:

  1. An elasticsearch instance flavoured with following plugins
  2. EEA ElasticSearch RDF River Plugin
  3. Jetty Plugin
  4. FacetView, a pure JavaScript library for browsing data using an elasticsearch endpoint
  5. elasticsearch service-wrapper, a script for running elasticsearch using Java Service Wrapper.

This packages specifically includes:

  1. Development and production configuration files for elasticsearch and Apache.
  2. Custom static pages using facetview js library.
  3. PAM, an application using the elasticsearch endpoint.

Live demos

Development instalation using Vagrant

We provide most of the setup steps in a Vagrant box for a clean install in a virtual machine.

In the same directory clone these projects:

git clone https://github.com/eea/eea.elasticsearch

git clone git clone https://github.com/eea/facetview.git

git clone git@github.com:eea/elasticsearch-servicewrapper.git

Follow instructions in vagrant/README.rst

If you want a local setup follow the instructions in the next section.

Installation

  1. Clone project

    git clone git@github.com:eea/eea.elasticsearch.git

  2. Install elasticsearch, e.g. in /var/local/elasticsearch

  3. Replace its config folder with a symlink to eea.elasticsearch/etc/production/config

  4. Install RDF River Plugin, using elasticsearch plugin script inside its bin folder:

    bin/plugin --url https://github.com/eea/eea.elasticsearch.river.rdf/raw/master/target/releases/eea-rdf-river-plugin-1.0.zip
    --install eea-rdf-river-1.0
    
  5. Install Jetty Plugin in the same manner:

    bin/plugin --url https://oss-es-plugins.s3.amazonaws.com/elasticsearch-jetty/elasticsearch-jetty-0.90.0.zip
    --install elasticsearch-jetty-0.90.0
    
  6. Install useful plugins for monitoring and debugging:

    bin/plugin -install mobz/elasticsearch-head
    bin/plugin -install lukas-vlcek/bigdesk
    bin/plugin -install OlegKunitsyn/elasticsearch-browse
    bin/plugin -install polyfractal/elasticsearch-inquisitor
    
  7. Install and configure elasticsearch-service wrapper:

    git clone git@github.com:eea/elasticsearch-servicewrapper.git
    cd elasticsearch-servicewrapper/service
    vim elasticsearch.conf # configure path to elasticsearch
    ./elasticsearch install
    
  8. Configure users and roles for elasticsearch requests in eea.elasticsearch/etc/production/config/realm.properties, see Adding Basic Authentication.

  9. Start elasticsearch service

    service elasticsearch start
    
  10. Install facetview

    git clone git@github.com:eea/facetview.git
    
  11. Link eea.elasticsearch/etc/production/httpd.elasticsearch.conf in /etc/httpd/conf.d and check settings

  12. Reload Apache

    service httpd reload
    

Dependencies

eea.elasticsearch has the following dependencies:

Source code

Latest source code:

Copyright and license

The Initial Owner of the Original Code is European Environment Agency (EEA). All Rights Reserved.

The EEA ElasticSearch (the Original Code) is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

More details under eea.elasticsearch/docs/LICENSE.txt

Funding and project management

EEA - European Environment Agency (EU)