Hotfixes

A hotfix update is a single minor release to address a problem in a Deephaven release. Typically, hotfixes are made to address a specific customer situation.

If a hotfix is applicable to your current Deephaven deployment, your Deephaven account representative will provide you with the hotfix installation package.

Copy the new packages onto your Deephaven Linux hosts and run the following commands to apply the hotfix:

DH_VERSION="1.20240517.344"
# valid JAVA_VERSION is 11 or 17
JAVA_VERSION=17
sudo dnf install deephaven-enterprise-${DH_VERSION}-${JAVA_VERSION}-1.rpm -y

The installation procedure for a hotfix is similar to regular Deephaven upgrades. The installer will not delete or overwrite any existing files. It simply lays down the new files and updates a symbolic link called latest in the /usr/illumon folder.

The Reference section of the Deephaven Documentation includes the full version log for active Deephaven versions.

Custom libraries, overrides and hotfixes

Any custom or third party libraries and resources, such as JARs, class files, property files, etc. can be added to designated directories to override and/or extend your Deephaven installation.

The following directories are placed in the front of the CLASSPATH of Deephaven processes. Add any custom or third party resources to the following directories:

  • /etc/sysconfig/illumon.d/java_lib - For any user and/or third-party Java libraries (JARs). Any JARs placed in this directory will be found on the classpath of Deephaven processes.
  • /etc/sysconfig/illumon.d/override - For class files or other Java resources that should override those contained in the java_lib JARs.
  • /etc/sysconfig/illumon.d/hotfixes - This path contains any JAR files that should be used instead of those contained in the java_lib directories.

Restart affected processes

After a Deephaven hotfix package has been applied or any custom libraries, overrides or custom hotfixes have been placed in designated directories, the affected Deephaven processes need to be restarted.

In most cases, a restart of all Deephaven processes on the server will be required. This is accomplished using the following command:

sudo monit restart all

In cases where the hotfix or custom extensions are applicable to a specific Deephaven process, only that process needs to be restarted. Please refer to the Startup/Shutdown of Deephaven Processes section for instructions on restarting individual Deephaven processes.

Troubleshooting custom hotfixes and extensions

In some cases, third party libraries, custom extensions or hotfixes can cause conflicts or errors with existing Deephaven code libraries. Refer to the Log files for any errors or warnings once processes have been restarted with custom extensions.