doris-debug-deployment
Installation
SKILL.md
Deployment & Startup
Causes
| ID | Cause | Evidence | Source anchor |
|---|---|---|---|
| A | Port conflict | BE/FE fail to bind; Address already in use |
brpc/server.cpp, doris_main.cpp |
| B | priority_networks misconfig |
brpc connection refused / wrong interface | config.cpp |
| C | meta_dir / storage_root_path not writable | Permission denied / No such file at startup |
olap/olap_meta.cpp |
| D | FE metadata corruption | FE fails to start after crash; meta/image.* errors |
Image.java, BDBJEJournal.java |
| E | Mixed version cluster | Protocol mismatch in thrift/brpc between FE-BE | be/src/agent/, heartbeat |
| F | DNS / hostname resolution | UnknownHostException, BE heartbeat to wrong address |
Env.java frontend host check |
10 min triage
# FE status
curl -s "http://$FE:8030/api/bootstrap"
curl -s "http://$FE:8030/api/health"