Upgrading Refinery and packages

Refinery upgrades

You can upgrade Refinery using the CLI. The updated Refinery bundle must be downloaded prior to the upgrade and can be done so using the CLI:

refinery install --download <refinery-version>

Valid kdb+ (k4.lic) and Delta (delta.lic) licence files for the host must be downloaded and an install.config file must be used in the upgrade process.

The following configuration is enforced:

  • delta-data-dir: Must be set and cannot be the same as delta-install-dir

  • fail-on-duplicate-port: Must be set to 1

  • always-upgrade: Must be set to 1

  • always-overwrite: Must be set to 1

A sample install.config is as follows:

# Install location for deploy
delta-install-dir=/root/kxinstall/

# Custom location for delta-data dir
delta-data-dir=/root/data/

# Package location
delta-package-dir=../packages

# List of packages to exclude from deploy
fail-on-duplicate-port=1

skip-secure-deploy=1

no-prompt=1

# Accept installation default values
accept-defaults=1

# Always upgrade installed packages
always-upgrade=1

# Always overwrite installed packages even with same version
always-overwrite=1

# 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

Refinery can now be upgraded with the following command:

shell-session refinery install --install <refinery-version> \ --install-config <PATH_TO_INSTALL_CONFIG>/install.config \ --license <PATH_TO_LICENCE_FILES>/ \ --install-type control+daemon --overwrite

Note

On a clustered deployment, this command must be run on all hosts.

If the upgrade fails, the system will revert back to the existing install.

Package upgrade

To upgrade a package within a Refinery installation (e.g. Analyst or Control), replace the current package in <KX_INSTALL_DIR>/packages with the updated package. Run installDeltaXML.sh in <KX_INSTALL_DIR>/scripts to install the updated package.