Installation

This guide will show you how to quickly set up and run Raijin Database Engine.

Supported platforms

The following operating systems and architectures are fully supported.

Table 1. Supported GNU/Linux platforms
Operating System Architectures

Redhat Enterprise Linux 7

x86_64

Redhat Enterprise Linux 8

x86_64

SUSE Linux Enterprise Server 15

x86_64

Debian 9

x86_64

Debian 10

x86_64

Debian 11

x86_64

Ubuntu LTS 18.04

x86_64

Ubuntu LTS 20.04

x86_64

Generic RPM

x86_64

Generic DEB

x86_64

Installing from DEB packages

Installing dependencies

To list the dependencies, use the following command:

$ dpkg-deb -f raijin_amd64.deb Depends

Then make sure all listed dependencies are installed. Alternatively you can run apt-get install -f after trying to install the package with dpkg and getting an error due to the missing dependencies.

Installing the DEB package

To install the DEB package, run the following command as root:

# dpkg -i raijin_amd64.deb

Installing from RPM packages

Install the RPM package with the following command:

# rpm –ivh raijin.x86_64.rpm

Running Raijin server

As soon as the installation process is successfully completed, the raijin-server service is registered as a systemd service and automatically started. In order to manually control raijin-server, you can make use standard systemctl utility, e.g:

systemctl restart raijin-server

For the full list of possible commands and options see systemctl(1).

Installing and running Raijin server as a Docker application

To install and run Raijin as a Docker application, both the Docker Engine and the Docker Compose tools are required. For more information on installing Docker, consult the Get Docker documentation on Docker’s website.

The procedure is identical on all platforms that Docker supports.

  1. Download the Raijin Docker archive from the Downloads page.

  2. Extract the files from the compressed Docker archive.

    1. On Linux and macOS, you can use the following command.

      # tar zxf raijin-server_X.X.XXXX-docker.tar.gz
    2. On Windows, you can use a third-party tool like 7-Zip.

  3. After extracting the archive, change to the newly created directory where you should see the following files:

    • docker-compose.yml

    • Dockerfile

    • raijin.conf

    • raijin-server_X.X.XXXX_amd64.deb

    • README-txt

  4. To build, create, and start the container, execute the following command.

    # docker-compose up -d

    To recreate the container, execute the following command.

    # docker-compose up -d --build

    You can configure the port numbers in the docker-compose.yml file.

        ports:
          - "2500:2500"
        restart: always
    By default, the Raijin Docker container uses a separate volume for data to avoid any potential data loss during container updates.

Upgrading Raijin

Upgrading Raijin Database Engine to a newer version is very straightforward. Download the package for your OS and execute the following commands.

We recommend backing up the configuration and data folders before initiating an upgrade. The default folder locations are:

  • /opt/raijin/conf

  • /opt/raijin/data/db

Prior to Raijin Database Engine 1.5 the content stored in the /opt/raijin/data/db folder was stored in the /opt/raijin/data folder. If you’re upgrading from a version older than 1.5, you should instead back up the /opt/raijin/data folder. You will need to manually move your database from /opt/raijin/data to /opt/raijin/data/db.

To upgrade from the DEB package:

# dpkg -i raijin_amd64.deb

To upgrade from the RPM package:

# rpm –ivh raijin.x86_64.rpm

To upgrade Raijin Database Engine running as a Docker application:

  1. Back up the configuration and data folders.

  2. Download the new image and follow the instructions to install Raijin as a Docker application.

  3. Stop the Raijin service:

    # systemctl stop raijin-server
  4. Replace the configuration and data folders with the ones copied in step 1.

  5. Start the Raijin service:

    # systemctl start raijin-server