Basic upgrade
This guide discusses how to upgrade Deephaven on one or more hosts. If your deployment uses Kubernetes, please refer to the Kubernetes upgrade guide. If your deployment uses Podman, consult the Podman upgrade guide.
Upgrading to Grizzly+
Carefully review the list of breaking changes before upgrading to Grizzly+. These include:
- The removal of Java 11, legacy Python 3.9, and Ubuntu 20.04 support.
- Changes to the handling of NULL and NaN.
- The need to regenerate your loggers.
TLS certificate handling changed significantly in Grizzly+. Review the TLS certificates and Native installation TLS certificate requirements documentation before upgrading.
- Native installations now use one certificate per machine. Rather than supply a single
tls.crtandtls.keyfor all machines, instead place one<node>.pemand<node>.keypair per machine inDH_LOCAL_CERT_DIR. - The use of an explicit truststore file is now optional and off by default. If you choose to limit the scope of trusted TLS certificate through a truststore file, you must supply your CA certificate bundle via
DH_CA_CERTIFICATE. - Generated keystores and truststores are always overwritten. On upgrades and certificate rotation, Deephaven overwrites derived keystores and truststores. If you previously modified files under
/etc/sysconfig/deephaven/{auth,auth-user,trust}directly, you must instead supply those certificates to the installer.
For complete details on all breaking changes and new features, see the Grizzly+ release notes.
As always, read the release notes and version logs for any releases being skipped during this upgrade. If upgrading from Vermilion+ or earlier releases, review the release notes and version logs for all intermediate releases.
Deephaven recommends the following before upgrading to Grizzly Plus.
-
Backup your data: Always ensure you have a complete backup of your data and configuration before upgrading.
-
Test in a non-production environment: When possible, test the upgrade process in a development or staging environment before upgrading production systems.
Upgrade process
To upgrade Deephaven to a newer version, update DH_VERSION to the desired version and re-run the process in the basic install document, replacing the installation media during the installation node setup.