Table Of Contents

4.4. Debian Ubuntu Installation

4.4.1. Software Installation

  1. Verify your system meets the Linux Requirements.

  2. Add the QuasarDB apt repository as follows:

    $ echo "deb [trusted=yes] /" > /etc/apt/sources.list.d/quasardb.list
    $ apt install apt-transport-https ca-certificates
    $ apt update
    Get:15  Packages [1,068 B]
  3. Update the repository and install the packages you want:

    $ apt search qdb
    c   qdb-api
    c   qdb-rest
    c   qdb-server
    c   qdb-utils
    $ apt install qdb-server qdb-api qdb-rest qdb-utils


    QuasarDB currently ships nightly versions to the apt repository. If you wish to install and lock the latest stable version, please do so as follows:

    apt install qdb-server=3.3.0-1 && aptitude hold qdb-server

The Debian packages install as user qdb, group qdb, in the following locations:

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

4.4.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.4.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. Start qdbd with sudo service qdbd start
  2. Verify the qdbd service started without errors using sudo service qdbd status
  3. Start qdbsh --cluster-public-key-file=/usr/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.4.4. Test the Cluster

  1. Benchmark the cluster with qdb-benchmark. See quasardb benchmarking tool for more information.
4.3. Red Hat Installation
Next arrow_forward
4.5. Other Linux Installation