Learn how to install, upgrade, and uninstall Kafkorama Gateway on Ubuntu/Debian using a DEB package.
As mentioned in the Requirements section, the Kafkorama Gateway requires Java Runtime Environment (JRE) version 8 or later. For example, to install OpenJDK 8, run:
sudo apt-get install -y openjdk-8-jre-headless
Validate the installation:
java -version
You should see output similar to:
openjdk version "1.8.0_212"
OpenJDK Runtime Environment (build 1.8.0_212-b04)
OpenJDK 64-Bit Server VM (build 25.212-b04, mixed mode)
Download the Kafkorama Gateway as a DEB package and install it using the following command:
sudo dpkg -i kafkorama-gateway-<version>_<arch>.deb
Replace <version> and <arch> with the actual package version and architecture (e.g. 6.0.22_amd64.deb).
After installation, the following layout is created:
| Location | Description |
|---|---|
/etc/kafkorama-gateway/kafkorama-gateway.conf |
Default configuration file |
/etc/default/kafkorama-gateway |
System environment variables |
/etc/kafkorama-gateway/integrations/ |
Configuration files of add-ons |
/var/log/kafkorama-gateway/ |
Log directory |
/usr/share/kafkorama-gateway/kafkorama-gateway.jar |
Executable JAR |
/usr/share/kafkorama-gateway/extensions/ |
Plugins directory |
/usr/bin/kafkorama-gateway |
Start script |
/lib/systemd/system/kafkorama-gateway.service |
Systemd service unit |
/usr/share/doc/kafkorama-gateway/ |
Documentation and license files |
Refer to the Configuration Guide for instructions on customizing the default configuration and system settings.
The service is started automatically after installation. You can manage it using:
sudo systemctl start kafkorama-gateway
sudo systemctl stop kafkorama-gateway
sudo systemctl restart kafkorama-gateway
sudo systemctl status kafkorama-gateway
To test the installation, open a browser on the host machine and navigate to:
http://localhost:8800
127.0.0.1 with the remote machine's IP address or hostname.
Once your Kafkorama Gateway is running, the next step is to build real-time apps using your preferred programming language. Explore the available Kafkorama SDKs to get started.
To upgrade to a newer version, run:
sudo dpkg -i kafkorama-gateway-<newversion>_<arch>.deb
.dpkg-dist files.
To remove Kafkorama Gateway from your system, run:
sudo dpkg --purge kafkorama-gateway