KDB Setup
~~~~~~~~~

Driverless AI allows you to explore KDB data sources from within the Driverless AI application. This section provides instructions for configuring Driverless AI to work with KDB.

KDB with No Authentication
''''''''''''''''''''''''''

This example enables the KDB connector without authentication. The only required flags are the hostname and the port.

1. Export the Driverless AI config.toml file or add it to ~/.bashrc. For example:

 ::

   export DRIVERLESS_AI_CONFIG_FILE="/config/config.toml"

2. Edit the following environment variables in the config.toml file. 

 ::

	# File System Support
	# file : local file system/server file system
	# hdfs : Hadoop file system, remember to configure the hadoop coresite and keytab below
	# s3 : Amazon S3, optionally configure secret and access key below
	# gcs : Google Cloud Storage, remember to configure gcs_path_to_service_account_json below
	# gbq : Google Big Query, remember to configure gcs_path_to_service_account_json below
	# minio : Minio Cloud Storage, remember to configure secret and access key below
	# snow : Snowflake Data Warehouse, remember to configure Snowflake credentials below (account name, username, password)
	# kdb : KDB+ Time Series Database, remember to configure KDB credentials below (hostname and port, optionally: username, password, classpath, and jvm_args)
	enabled_file_systems = "file, kdb"

	# KDB Connector credentials
	kdb_user = ""
	kdb_password = ""
	kdb_hostname = <ip_or_host_of_kdb_server>"
	kdb_port = "<kdb_server_port>"
	kdb_app_classpath = ""
	kdb_app_jvm_args = ""

3. Save the changes when you are done, then stop/restart Driverless AI.

KDB with Authentication Example
'''''''''''''''''''''''''''''''

This example provides users credentials for accessing a KDB server from Driverless AI. 

1. Export the Driverless AI config.toml file or add it to ~/.bashrc. For example:

 ::

   export DRIVERLESS_AI_CONFIG_FILE="/config/config.toml"

2. Edit the following environment variables in the config.toml file. 

 ::

	# File System Support
	# file : local file system/server file system
	# hdfs : Hadoop file system, remember to configure the hadoop coresite and keytab below
	# s3 : Amazon S3, optionally configure secret and access key below
	# gcs : Google Cloud Storage, remember to configure gcs_path_to_service_account_json below
	# gbq : Google Big Query, remember to configure gcs_path_to_service_account_json below
	# minio : Minio Cloud Storage, remember to configure secret and access key below
	# snow : Snowflake Data Warehouse, remember to configure Snowflake credentials below (account name, username, password)
	# kdb : KDB+ Time Series Database, remember to configure KDB credentials below (hostname and port, optionally: username, password, classpath, and jvm_args)
	enabled_file_systems = "file, kdb"

	# KDB Connector credentials
	kdb_user = "<username>"
	kdb_password = "<password>"
	kdb_hostname = <ip_or_host_of_kdb_server>"
	kdb_port = "<kdb_server_port>"
	kdb_app_classpath = ""
	kdb_app_jvm_args = ""

3. Save the changes when you are done, then stop/restart Driverless AI.


After the KDB connector is enabled, you can add datasets by selecting **KDB+** from the **Add Dataset (or Drag and Drop)** drop-down menu.

.. include:: ../add-kdb-dataset.frag