2.1. An installation tutorial for people with very little time

A minimal quasardb setup requires deploying the quasardb daemon on a single server and making sure that the client can access it.

Important

A valid license is required to run the daemon (see License). In the examples below, we will use the default path and filename of “qdb_license.txt”. Ensure your license file is properly named and placed in same folder as qdbd before continuing.

2.1.1. Installing a quasardb daemon in three steps

  1. Download the appropriate server for your platform (FreeBSD, Linux or Windows) from quasardb download site. All download information is in your welcome e-mail.

  2. Install the server

    • On FreeBSD and Linux you just need to expand the tarball.
    • On Windows it comes as an automated setup, which includes both the 32-bit and the 64-bit version.
  3. Generate a default configuration file using the command line.

    The command is:

    qdbd --gen-config > qdbd_default_config.conf
    

    The daemon will by default listen on the IPv4 localhost, on the port 2836, persist its content to the disk asynchronously, limit itself to 1,000,000 entries, and will not log at all. See quasardb daemon for more configuration options.

  4. Run the daemon from the command line.

    The command is:

    qdbd -c qdbd_default_config.conf
    

2.1.2. Using the quasardb shell to test your quasardb installation

The quasardb shell offers an interactive mode from which the user can enter commands. The name of the binary is qdbsh and it is included in the server package.

  1. Run qdbsh.

    The command is:

    qdbsh
    

    By default qdbsh will connect to a quasardb daemon using the default settings of localhost, port 2836. If you have edited the qdbd configuration file already, for example to make the qdbd daemon run on 192.168.1.1 and listen on port 303 - you will run qdbsh as such:

    qdbsh --daemon=192.168.1.1:303
    

    See quasardb shell for detailed configuration options.

  2. Add and get an entry from the server:

    ok:qdbsh> put entry thisismycontent
    ok:qdbsh> get entry
    thisismycontent
    ok:qdbsh> exit
    

Type help to get a list of available commands. See quasardb shell for more information.

2.1.3. Monitoring your installation from a web server

quasardb comes with a web bridge in the form of an HTTP daemon. This web bridge can be used to monitor your quasardb daemon remotely. It is updated in real time so the information displayed by the web server is as fresh as it can be. The name of the binary is qdb_httpd and it is included in the server package.

All information is available in both JSON and JSONP format.

  1. Generate a default configuration file for the web bridge.

    The command is:

    qdb_httpd --gen-config > qdb_httpd_default_config.conf
    

    By default, the web bridge will listen on localhost, port 8080. It will connect to a quasardb daemon using the default settings of localhost, port 2836. See quasardb web server for detailed configuration options.

  2. Run the web bridge.

    The command is:

    qdb_httpd -c qdb_httpd_default_config.conf
    
  3. Test it from a browser

    The primary node monitoring interface is an HTML 5 web interface. If using the default settings, simply point your browser to:

    http://127.0.0.1:8080/view/index.html
    

    You can also access the statistics in JSON format. The global statistics URL is /global_status:

    http://127.0.0.1:8080/global_status
    

    If you want the content in JSONP format, the URL becomes:

    http://127.0.0.1:8080/global_status?callback=MyCallBack