Installation and quick start guide

This guide will show you how to quickly get Raijin set up and running.

GNU/Linux

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 [.command]#*`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).

Configuring Raijin on GNU/Linux

For the purpose of this quick start, the default configuration is sufficient. For customizing the configuration, please refer to the configuration file /opt/raijin/conf/raijin.conf which contains all the available parameters with their default values and descriptions, or see the Configuration parameters chapter.

The server should be restarted for any configuration changes to take effect.

Running queries

Using the web-based UI

The Raijin server installation includes a web-based UI. To use it, open localhost:2500 in a web browser.

Running simple queries

After your server is installed and running, you can use the web-based client to get some hands-on experience with Raijin.

Creating a database

To create a database named example, try:

CREATE DATABASE example;

Upon success, you should see the "OK" result.

Creating tables

Next, you would probably like to create some table in your new database:

CREATE TABLE example.tbl(a BOOL, b INT);

Now, let’s populate it with some data:

INSERT INTO example.tbl(a, b) VALUES (true, 1);

Both of these commands should return the "OK" result.

Retrieving data

Now that we have some data, we can retrieve it by running a SELECT query:

SELECT * FROM example.tbl;

The results are returned in JSON format:

{"_id":1,"a":true,"b":1}

What’s next?

If you would like to delete the database and table used in this exercise, drop the database:

DROP DATABASE example;