Table Of Contents

4.7. Docker Installation

Docker is currently not recommended for production.

4.7.1. Available docker images

We currently offer the following images:

  • qdb - The quasardb daemon
  • qdb-http - The quasardb web console
  • qdb-dev - A daemon with the quasardb API for development purposes
  • qdb-dev-python - A daemon with the Python API and pre-installed tools

4.7.2. Tags

The following tags are used:

  • lts: Long term service release
  • latest: The latest release
  • nightly: the nightly build

Every release is also tagged with its version number. For example, 2.0.1 has the following tags: lts, 2, 2.0 and 2.0.1.

4.7.3. Software Installation

Depending on your host operating system, all of the following docker commands may require root permissions.

  1. Verify your system meets the System Requirements.
  2. Install Docker for your host operating system.
  3. Install the qdb image using docker pull bureau14/qdb.
  4. Install the qdb-http image using docker pull bureau14/qdb-http.

4.7.4. Configuration

  1. Connect to the qdb-server using docker exec -ti qdb-server /bin/bash.
  2. Edit the qdbd configuration file using vi /etc/qdb/qdbd.conf.
    • Add node IP addresses to local::chord::bootstrapping_peers to connect the node to a cluster.
    • Set other values as needed. See Config File Reference for more information.
  3. Exit the qdb-server docker using exit.
  4. Determine which host directory will contain your database and license file. The required size depends on your use case, see Database Storage.
  5. Copy the license file to the database directory.
  6. (optional) Connect to the qdb-http-server using docker exec -ti qdb-http-server /bin/bash.
  7. (optional) Edit the qdb_httpd configuration file using vi /etc/qdb/qdb_httpd.conf.
  8. (optional) Exit the qdb-http-server docker using exit.

4.7.5. Test the Node

  1. Run the qdb image using docker run -d -p 2836:2836 -v <db-dir>:/var/lib/qdb --name qdb-server bureau14/qdb where <db-dir> is the database directory you selected above.
  2. (optional) Run the qdb-httpd image, connecting it to the qdb-server image using docker run --link qdb-server:db -d -p 8080:8080 --name qdb-http-server bureau14/qdb-http.
  3. Verify the qdb-server and qdb-http-server docker images started without errors using docker ps.
  4. Test the node for TCP configuration problems with qdb_max_conn.

4.7.6. Test the Cluster

  1. Benchmark the cluster with qdb-benchmark. See quasardb benchmarking tool for more information.
arrow_backPrevious
4.6. FreeBSD Installation
Next arrow_forward
4.8. Amazon Web Services Installation