Installation

Note: This section does not apply to RioDB Cloud.

Instructions to install and run RioDB software on-premise.

1 – Install Java JDK 17

RioDB requires JDK 17. For example:
OpenJDK: https://openjdk.java.net/install/
Corretto: Downloads for Amazon Corretto 17 – Amazon Corretto 17
To check that OpenJDK is your default java environment:

java -version

2 – Install RioDB

Contact us to obtain the latest copy of RioDB, and a license key.
Download and extract (unzip or tar) the archive into the directory where you want RioDB to run.
Ensure that RioDB has access to open ports (Windows Firewall, or Linux firewalld service).

If you are just checking it out, that’s it. Just run it with default settings.
Otherwise, be sure to check the Settings page for configuration options.

3 – Running Standalone

Windows (with administrative access to open ports):

riodb.bat

Linux (using sudo to open network ports):

sudo ./riodb.sh

4 – Running as a Service

For Linux, we recommend running our install-riodb.sh script that will automatically configure the following:
– Create riodb user and riodb group
– Install the software under /opt/riodb-01/riodb
– Create log directory /var/log/riodb
– Run keytool command to generate a new self-signed key pair for the RioDB API SSL certificate. A MUST!
– Generate the file riodb/conf/jvm.options with JVM properties suited for your system resources
– Create the riodb.service for SystemCTL, enabled it, and reload the SystemCTL daemon
– Ensure the riodb.service points the RioDB runtime logging to /var/log/riodb directory
– Update permissions for all riodb directories and files

After this, you are ready to start RioDB:

sudo systemctl start riodb