Download and Install Kinetica

This tutorial will walk you through how to download and install Kinetica. It’s a quick process, and you should be done in 5 minutes.

License Key

No Key, No account
Kinetica requires a license key to activate the product.  Please register for your key.

System Requirements

You can install Kinetica on a virtual machine, container, Azure instance, or standalone server. The installation instructions on this page only support a single machine, but if you wish to install Kinetica on distributed hardware, please look at the following documentation links or feel free to contact us. When you’re done installing, come back and join us for a Walkthrough of Kinetica

If you plan to use distributed hardware, you should be aware that the Trial Edition of Kinetica will only support clusters with no more than 3 unique Hosts.

GPU or CPU?

We provide two versions of the trial edition:

  • One version is for machines with GPUs, which is better for evaluating performance.
  • Alternatively, there is a version for CPU-only machines, which is better for simply evaluating features and functionality. You can easily install this version on a laptop using a Docker container or virtual machine.

Recommended Minimum Configuration

CPU Two-socket based server with at least 8 cores Intel x86-64 or Power PC 8le
GPU (Optional) Kinetica supports NVIDIA GPUs. We recommend K20, K40, K80, P100, GTX Ti780, Tegra, or similar.
Operating System RHEL/CentOS
Debian/Ubuntu
SUSE
Memory Kinetica is an in-memory database. You’ll need at least enough system RAM to hold your data plus server resources. We recommend at least 8GB RAM for Trial
Disk We recommend 4x RAM – although actual amount depends on workload, store_only columns, swap, etc.

Step 1: Install

Kinetica can be installed through package managers.

Don’t have any of the supported OS types?
If you are not using a Linux OS, such as Windows or macOS, we recommend installing Kinetica using Docker, which you can download from their Installation Page. Or, if you have a Linux distribution that is not supported (see the table below), we recommend using a virtual machine.

Platform x86 ppc64le
Debian/Ubuntu
RHEL/CentOS
SUSE

On Debian/Ubuntu:

Execute the below commands on your Ubuntu machine from a shell prompt.

wget -O - http://repo.kinetica.com/debian/6.2.0/Ubuntu/trusty/binary-amd64/keyFile | sudo apt-key add -

Next, depending on your server platform, please enter in one of the following commands:

sudo sh -c 'echo "deb http://repo.kinetica.com/debian/6.2.0/Ubuntu/trusty/binary-amd64 ./" >> /etc/apt/sources.list'

sudo sh -c 'echo "deb http://repo.kinetica.com/debian/6.2.0/Ubuntu/trusty/binary-ppc64el ./" >> /etc/apt/sources.list'

Then,

sudo apt update

Now, depending on whether you are on a CPU or a GPU machine:

CPU Only

Enter in one final command:

sudo apt install gpudb-intel-license

With GPUs

Ensure that the NVIDIA CUDA drivers are already installed before proceeding with this final command.

sudo apt install gpudb-cuda91-license

This installs the package to the directory /opt/gpudb, creates a group named gpudb, and two users (gpudb & gpudb_proc) whose home directory is located at /home/gpudb. SSH keys are also created to allow password-less SSH access between servers for the gpudb user when configured as a cluster. This will also register two services: gpudb & gpudb_host_manager.

On RHEL/CentOS:

Execute the below commands on your RHEL/CentOS machine from a shell prompt, according to your server platform.

sudo wget -O /etc/yum.repos.d/kinetica-6.2.0.repo http://repo.kinetica.com/yum/6.2.0/CentOS/7/x86_64/kinetica-6.2.0.repo

sudo wget -O /etc/yum.repos.d/kinetica-6.2.0.repo http://repo.kinetica.com/yum/6.2.0/CentOS/7/ppc64le/kinetica-6.2.0.repo

Then,

sudo yum update

Now, depending on whether you are on a CPU or a GPU machine:

CPU Only

Enter in one final command:

sudo yum install gpudb-intel-license

With GPUs

Ensure that the NVIDIA CUDA drivers are already installed before proceeding with this final command.

sudo yum install gpudb-cuda91-license

This installs the package to the directory /opt/gpudb, creates a group named gpudb, and two users (gpudb & gpudb_proc) whose home directory is located at /home/gpudb. SSH keys are also created to allow password-less SSH access between servers for the gpudb user when configured as a cluster. This will also register two services: gpudb & gpudb_host_manager.

On SUSE:

Execute the below commands on your SUSE machine from a shell prompt.

sudo zypper addrepo http://repo.kinetica.com/yum/6.2.0/SLES/12sp2/x86_64/kinetica-6.2.0.repo

Then,

sudo zypper update

Now, depending on whether you are on a CPU or a GPU machine:

CPU Only

Enter in one final command:

sudo zypper install gpudb-intel-license

With GPUs

Ensure that the NVIDIA CUDA drivers are already installed before proceeding with this final command.

sudo zypper install gpudb-cuda91-license

This installs the package to the directory /opt/gpudb, creates a group named gpudb, and two users (gpudb & gpudb_proc) whose home directory is located at /home/gpudb. SSH keys are also created to allow password-less SSH access between servers for the gpudb user when configured as a cluster. This will also register two services: gpudb & gpudb_host_manager.

On Docker:

Depending on whether you are on a CPU or a GPU machine:

CPU Only

At a shell with appropriate privileges, issue the following commands:

sudo docker pull kinetica/kinetica-intel

Then,

docker run --privileged --rm -p 8080:8080 -p 8088:8088 -p 9191:9191 -p 9292:9292 kinetica/kinetica-intel:latest 

The shell should print out a series of start-up confirmations, similar to the screenshot shown below:

After this is printed, docker will wait for you to enter your license key, meaning you are ready for Configuration…

With GPUs

Some additional requirements are necessary:

At a shell with appropriate privileges issue the following commands:

sudo docker pull kinetica/kinetica-cuda91

Then,

docker run --privileged --rm --runtime=nvidia -p 8080:8080 -p 8088:8088 -p 9191:9191 -p 9292:9292 kinetica/kinetica-cuda91:latest 

Step 2: Configure

Now that the application has been deployed, you should be able to access the administration dashboard (GAdmin) to configure and start the service.

GAdmin should be running on port 8080. Open a browser and enter the following url, making sure to insert the correct host name or IP.

http://<hostname>:8080/

Trouble Accessing Your Server? Check the firewall
If you are unable to access the port 8080 outside your localhost, check your host firewall settings and ensure that the ports are open. You can disable the firewall selectively.
More details of the ports used by Kinetica

For a local install you can disable the firewall for convenience sake. (Do not do this in a production environment).

On Ubuntu

sudo ufw disable

On RHEL

sudo service iptables stop
chkconfig iptables off

Once you’ve arrived at the login page, log into the admin application with the default credentials below:

Username: “admin”
Password: “admin”

Step 3: Enter License Key

Upon logging in for the first time, you will be presented with the activation page. Here, you can enter the license key that you received in your email during the registration process.

Once you’ve typed it in, you can click Activate and then confirm the activation.

In the next step you’ll be asked to review the configuration page. We recommend you accept the default configuration.

Step 4: Start Service

Now we’re ready to get going. From the ‘Admin’ tab on the left, start the service. This will start all Kinetica processes.

Once you hit continue, you should navigate to the dashboard page and you should see your server up and running.

Step 5: Validate the Server is Working

There are two ways to check if Kinetica is working:

Test with curl

$ curl localhost:9191
Kinetica is running!

Check within GAdmin

In GAdmin, navigate to Info > Diagnostics. You should see success in the results column.

Screen Shot 2017-11-03 at 10.37.16 AM.png

TroubleShooting

If the server has not started, take a look at the Troubleshooting Guide

If your problems are not addressed here, please post in the Kinetica Forums.

Next: Walkthrough of Kinetica »

Kinetica Trial Feedback