Installing Aerospike Connect -- Aerospike to JMS
Installerโ
Starting with version 4.0.0
, a single installer handles both XDR connector 5.0 wire protocol and HTTP.
Go to the Aerospike Enterprise downloads
site to download and install 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
protocol for details.
Prerequisitesโ
Aerospike Database change notification configurationโ
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 Aerospike Connect for JMS on Docker Hub.
sudo docker run -p 8080:8080 -v /home/aerospike/Downloads/aerospike-jms-outbound.yml:/etc/aerospike-jms-outbound/aerospike-jms-outbound.yml aerospike/aerospike-jms-outbound:4.2.0
Installing on Linuxโ
Prerequisitesโ
Supported operating systemsโ
The connector is supported 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
- 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 on JMS outbound version 3.1.0 and later.
Compatibility with versions of Aerospike Database Enterprise Editionโ
If you are using Aerospike Database Enterprise Edition version 5.6 or later, ensure that you use version 3.0.0 or later of the JMS outbound connector.
If you are using Aerospike Database Enterprise Edition version 5.5 or earlier, you may use any version of the JMS outbound connector.
Installationโ
The installation steps below apply to both the Debian (*.deb) and Red Hat Enterprise Linux (RHEL) (*.rpm) packages. Significant differences between the supported platforms are pointed out.
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-jms-outbound-4.2.0-1.noarch.rpm
Debian, Ubuntu, etc.
sudo rpm -i aerospike-jms-outbound-4.2.0.all.deb
Verify/update connector configurationโ
The connector's configuration can be found in the /etc/aerospike-jms-outbound/
directory. For details on how to configure the JMS provider and enable
TLS, see 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-jms-outbound
To start the connector service run:
$ sudo systemctl start aerospike-jms-outbound