Operations guide

This guide covers routine procedures and operations for Deephaven system administrators managing bare-metal and Podman Enterprise deployments. For Kubernetes deployments, see the Kubernetes documentation.

A production Deephaven system comprises three categories of components:

  • Network — IP subnets and associated services (DNS, NTP).
  • Storage — Intraday data on high-speed local SSD volumes; historical data on NFS mounts from a highly available storage system.
  • Application — Deephaven processes deployed across multiple x86_64 (64-bit) Linux nodes.

For more details on deployment architecture, see Scaling to Multiple Servers.

Deephaven services

Process nameRun userLog prefix
authentication_serveririsadminAuthenticationServer
db_acl_write_serveririsadminDbAclWriteServer
db_tdcpdbqueryTableDataCacheProxy
configuration_serveririsadminConfigurationServer
iris_controlleririsadminPersistentQueryController
log_aggregator_serviceirisadminLogAggregatorService
tailer1irisadminLogtailerMain
db_disdbmergeDataImportServer
db_merge_serverdbmergeRemoteQueryDispatcher
db_ltdsdbqueryLocalTableDataServer
db_query_serverdbqueryRemoteQueryDispatcher
web_api_servicedbqueryWebServer

Deephaven also depends on the following third-party processes:

ProcessRun userExecutable
MariaDBmysql/usr/libexec/mysqld

Third-party components

Deephaven relies on several third-party components — for example, Monit is covered in Starting and stopping Deephaven services. These components are installed as prerequisites before Deephaven installation. See the installation guide for the full list of dependencies.

License agreements, maintenance, troubleshooting, and runbooks for third-party components are in their respective upstream documentation.

Troubleshooting

Deephaven is fault-tolerant and designed to retry or restart components automatically. When intervention is required, start with basic checks: network connectivity, firewall rules, configuration file settings, file permissions. If basic checks and restarts do not resolve an incident, contact the Deephaven Support Team.