To use RNI-Elasticsearch you need the RNI Elasticsearch plugin, an RLP license file (
rlp-license.xml) and Elasticsearch.
If you are using the Linux distribution of RNI-ES, note that glibc is required. The version of glibc that the native libraries are built against can be found in the filename of the distributed package.
If you do not already have it, install Elasticsearch.
Download and unzip Elasticsearch-<version>.zip.
The version of Elasticsearch must match the first three digits of the version of the RNI-ES plugin. If your version of Elasticsearch does not match the plugin version, the plugin will not install.
Install the plugin.
Navigate to the
elasticsearch-<version> root directory and run the install command.
On Unix, Linux and MacOS:
bin/elasticsearch-plugin install file:///path/to/rni-es-<version>.x.zip
bin\elasticsearch-plugin install file:///C:\path\to\rni-es-<version>.x.zip
You must use the absolute file path to refer to the plugin zip file. For example, if the file is in the home directory of rniUser on macOS, the command would be:
bin/elasticsearch-plugin install file:///Users/rniUser/rni-es-<version>.x.zip
You may be prompted to grant permissions necessary for the plugin to function.
The plugin is now in
For Windows users, you must add
to your PATH environment variable. In this case, you must replace * with the name of the subdirectory which contains platform-specific binary library files (for example,
Additionally, the RNI-Elasticsearch plugin cannot be installed into distributions of Elasticsearch found in the
C:\Program Files directory.
Copy the RLP License (
This license must be in place before you can use the RNI-Elasticsearch plugin.
To start the Elasticsearch server, run:
When starting Elasticsearch with the plugin you may see some non-fatal error messages. If a message follows the error stating that “Cluster health status changed from [RED] to [YELLOW]“, the error can be ignored. This may occur when the
enableDynamicConfiguration is set to
RNI uses libpostal to parse addresses; libpostal is a C library for parsing/normalizing street addresses around the world using statistical NLP and open data.
RNI packages libpostal data in
plugins/rni/bt_root/rlpnc/data/libpostal. The data directory is relatively large (~2G). If you are certain that you won't be utilizing address matching of unfielded addresses, you can safely delete the libpostal data directory without impacting any other RNI-ES functionalities.