deployment

Installation
SKILL.md

Deployment Troubleshooting

Investigation guide for FE and BE startup failures, port conflicts, BDB residual entries, JDK/JRE issues, and priority network configuration.

Six root causes account for the vast majority of startup failures:

  • Cause A — Port conflict (FE or BE port already in use)
  • Cause B — Missing directories or meta path does not exist
  • Cause C — Multi-NIC / priority_networks misconfiguration
  • Cause D — Clock drift (NTP not synced, delta >5s)
  • Cause E — BDB corruption or residual member entry
  • Cause F — HMS blocking FE startup (external catalog configured but HMS unreachable)

Metric Taxonomy — Read This First

Before diagnosing, understand the observable signals for startup failures.

Installs
5
GitHub Stars
78
First Seen
Jun 3, 2026