birdhousebuilder.recipe.solr 0.2.2

A Buildout recipe to install and configure Apache Solr with Anaconda.

Introduction

birdhousebuilder.recipe.solr is a Buildout recipe to install and configure Solr using Anaconda. Solr will be deployed as a Supervisor service.

This recipe is used by the Birdhouse project.

Usage

The recipe requires that Anaconda is already installed. You can use the buildout option anaconda-home to set the prefix for the anaconda installation. Otherwise the environment variable CONDA_PREFIX (variable is set when activating a conda environment) is used as conda prefix.

It installs the solr package from a conda channel in a conda environment defined by CONDA_PREFIX. The intallation folder is given by the prefix buildout option. It deploys a Supervisor configuration for Solr in ${prefix}/etc/supervisor/conf.d/solr.conf. Supervisor can be started with ${prefix}/etc/init.d/supervisord start.

By default Solr will be available on http://localhost:8983/solr.

The recipe depends on birdhousebuilder.recipe.conda and birdhousebuilder.recipe.supervisor.

Supported options

The recipe supports the following options:

anaconda-home

Buildout option pointing to the root folder of the Anaconda installation. Default: $HOME/anaconda.

hostname

The hostname of the Solr service (nginx). Default: localhost.

http-port

The http port of the Solr service (nginx). Default: 8983.

java-home

Path to your JAVA_HOME. By default it uses the java installation from conda (package openjdk). Default: ${prefix}.

Example usage

The following example buildout.cfg installs Solr with Anaconda:

[buildout]
parts = solr

[solr]
recipe = birdhousebuilder.recipe.solr
hostname = localhost
http-port = 8983

Authors

Carsten Ehbrecht ehbrecht at dkrz.de

Change History

0.2.2 (2017-01-27)

• pep8.

• update Readme.

• fixed travis.

0.2.1 (2016-08-20)

• fixed permissions of solr-home.

• added solr-jetty-context.xml to configure jetty tempDirectory.

0.2.0 (2016-06-19)

• using zc.recipe.buildout.

0.1.5 (2016-01-06)

• set SOLR_HOME to var/lib/solr.

• fixed recipe update mode.

0.1.4 (2015-08-04)

• using conda java-jdk (OpenJDK) package.

• SOLR_JAVA_HOME set to birdhouse java.

0.1.3 (2015-07-30)

• cleaned up schema.

• using tags as default search field.

0.1.2 (2015-07-28)

• added source type in schema.xml.

0.1.1 (2015-07-24)

• added fields for birdhouse in schema.xml.

• cleaned up configuration files.

0.1.0 (2015-07-15)

Initial Release.