1. Install the package
For Red Hat, Centos, and Fedora
sudo yum install gpudb-<version>.rpmFor 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.
A valid license key, received by email, must be entered for the parameter:
license_key = ...
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 = 5Specify 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
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
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 startVerify that Kinetica is running by browsing to
http://<yourhostname>:8080/gadmin