Version:

Quickstart

Single Machine Installation

1. Install the package

For Red Hat, Centos, and Fedora

sudo yum install gpudb-<version>.rpm

For Ubuntu

sudo apt-get gpudb-<version>

This installs the package to the directory /opt/gpudb , creates a user and group named 'gpudb' and a home directory in /home/gpudb. SSH keys are also created to allow password-less ssh access between machines for the gpudb user when configured as a cluster. This will also register Kinetica as a service.

2. Request a License

Run the program /opt/gpudb/core/bin/gpudb_keygen and send the output to your Kinetica support contact to receive a valid license.

3. Configure the instalation

Edit the configuration file /opt/gpudb/core/etc/gpudb.conf. There are many different parameters to adjust the behavior and tune Kinetica to best suit your machine's characteristics, but the defaults should provide reasonably good performance out of the box.

  1. A valid license key, received by email, must be entered for the parameter:

    license_key = ...
    
  1. The number of processes should be set to the number of GPUs on the machine plus one extra process for the 'head-node' HTTP server. For example, if your machine has four attached GPUs set the parameter:

    number_of_ranks = 5
    
  2. Specify which GPUs should be used by setting the parameters below. Note that the rank0 'head-node' HTTP server process can and should share the GPU with the first worker rank.

    rank0.gpu = 0 rank1.taskcalc_gpu = 0 rank2.taskcalc_gpu = 1 rank3.taskcalc_gpu = 2 rank4.taskcalc_gpu = 4

  3. Choose a directory to store the data in. Note that you can split where different types of data is stored if required.

    persist_directory = /opt/gpudb/persist

  4. If you will not be using Kibana, you can configure Kinetica to turn it off.

    enable_kibana_connector = false

4. Start Kinetica

Start Kinetica as the 'root' user by running

service gpudb start

Verify that Kinetica is running by browsing to http://<yourhostname>:8080/gadmin

Cluster Install

For installing a cluster, follow the instructions given here