doris-debug-deployment

A troubleshooting guide for Apache Doris frontend and backend startup and deployment failures. Frontends manage cluster metadata and planning, while backends execute queries and store data.

In plain words
What is it for?
Checking service health, listening ports, frontend and backend membership, storage paths, metadata errors, network interfaces, and mixed-version cluster problems.
Why use it?
It helps narrow startup failures to port conflicts, network settings, permissions, corrupted metadata, incompatible versions, or hostname resolution. This gives each failure a concrete check.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/apache/doris-skills/deployment
Any agent
npx skills add apache/doris-skills --skill deployment
Clone the repo
git clone --depth 1 https://github.com/apache/doris-skills

Made for: Claude Code, Codex.

Per session 36 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 839 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00036 $0.00839
Opus 5 $0.00018 $0.00419
Sonnet 5 $0.00007 $0.00168
Haiku 4.5 $0.00004 $0.00084

Measured 2d ago against content hash e49d19a5b872, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

doris-debug-deployment scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -s "http://$FE:8030/api/bootstrap"
skills/doris-debug/deployment/SKILL.md · 99 lines

How it starts

The opening of the file, as written. The whole thing — 99 lines — stays where its author put it; the contents beside it link to each section on GitHub.

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"

# BE status
curl -s "http://$BE:8040/api/health"

# Port check
ss -tlnp | grep -E "8030|8040|8060|9030"
-- Cluster membership
SHOW FRONTENDS\G
SHOW BACKENDS\G

Cause A — Port conflict

Default ports (from fe/conf/fe.conf and be/conf/be.conf):

Service Port Config key
FE HTTP 8030 http_port
BE HTTP 8040 webserver_port
BE brpc 8060 brpc_port
FE MySQL 9030 query_port
FE Edit log 9010 edit_log_port
# Kill stale process on target port
fuser -k 8060/tcp  # BE brpc
# Then restart BE

Cause B — priority_networks

The most common cause of "BE shows Alive=true but brpc fails." priority_networks tells BE which network interface to bind brpc to.

# be.conf — match ONE subnet exactly
priority_networks = 10.0.0.0/24

Check what interface BE actually bound:

curl -s "http://$BE:8040/api/health" | grep -o '"ip":"[^"]*"'

Validation: the IP in SHOW BACKENDS must be reachable from every FE and every other BE on port 8060.

Read the full file on GitHub · 99 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 99 lines · 36 tokens per session scan A e49d19a5b872

Subscribe to this mod's changes

doris-debug-deployment is a skill published in the GitHub repository apache/doris-skills (37 stars, last pushed 13d ago), licensed Apache-2.0. It adds 36 tokens to every session and 839 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

terraform-skill

Use when working with Terraform or OpenTofu - creating modules, writing tests (native test framework, Terratest), setting up CI/CD pipelines, reviewing configurations, choosing between testing approaches, debugging state issues, implementing security scanning (trivy, checkov), or making infrastructure-as-code…

agentscope-ai/QwenPaw · 62 tokens

xlsx

当电子表格文件是主要输入或输出时使用此技能。这意味着用户想要:打开、读取、编辑或修复现有的 .xlsx、.xlsm、.csv 或 .tsv 文件(例如添加列、计算公式、格式化、制图、清理混乱数据);从头创建新的电子表格或从其他数据源创建;或在表格文件格式之间进行转换。当用户通过名称或路径引用电子表格文件时特别触发——即使是随意提及(如"我下载目录里的 xlsx")——并且想对其进行操作或从中生成内容。也适用于将混乱的表格数据文件(格式错误的行、错位的表头、垃圾数据)清理或重构为规范的电子表格。交付物必须是电子表格文件。当主要交付物是 Word 文档、HTML 报告、独立 Python 脚本、数据库管道或 Google Sheets…

agentscope-ai/QwenPaw · 232 tokens

terraform-cli-setup

Terraform CLI 安装与初始化技能。当用户本地未安装 Terraform 时自动完成安装,确保 terraform 命令可用并能执行 init/validate。不负责 Provider 凭证配置,凭证在实际使用时由 terraform-skill 引导。.

agentscope-ai/QwenPaw · 58 tokens

officecli-word-form

Use this skill to create fillable Word forms (.docx) with real Content Controls (SDT) + legacy FormField checkboxes + MERGEFIELD mail-merge placeholders + document protection. Trigger on: 'fillable form', 'form fields', 'content controls', 'SDT', 'word form', 'fill in', 'only editable fields', 'protect document'…

iOfficeAI/OfficeCLI · 224 tokens

oss-upload

Upload local files to Tencent COS (oss.1024code.com CDN) using coscli. Use when user wants to upload a file to CDN/OSS, or deploy static assets.

clacky-ai/openclacky · 40 tokens

winui-ui-testing

Automated UI testing for Windows desktop apps — generate a batch test script with the winapp ui UI Automation harness, run all tests in one pass, read results. Covers element assertions, interactions, value checking (TextBox, ComboBox, ToggleSwitch), keyboard shortcuts and typing (send-keys), hover, drag-and-drop…

microsoft/win-dev-skills · 122 tokens