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_networksmisconfiguration - 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.