Install config file
Custom install configuration files can be passed to the install scripts at execution time using the
Using the core installer
$ ./installKxPlatform.sh -p install.config.example
Using the bundle installer
$ ./install.sh -p install.config.example
Note: When running the
install.sh script with an install config file, the Platform will not start automatically.
install.config file can contain many types of options that will be used by the install scripts to configure the deployment of the KX Platform, all supported options can be found here.
With the KX Platform bundles, a default
install.config file is provided that contains many examples of options that can be set and parsed by the installation scripts. e.g.
#============================================================ # INSTALLATION OPTIONS #============================================================ # Install location for deploy delta-install-dir=$KX_INSTALL_DIR # Custom location for delta-data dir # delta-data-dir=/path/to/delta-data # Package location delta-package-dir=../packages # List of packages to exclude from deploy delta-exclude-packages= # Web node. If set only deploy web packages web-node=0 # KDB+ node. Deploy everything except web packages kdb-node=0 # No prompt no-prompt=1 # Accept installation default values accept-defaults=1 # Always upgrade installed packages always-upgrade=1 # Do not overwrite a package where the version is already installed always-overwrite=0 # Automatically import Delta Packages delta-package-auto-import=1 # Ignore OS specific package validation (Bundle should contain tgzs for target OS) ignore-os-package-validation=1 # Write tmp files inside the bundle directory (We cannot assume the size of /tmp) tmp-dir=../tmp
Install package lists¶
If you would like to have control over the packages which the installation script will install, you can use the property
install-package-list in the install.config file. Here you can add a comma separated list of packages which you would like to be installed. e.g.
If there are other packages available in the
delta-package-dir that are not in the
install-package-list, they will be ignored.
If you would like to explicitly exclude packages you can use the
delta-exclude-packages option which is a comma separated list of packages.
If you are performing an installation where you wish to deploy the KX Platform with 2 nodes including 1 KX Control Node and 1 Web Application Node, you can use the following options to define which packages are installed on the nodes.
For the KX Control node, set
kdb-node=1 in your install.config file. This will ensure that only core kdb+/Control components are installed on the server.
For the Web Application node, set
web-node=1, this will ensure that only the Web packages are installed, including Tomcat and the AppServer.
Installing Custom Packages¶
The installation script contains a predefined set of known packages that include the core KX Platform and other Solutions. If you create a new custom package and wish to install it, you can use the following options.
For a custom KX Control package you can add it to
custom-solution-package-list. Multiple packages can be defined in a comma separated list.
For a custom web package ( e.g. Themes ) you can add the package to the
custom-web-package-list option. This can only be used if
If you have a package that contains environment specific configuration and/or overwrites, you can add the package to the option
Note: environments packages will be installed last to overwrite default configuration within the solution packages.