Integration is provided via a plugin. There are multiple configuration settings required for proper indexing and incremental updates. Some of the settings are specified in Searchlight configuration files. Others are provided in other service configuration files.
Searchlight resource configuration options are shown below with their configuration file and default values.
See Searchlight Plugin Documentation for common options with their default values, general configuration information, and an example complete configuration.
Note
Unless you are changing to a non-default value, you do not need to specify any of the following configuration options.
The nova services must be configured properly to work with searchlight.
Notifications must be configured properly for searchlight to process incremental updates. Use the following:
notification_driver = messaging
notification_topics = notifications, searchlight_indexer
rpc_backend = 'rabbit'
notify_on_state_change=vm_and_task_state
Note
Restart Nova API and Nova scheduler (n-api, n-sch) after making changes.
The settings above may be automatically configured by stack.sh by adding them to the following post config section in devstack. Just place the following in local.conf and copy the above settings underneath it.:
[[post-config|$NOVA_CONF]]
[DEFAULT]
Since changes to Neutron can affect Nova instances you may optionally turn on notifications for Neutron. If you do not, networking changes will only be picked up by Searchlight when notifications are received from Nova.
Notifications must be configured properly for searchlight to process incremental updates. Use the following:
notification_driver = messaging
notification_topics = searchlight_indexer
rpc_backend = 'rabbit'
Note
Restart the Neutron service (q-svc) after making changes.
The settings above may be automatically configured by stack.sh by adding them to the following post config section in devstack. Just place the following in local.conf and copy the above settings underneath it.:
[[post-config|$NEUTRON_CONF]]
[DEFAULT]
Additional properties can be similarly protected with the admin_only_fields under each plugin’s configuration section. Glob-like patterns are supported. For instance:
[resource_plugin:os_nova_server]
admin_only_fields=OS-EXT-STS:vm_state
See: ADMIN_ONLY_FIELDS in: * searchlight/elasticsearch/plugins/nova/servers.py
All OS-EXT-SRV-ATTR:.* properties are filtered out from search results for non-admin users. This is not a configuration option in this release. To change this or filter out additional properties, you must change the plugin code to add additional properties.
See: ADMIN_ONLY_PROPERTIES in searchlight/elasticsearch/plugins/nova/servers.py