Deploy JMS inbound connector

Prerequisites

The following operating systems are supported for instances of the JMS inbound connector:

RHEL/CentOS (8 and 9)
Ubuntu (20.04, 22.04 and 24.04 LTS)
Debian (11 and 12)
Amazon Linux 2023

Install on Linux

The connector is supported on both amd64 and arm64 architectures. Follow these steps on the system or systems where you plan to run the connector:

Version 2.0.0 and later
Version 1.1.0 and earlier

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

RHEL or CentOS

sudo yum install java-17-openjdk

Debian or Ubuntu

sudo apt-get install openjdk-17-jre

Amazon Linux

sudo dnf install java-11-openjdk

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

RHEL or CentOS

sudo yum install java-1.8.0-openjdk

Debian or Ubuntu

sudo apt-get install openjdk-8-jre

Install the connector package

Go to the Aerospike Enterprise downloads site to download the connector package for your operating system. After downloading the package, run either of these commands:

RHEL or CentOS
Terminal window
```
sudo rpm -i aerospike-jms-inbound-3.0.12-1.noarch.rpm
```
Debian or Ubuntu
Terminal window
```
sudo dpkg -i aerospike-jms-inbound-3.0.12.all.deb
```
Amazon Linux
Terminal window
```
sudo rpm -i aerospike-jms-inbound-3.0.12-1.noarch.rpm
```
Install the Aerospike Database Enterprise Edition feature-key file

feature-key-file is deprecated in version 2.0.0. Verify that the feature file with the feature key mesg-jms-connector turned on and is loaded into the Aerospike server. The feature key is read directly from the Aerospike server.

Download the feature-key file and put in at the desired location which is accessible to the connector at runtime. The property mesg-jms-connector feature must be enabled in the feature key file.
Enable connector auto start

Run this command to enable the connector to start on system startup or reboot:
Terminal window
```
sudo systemctl enable aerospike-jms-inbound
```
Run this command to start the connector:
Terminal window
```
sudo systemctl start aerospike-jms-inbound
```

Deploy on Docker

Aerospike provides Docker images for the Aerospike connect for JMS Inbound on Docker Hub.

sudo docker run \
 -v <path to local aerospike-jms-inbound.yml>:/etc/aerospike-jms-inbound/aerospike-jms-inbound.yml \
 container.aerospike.com/aerospike/aerospike-jms-inbound:3.0.12

<path to local aerospike-jms-inbound.yml>: The path (including the name) of the configuration file in your local filesystem.