Installing

Download¶

Free 64-bit kdb+ on-demand Personal Edition: Kdb+ on-demand 64-bit Personal Edition is for personal, non-commercial use. It may be used freely on up to 2 computers, and up to a maximum of 16 cores per computer, but is not licensed for use on any cloud – only personal computers. It requires an always-on internet connection to operate, and may be downloaded from ondemand.kx.com
Free 32-bit kdb+ Personal Edition: The free 32-bit version of kdb+ (for non-commercial use) can be downloaded from kx.com. Follow the instructions.
Commercial versions: Commercial versions of kdb+ are distributed to customers from downloads.kx.com. (Credentials for this site are issued to customers’ Designated Contacts).

Internal distribution

Most customers download the latest release of kdb+ and make that (along with the accompanying README.txt, the change list) available from a central file server.

Encourage your developers frequently to fold the latest release of kdb+ into their development cycle, and match the version used in production. This can greatly simplify development, deployment and debugging.

The names of the downloaded ZIPs denote the platform (l64.zip – 64-bit Linux; w32.zip – 32-bit Windows, etc.).

Test versions

Numerical release versions of the form 2.8, or 3.2 are production code. Versions of kdb+ with a trailing t in the name such as 3.3t are test versions and are neither intended nor supported for production use.

macOS¶

If necessary, unzip the archive. A new folder q will appear in your Downloads folder.

Next perform the Minimum install and launch. We then strongly recommend continuing to Complete install and launch.

Minimum install and launch¶

Open the Terminal application (Bash). It will prompt you with its own version of the following:

Mark:~ sjt$

Answer the prompts as follows:

Answer the prompts like this.

You have installed and launched kdb+.

To exit from kdb+, type \\

Complete install and launch¶

The minimum installation can be improved in two important ways. We strongly recommend them.

Call kdb+ within the rlwrap command, which will allow you to call back and edit previous lines
Define q as a command, allowing you to invoke kdb+ without specifying the path to it

Install Rlwrap¶

Exit kdb+ to return to the Bash prompt and your home folder. Ask for Rlwrap’s version number. If you see one, Rlwrap is already installed

rlwrap -v

If Rlwrap is already installed you can go on to the next step.

Otherwise, you will be told rlwrap: command not found. Install Rlwrap using your package manager. (Probably either MacPorts or Homebrew)

Edit your profile¶

In Bash, open your profile ~/.bash_profile with TextEdit (or your favourite text editor)

open -a Textedit .bash_profile

and append the following line

alias q='QHOME=~/q rlwrap -r ~/q/m32/q'

and save it. Tell Bash to use the revised profile:

source .bash_profile

Confirm installation¶

From your home folder open q, type an expression and recall it using the up-arrow key:

In q, type an expression and recall it with the up-arrow key

You’re done. You have completely installed kdb+. See what’s next.

Microsoft Windows¶

This will put a file windows.zip in your Downloads folder. Extract the files to C:\, producing a new folder C:\q. (You can install on a different filepath. If you do, in the following instructions simply replace C:\q with your filepath.)

Confirm q is working¶

Open a command shell window: type Windows-r (or click the Start button) and type cmd.

Launch q by typing C:\q\w32\q. You should see the kdb+ banner, followed by the q) prompt. Type til 6 to see the first 6 integers. Type \\ to exit q.

C:32

Define q as a command¶

Defining q as a command allows you to invoke kdb+ without specifying the path to it.

In the MS-DOS shell, type

setx QHOME "C:\q"
setx PATH "%PATH%;C:\q\w32"
exit

Setting environment variables

This will close your shell session. Open a new shell session and confirm q now works as a command.

Confirm q works as a command

You’re done. You have completely installed kdb+. See what’s next.

Linux¶

Open a Bash session (eg LXTerminal) in your home folder and cd to your Downloads folder. Unzip the archive. A new folder q will appear in your Downloads folder. Copy it to your home folder and cd there.

cd ~/Downloads unzip linux-x86.zip cp -r q ~/. cd ~

32-bit or 64-bit?¶

Use the uname command to determine whether your machine is using the 32-bit or 64-bit Linux distribution.

uname -m

Determining the distribution bit size

If the result is i686 or i386 or similar, you are running a 32-bit distribution. If the results is x86_64, you are running a 64-bit distribution.

If you are installing 32-bit kdb+ on a 32-bit Linux distribution, proceed to Launch (minimum install).

But if you are installing 32-bit kdb+ on a 64-bit Linux distribution, you will need a 32-bit library. Use your usual package manager to install i686 or i386: for example:

sudo apt-get install libc6-i386

Minimum install and launch¶

Confirm that kdb+ runs. In your home folder, type:

q/l32/q

Launching q

to see the kdb+ banner and the q) prompt. Type til 6 to see the first six integers. Type \\ to return to Linux.

You have completed the minimum installation. We recommend proceeding to the Complete install and launch.

Complete install and launch¶

The minimum installation can be improved in two important ways. We strongly recommend them.

Call kdb+ within the rlwrap command, which will allow you to call back and edit previous lines
Define q as a command, allowing you to invoke kdb+ without specifying the path to it

Install Rlwrap¶

Exit kdb+ to return to the Bash prompt and your home folder. Ask for Rlwrap’s version number. If you see one, Rlwrap is already installed

Exit q and see if Rlwrap is installed

If Rlwrap is already installed you can go on to the next step.

Otherwise, you will be told rlwrap: command not found. Install Rlwrap using your package manager.

Edit your profile¶

In the File Manager, find .bashrc in your home folder.

Bash profile

Open it with a text editor and append the following line

alias q='QHOME=~/q rlwrap -r ~/q/l32/q'

and save it. Tell Bash to use the revised profile: source .bashrc

source .bashrc

Confirm installation¶

From your home folder open q, type an expression and recall it using the up-arrow key:

In q, type an expression and recall it with the up-arrow key

You’re done. You have completely installed kdb+.

Licenses¶

Usage of the free, non-commercial 64-bit distribution of kdb+ on demand is governed by the terms and conditions on the download page.

Usage of the free, non-commercial 32-bit distribution of kdb+ is governed by the terms and conditions on the download page.

64-bit distributions of kdb+ require a license file to run. Without it, they signal a license error and abort.

License errors, Licenses, Linux production notes

Installing elsewhere¶

You can install kdb+ where you please. The environment variable QHOME (specified in the instructions above) tells kdb+ where its home folder is.

What’s next?¶

Get started with the q programming language, look through the reference card, or see what you can do with kdb+ in the Cookbook section.