Skip to main content
Loading

Install Aerospike Connect for Elasticsearch

Download the installerโ€‹

Go to the Aerospike Enterprise downloads site to download the connector package for your platform. The connector is supported on both amd64 and arm64 architectures.

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

Prerequisitesโ€‹

Aerospike Database change notification configurationโ€‹

note

Streaming from Aerospike requires you to configure your Aerospike database to send change notifications. For the steps, see Configuring Change Notification for Use with Connectors.

Deploying on Dockerโ€‹

Aerospike provides Docker images for the Aerospike connect for Elasticsearch on Docker Hub. Choose the version compatible with your Aerospike database.

sudo docker run -p 8901:8901 -v
/home/aerospike/Downloads/aerospike-elasticsearch-outbound.yml:/etc/aerospike-elasticsearch-outbound/aerospike-elasticsearch-outbound.yml aerospike/aerospike-elasticsearch-outbound:2.2.0

Installing on Linuxโ€‹

Prerequisitesโ€‹

Supported operating systemsโ€‹

The connector is supported on the following operating systems:

  • RHEL (8 and 9)
  • Ubuntu 20.04
  • Ubuntu 22.04
  • Ubuntu 24.04 LTS
  • Debian 11
  • Debian 12

Java Runtime Environmentโ€‹

This connector is a Java web-application that requires Java 11 or later. Both Oracle and OpenJDK Java Runtime Environments are supported.

Java 17 is supported in Elasticsearch outbound version 1.0.1 and later.

Installationโ€‹

The following installation steps apply to both the Debian (*.deb) and RHEL (*.rpm) packages. We point out any significant differences between the supported platforms.

Install Javaโ€‹

Install Java 11 or later, if it is not already installed.

RHEL or CentOS

sudo yum install java-11-openjdk

Debian or Ubuntu

sudo apt-get install openjdk-11-jre

Install connector packageโ€‹

Go to the Aerospike Enterprise downloads site to download the connector package for your platform and install it.

RHEL (8 and 9), CentOS, etc.โ€‹

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

Debian/Ubuntuโ€‹

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

Verify connector configurationโ€‹

Verify the connector's configuration in the /etc/aerospike-elasticsearch-outbound/ directory, and update if necessary. For configuration details, refer to the configuration guide.

Start the connectorโ€‹

The connector package includes a systemd service definition. The installation procedure creates an aerospike-jms-outbound service.

Enable the connector to start on system startup or reboot:

$ sudo systemctl enable aerospike-elasticsearch-outbound

To start the connector service run:

$ sudo systemctl start aerospike-elasticsearch-outbound

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