searchlight/devstack
lingyongxu 067f8eaf06 Update the documentation link for doc migration
This patch is proposed according to the Direction 10 of doc
migration(https://etherpad.openstack.org/p/doc-migration-tracking).

Change-Id: I55f4bbdda9671d766d90349d6d0cfccc5dba1741
2017-08-03 14:53:12 +08:00
..
gate Add devstack plugin 2015-07-02 19:27:26 +02:00
README.rst Update the documentation link for doc migration 2017-08-03 14:53:12 +08:00
local.conf Update the documentation link for doc migration 2017-08-03 14:53:12 +08:00
plugin.sh Remove "noarch" from elasticsearch rpm install command 2017-07-26 04:51:29 +00: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://git.openstack.org/openstack/searchlight
    enable_service searchlight-api
    enable_service searchlight-listener

    To use stable branches, make sure devstack is on that branch, and specify the branch name to enable_plugin, for example:

    enable_plugin searchlight https://git.openstack.org/openstack/searchlight stable/mitaka
  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, you typically will need to set the notifications driver in 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 settings, add them under the following section in local.conf:

[[post-config|$SEARCHLIGHT_CONF]]