KDB.AI Server Setup

This page details the steps to set up KDB.AI Server.

Hardware requirements

KDB.AI Server works on Intel, AMD, ARM, and Apple CPUs that meet the below specifications:

• Intel CPUs that support AVX2 instructions (Haswell architecture).

• AMD CPUs that support AVX2 instructions (Zen architecture).

• ARM (aarch64) CPUs that support NEON instructions.

• Apple MX CPUs (M1, M2, and M3) that support NEON instructions.

Software requirements

You can run KDB.AI Server under Docker or Rancher.

For demonstration purposes, the following steps provide guidance for running the KDB.AI Server under Docker:

1. A Linux kernel of 4.18.0 or later is required to run the KDB.AI container. Examples of such distros include:

   • CentOS 8 or later

   • Red Hat Enterprise Linux (RHEL) 8 or later

   • Ubuntu 18.04 or later

2. If you run KDB.AI Server on Windows, we recommend using the Windows Subsystem for Linux (WSL) instead of running it directly on Windows. This way, the volume mounts are from a Linux filesystem (for example, ext4) and avoid any related errors.

System requirements

The KDB.AI Server Standard Edition license is limited to 24 cores. When running the Docker container, if the machine contains more than 24 cores, adjust the Docker run command to include --cpuset-cpus, for example --cpuset-cpus 1-24. See step 3 of Start the KDB.AI docker image for more details. If you're using Rancher, make sure to tick dockered(moby) in General > Preferences > Container Engine > General.

Sign up

Ensure you have signed up for KDB.AI Server Edition here.

Having trouble finding the Welcome email? Expand for more.

1. Check your spam folder. The subject of the Welcome email is **Your KDB.AI Server: Standard Edition evaluation is ready**.

2. Add support@kdb.ai to the Safe senders list to prevent your personal or corporate antivirus or email protection software to block the email from being delivered.

3. Contact the [Support team].

Start the KDB.AI docker image

1. Create a location on the local disk to write data:

   Bash

   Copy

   mkdir vdbdata

2. Set permissions to read and write to this directory:

   Bash

   Copy

   chmod 0777 vdbdata

3. Log into the KX Docker registry using the email you signed up with and the Bearer Token string from your Welcome email:

   Python

   Copy

   docker login portal.dl.kx.com -u <the email you signed up with> -p <long Bearer Token string from your Welcome email>

   Run the container in detached mode, including the KDB_LICENSE_B64 string from your Welcome email:

   Python

   export KDB_LICENSE_B64=$(base64 -w 0 /<path-to-your-downloaded-license-file>/kc.lic)
   docker run -d \
       -p 8081:8081 \
       -p 8082:8082 \
       -e KDB_LICENSE_B64=$KDB_LICENSE_B64 \
       -e VDB_DIR="/tmp/kx/data/vdb" \
       -v "$PWD/vdbdata":/tmp/kx/data \
       -e THREADS="8" \
       portal.dl.kx.com/kdbai-db
      

4. Check if the KDB.AI container is running:

   Python

   Copy

   docker ps

   Do you receive an error message while running docker using sudo? Expand for more

   Add the -E flag so environmental variables like KDB_LICENSE_B64 are picked up. Therefore, the command becomes: -E docker ps.

Install the KDB.AI client

1. Install the latest version of KDB.AI client using pip from PyPI using the following command:

   Python

   REST

   Python

   Copy

   pip install kdbai-client

   Ensure curl is installed, for example:

   Shell

   Copy

   which curl

   KDB.AI supports Python (versions 3.8 to 3.11).

2. Establish and verify the connection with the KDB.AI Server:

   Python

   REST

   Python

   Copy

   import kdbai_client as kdbai
   session = kdbai.Session(endpoint='http://localhost:8082')
   database = session.database('default')
   print(database.tables)
   # expected response should be an empty list [] because you haven't created any tables yet

   Shell

   Copy

   curl http://localhost:8081/api/v2/ready
   # expected response 'OK'

Export the KDB.AI docker logs

If you encounter an issue, we recommend exporting your log file by running the following:

docker logs <your-container-name> > yourDocker.log 2>&1  

Send your log file yourDocker.log to the Support team.

Stop the KDB.AI docker image

If you wish you stop the KDB.AI Server, stop the container by running:

docker stop <your-container-name>

Next steps

Go to our Quickstart Guide page to set up your table schema and start inserting data.