Skip to main content
Loading

Install Aerospike Connect for Elasticsearch

Aerospike Connect for Elasticsearch streams data from Aerospike Database to Elasticsearch. This gives developers access to Elasticsearch's powerful text search capabilities on data in Aerospike.

Prerequisites

We support the connector on the following operating systems:

  • RHEL (8 and 9)/CentOS 7
  • Ubuntu 20.04
  • Ubuntu 22.04
  • Debian 10 (only on x86_64 hardware)
  • Debian 11

Change notification

You must configure your database to send change notifications in order to stream data from Aerospike. For details, see Configuring Change Notification for Use with Connectors.

Java

This connector is a Java web-application that requires Java 8 or later. If you plan to use TLS v1.3, then you must use Java 11 or later. Both Oracle and OpenJDK Java Runtime Environments are supported.

The Aerospike Elasticsearch Connector package does not include a Java runtime environment. Most supported platforms provide official JDK 8 packages. For platforms that do not, you can get Oracle's JDK 8 builds from jdk.java.net/8/.

RHEL/CentOS

sudo yum install java-1.8.0-openjdk

Debian/Ubuntu

sudo apt-get install openjdk-8-jre
  1. Install the connector. Go to the Aerospike Enterprise downloads site to download the connector package for your platform and install it.

RHEL/CentOS

sudo rpm -i aerospike-elasticsearch-outbound-1.0.0-1.noarch.rpm

Debian/Ubuntu

sudo dpkg -i aerospike-elasticsearch-outbound-1.0.0.all.deb

Docker

sudo docker run -p 8080:8080 -v
/home/aerospike/Downloads/aerospike-elasticsearch-outbound.yml:/etc/aerospike-elasticsearch-outbound/aerospike-elasticsearch-outbound.yml aerospike/aerospike-elasticsearch-outbound:1.0.0
tip

Remember to set the protocol based on the change notification source. See protocol for details.

  1. Start the connector. The connector package includes a Systemd service definition. The installation procedure creates an aerospike-UPDATE-ME service.

Enable the connector to start on system startup or reboot:

sudo systemctl enable aerospike-elasticsearch-outbound

Start the connector service:

sudo systemctl start aerospike-elasticsearch-outbound
  1. Configure the connector. The connector's configuration is in the /etc/aerospike-elasticsearch-outbound directory. For details on how to configure the Elasticsearch client, enable TLS, etc., please refer to the configuration guide.

Elasticsearch is a trademark of Elasticsearch BV, registered in the U.S. and in other countries.