Non-interactive installation

Using the install.config file containing the necessary configuration options allows for a non-interactive deployment which can be fully automated.

The install.config file in the released Bundles will serve as a good starting point to fully automate your installation process.

Install config examples

Below are some example configuration files that could be used to deploy a certain type of application, the content should be put into a file and passed to the installation script.

./installKxPlatform.sh -p install.config.test

Note: For any options not explicitly defined, the default options will be accepted, see the Install Config Options section for more details.

Single server install

The settings below will deploy the Platform on a single server and accept all the default settings.

delta-install-dir=/path/to/install
delta-package-dir=/path/to/tgzpackages
license-dir=/path/to/license/files
# No changes under this line
no-prompt=1
accept-defaults=1
always-upgrade=1
always-overwrite=0
delta-package-auto-import=1
delta-install-type=3
delta-control-clustering=0
app-server-install-type=1

Daemon only

delta-install-dir=/path/to/install
delta-package-dir=/path/to/tgzpackages
DELTACONTROL_REMOTEHOST=control-host
DELTACONTROL_REMOTEPORT=2001
# No changes under this line
delta-install-type=2
accept-defaults=1

Cluster leader/follower

Configuration file below can be used on both the leader and follower nodes.

delta-install-dir=/path/to/install
delta-package-dir=/path/to/tgzpackages
auto-configure-instance-hostname-a=leader-hostname
auto-configure-instance-hostname-b=follower-hostname
auto-configure-instance-taskset=1
app-server-hostname-a=leader-hostname
app-server-hostname-b=follower-hostname
DELTACONTROL_PORT=2001
DELTACONTROL_REMOTEHOST=leader-hostname
DELTACONTROL_REMOTEPORT=2001
delta-control-clustering=1
delta-control-leader-hostname=leader-hostname
delta-control-leader-port=2001
delta-control-follower-hostname=follower-hostname
delta-control-follower-port=2001
no-prompt=1
accept-defaults=1
always-upgrade=1
always-overwrite=0
delta-package-auto-import=1
app-server-install-type=1
delta-install-type=3
tls-encryption-enabled=0

KDB/Web node split

KDB Node

delta-install-dir=/path/to/install
delta-package-dir=/path/to/tgzpackages
DELTACONTROL_PORT=2001
DELTACONTROL_REMOTEHOST=control-host
DELTACONTROL_REMOTEPORT=2001
delta-install-type=3
delta-control-clustering=0
delta-control-leader-hostname=control-host
delta-control-leader-port=2001
global-portstart=3000
auto-configure-instance-portstart=3000
auto-configure-instance-hostname-a=control-host
auto-configure-instance-taskset=1
app-server-hostname-a=web-host
app-server-taskset=1
app-server-install-type=1
web-node=0
kdb-node=1
no-prompt=1
accept-defaults=1
always-upgrade=1
always-overwrite=0
delta-package-auto-import=1
tls-encryption-enabled=0

Web Node

delta-install-dir=/path/to/install
delta-package-dir=/path/to/tgzpackages
DELTACONTROL_PORT=2001
DELTACONTROL_REMOTEHOST=control-host
DELTACONTROL_REMOTEPORT=2001
delta-install-type=2
delta-control-clustering=0
delta-control-leader-hostname=control-host
delta-control-leader-port=2001
global-portstart=3000
auto-configure-instance-portstart=3000
auto-configure-instance-hostname-a=control-host
auto-configure-instance-taskset=1
app-server-hostname-a=web-host
app-server-taskset=1
app-server-install-type=1
web-node=1
kdb-node=0
no-prompt=1
accept-defaults=1
always-upgrade=1
always-overwrite=0
delta-package-auto-import=1
tls-encryption-enabled=0

Extending the installation script

The KX Platform installation process can be extended by using the pre-install-script and post-install-script install config options. This allows scripts to be executed before or after the core installation script executed.

The install.config hooks allow a single script to be executed.