Admin prerequisites

Before performing the administrative tasks in this guide, ensure you have the following access and tools in place. This page applies to bare-metal and Podman Enterprise deployments.

Operating system users

Deephaven installation creates three Linux users with minimal permissions for their respective processes:

  • Admin user (irisadmin) — runs Deephaven admin processes.
  • Query user (dbquery) — runs database query (read) processes.
  • Merge user (dbmerge) — runs database import and merge (read-write) processes.

SSH terminal access

Some tasks require SSH terminal access to Deephaven compute nodes. Ensure you have SSH access to each server node in the cluster using your own OS user — not one of the users listed above.

Sudo access

Many Deephaven commands and administrative tasks require sudo — for example, mounting or unmounting NFS file shares, editing configuration files, and setting folder permissions.

Update /etc/sudoers to ensure your admin user can run all required commands.

Deephaven Console access

Some tasks, such as adding users or viewing query logs and performance metrics stored in the database, use the Deephaven Console GUI. Ensure the Console is installed on your workstation. See Installing the Launcher for details.

Network connectivity

Before troubleshooting or performing cluster operations, verify:

  • All servers have clocks synchronized via NTP.
  • Gigabit IP network connectivity exists between all cluster nodes and from clients to the cluster. Use ping, traceroute, and iperf to check bandwidth and latency.
  • DNS resolves correctly if hostnames are used in configuration files rather than IP addresses. Use ping, dig, or nslookup to verify name resolution between nodes.
  • Required ports are open between server processes and from clients to the cluster. See Process ports for the complete list. Use netstat, netcat, or nmap to verify port accessibility.