searchlight/devstack
Travis Tripp c8bae93d67 Update Docs for Mitaka Release
A number of docs required updated to reflect changes
made during the Mitaka release candidate period. This captures
many of them.

Change-Id: I980cea6964ba1dce2ea40c9665c6938271cba6ac
2016-03-17 18:22:02 -06:00
..
gate Add devstack plugin 2015-07-02 19:27:26 +02:00
README.rst Add sample devstack local.conf 2016-02-25 18:27:20 +00:00
local.conf Update Docs for Mitaka Release 2016-03-17 18:22:02 -06:00
plugin.sh Swift plugin 2016-03-16 19:43:13 -07:00
settings Add Devstack install support for searchlightclient 2016-01-25 19:17:59 +00:00

README.rst

Enabling Searchlight in Devstack

  1. Download DevStack (git clone)
  2. Update local.conf

You may follow the customization instructions below or use the example local.conf.

  1. Run stack.sh

Note

This installs a headless JRE. If you are working on a desktop based OS (such as Ubuntu 14.04), this may cause tools like pycharms to no longer launch. You can switch between JREs and back: to a headed JRE version using: "sudo update-alternatives --config java".

Full example local.conf

The example local.conf MAY not be up to date with the rest of devstack.

local.conf <local.conf>

Note

You will need to look through the settings and potentially customize it to your environment, especially HOST_IP.

Existing local.conf customization

  1. Add this repo as an external repository:

    > cat local.conf
    [[local|localrc]]
    enable_plugin searchlight https://github.com/openstack/searchlight
    enable_service searchlight-api
    enable_service searchlight-listener
  2. Configure desired searchlight plugins

The search service is driven using a plugin mechanism for integrating to other services. Each integrated service may need to be specifically enabled in devstack and may require additional configuration settings to work with searchlight. For example, typically, you will need to add the searchlight_indexer notification topic to each service's configuration.

Please review the plugin documentation and add configuration appropriately:

  1. Customize searchlight configuration

Searchlight documentation talks about settings in searchlight.conf. To customize searchlight.conf settingss, add then under the following section in local.conf:

[[post-config|$SEARCHLIGHT_CONF]]