Table Of Contents

4.3. Red Hat Installation

4.3.1. Software Installation

  1. Verify your system meets the Linux Requirements.

  2. Add the QuasarDB RPM repository to yum:

    $ echo $'[quasardb]\nname=QuasarDB repo\nbaseurl=\nenabled=1\ngpgcheck=0' > /etc/yum.repos.d/quasardb.repo
  3. Update your yum cache and verify you have the QuasarDB packages available:

    $ yum update
    $ yum --disablerepo=* --enablerepo=quasardb list available
    Available Packages
    qdb-api.x86_6          3.3.0-1    quasardb
    qdb-rest.x86_6         3.3.0-1    quasardb
    qdb-server.x86_6       3.3.0-1    quasardb
    qdb-utils.x86_6        3.3.0-1    quasardb
    $ yum install -y qdb-server-3.3.0-1 qdb-api-3.3.0-1 qdb-rest-3.3.0-1 qdb-utils-3.3.0-1
  4. (Optional) Lock the QuasarDB package versions

    $ yum install -y yum-plugin-versionlock
    $ yum versionlock qdb-*
  5. (Optional) enable the QuasarDB service and launch upon startup:

    $ systemctl enable qdbd
    $ systemctl start qdbd

The RPM package installs files as user qdb, group qdb, in the following locations:

File Types Path
Config /etc/qdb
Logs /var/log/qdb
Database /var/lib/qdb/db
Libs / Other /var/share/qdb

4.3.2. Configuration

By default, the quasardb daemon listens on the port 2836 on the local address and has secure authentication enabled.

  1. Edit the qdbd configuration file at /etc/qdb/qdbd.conf.
    • Set local::user::license_file to your license file path.
    • Add node IP addresses to local::chord::bootstrapping_peers to connect the node to a cluster.
    • Set local::network::listen_on to change the IP address and port qdbd uses.
    • Set other values as needed. See Config File Reference for more information.

To ensure satisfactory performance, we strongly encourage you to have a look at the tuning guide (Performance tuning).

4.3.3. Test the Node


By default quasarDB has secure authentication enabled. The location to the qdbsh key and the cluster public key may be different on your system.

  1. If you haven’t done so before, launch qdbd with sudo systemctl start qdbd
  2. Verify the qdbd service started without errors using sudo systemctl status qdbd
  3. Start qdbsh --cluster-public-key-file=/var/share/qdb/cluster_public.key --user-credentials-file=/etc/qdb/qdbsh_private.key and verify the node responds to commands. Make sure you have read access to both files.
  4. Test the node for TCP configuration problems with qdb_max_conn.

4.3.4. Test the Cluster

  1. Benchmark the cluster with qdb-benchmark. See quasardb benchmarking tool for more information.
4.2. Windows Installation
Next arrow_forward
4.4. Debian Ubuntu Installation