Compare commits
23
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
b17c60f997 | ||
|
|
2f0c3c1850 | ||
|
|
cedbdc465d | ||
|
|
8b09c78efd | ||
|
|
767ab25128 | ||
|
|
75381f9737 | ||
|
|
2b9b545ca9 | ||
|
|
e6c52bf071 | ||
|
|
1c44bf1259 | ||
|
|
9f0e04f22c | ||
|
|
fc88265e76 | ||
|
|
51da19d92d | ||
|
|
6570fd60e7 | ||
|
|
5d2ecbace6 | ||
|
|
99789a00a1 | ||
|
|
a68879e904 | ||
|
|
06d2bcbc9e | ||
|
|
c4a8c45835 | ||
|
|
1d027f71f6 | ||
|
|
a74229ee74 | ||
|
|
aebc98ead6 | ||
|
|
17a77e6b3f | ||
|
|
14d27a09b5 |
@@ -128,3 +128,10 @@ safe-mutate --verify "CMD" [--expect "PATTERN"] --mutate "CMD" [--reason "WHY"]
|
|||||||
Read the [Authoring Guide](docs/AUTHORING-GUIDE.md) before writing any new contract.
|
Read the [Authoring Guide](docs/AUTHORING-GUIDE.md) before writing any new contract.
|
||||||
It covers the full process: verify → draft → lint → review → ship, with templates
|
It covers the full process: verify → draft → lint → review → ship, with templates
|
||||||
and style rules.
|
and style rules.
|
||||||
|
|
||||||
|
## Maintaining this file
|
||||||
|
|
||||||
|
Keep this file for knowledge useful to almost every future agent session in this project.
|
||||||
|
Do not repeat what the codebase already shows; point to the authoritative file or command instead.
|
||||||
|
Prefer rewriting or pruning existing entries over appending new ones.
|
||||||
|
When updating this file, preserve this bar for all agents and keep entries concise.
|
||||||
|
|||||||
+104
-2
@@ -22,6 +22,7 @@ owners:
|
|||||||
- abiba
|
- abiba
|
||||||
- mumuni
|
- mumuni
|
||||||
- kwame
|
- kwame
|
||||||
|
- ops
|
||||||
trigger_types:
|
trigger_types:
|
||||||
- scheduled
|
- scheduled
|
||||||
- event_driven
|
- event_driven
|
||||||
@@ -58,6 +59,7 @@ index:
|
|||||||
- memory-audit-maintenance
|
- memory-audit-maintenance
|
||||||
- gpu-fleet
|
- gpu-fleet
|
||||||
- infrastructure-update
|
- infrastructure-update
|
||||||
|
- infrastructure-maintenance
|
||||||
reference:
|
reference:
|
||||||
- infrastructure-control
|
- infrastructure-control
|
||||||
- ra-h-os-custodianship-contract
|
- ra-h-os-custodianship-contract
|
||||||
@@ -90,6 +92,7 @@ index:
|
|||||||
- infrastructure-control
|
- infrastructure-control
|
||||||
- infrastructure-monitoring
|
- infrastructure-monitoring
|
||||||
- infrastructure-update
|
- infrastructure-update
|
||||||
|
- infrastructure-maintenance
|
||||||
- pm2-self-heal
|
- pm2-self-heal
|
||||||
- disk-gc-threat-response
|
- disk-gc-threat-response
|
||||||
gpu:
|
gpu:
|
||||||
@@ -130,7 +133,6 @@ index:
|
|||||||
- build-zulip-plugin
|
- build-zulip-plugin
|
||||||
- stirling-pdf-agent-access
|
- stirling-pdf-agent-access
|
||||||
- gpu-fleet
|
- gpu-fleet
|
||||||
- infrastructure-update
|
|
||||||
- infrastructure-control
|
- infrastructure-control
|
||||||
- zulip-adapter-lessons
|
- zulip-adapter-lessons
|
||||||
- pi-approval-architecture
|
- pi-approval-architecture
|
||||||
@@ -144,6 +146,9 @@ index:
|
|||||||
- mumuni-delegation
|
- mumuni-delegation
|
||||||
kwame:
|
kwame:
|
||||||
- hello-world
|
- hello-world
|
||||||
|
ops:
|
||||||
|
- infrastructure-maintenance
|
||||||
|
- infrastructure-update
|
||||||
by_trigger:
|
by_trigger:
|
||||||
scheduled:
|
scheduled:
|
||||||
- hermes-key-enforcement
|
- hermes-key-enforcement
|
||||||
@@ -156,6 +161,7 @@ index:
|
|||||||
- litellm-health
|
- litellm-health
|
||||||
- memory-audit-maintenance
|
- memory-audit-maintenance
|
||||||
- infrastructure-update
|
- infrastructure-update
|
||||||
|
- infrastructure-maintenance
|
||||||
event_driven:
|
event_driven:
|
||||||
- litellm-self-heal
|
- litellm-self-heal
|
||||||
- pm2-self-heal
|
- pm2-self-heal
|
||||||
@@ -197,6 +203,7 @@ index:
|
|||||||
- hermes-zulip-plugin
|
- hermes-zulip-plugin
|
||||||
- build-zulip-plugin
|
- build-zulip-plugin
|
||||||
- infrastructure-update
|
- infrastructure-update
|
||||||
|
- infrastructure-maintenance
|
||||||
- ra-h-os-custodianship-contract
|
- ra-h-os-custodianship-contract
|
||||||
- mumuni-delegation
|
- mumuni-delegation
|
||||||
normal:
|
normal:
|
||||||
@@ -1256,13 +1263,108 @@ contracts:
|
|||||||
last_run: null
|
last_run: null
|
||||||
last_status: null
|
last_status: null
|
||||||
drift_alerts: []
|
drift_alerts: []
|
||||||
|
- name: infrastructure-maintenance
|
||||||
|
file: infrastructure-maintenance.prose.md
|
||||||
|
kind: responsibility
|
||||||
|
category: maintenance
|
||||||
|
sensitivity: high
|
||||||
|
status: active
|
||||||
|
owner: ops
|
||||||
|
version: 1.0.0
|
||||||
|
trigger:
|
||||||
|
type: scheduled
|
||||||
|
cadence: 0 2 * * 0
|
||||||
|
description: Weekly host-level maintenance Sunday at 2am ET (replaces infrastructure-update
|
||||||
|
build-phase role; infra-update moves to ops)
|
||||||
|
cron_job_id: null
|
||||||
|
execution:
|
||||||
|
agent: ops
|
||||||
|
timeout: 3600
|
||||||
|
requires:
|
||||||
|
- infrastructure-monitoring run within last 30 minutes (pre-update health baseline)
|
||||||
|
- Proxmox snapshot of primary host OR /tmp backup dir created this run
|
||||||
|
- LiteLLM master key from Infisical vault for health verification
|
||||||
|
protocol:
|
||||||
|
- Load contract from prose-contracts/main
|
||||||
|
- Phase 0 preflight — capture health baseline, backup check, record image baseline
|
||||||
|
- Phase 1 apt update && apt upgrade -y on primary host
|
||||||
|
- Phase 2 docker compose pull for LiteLLM, SearXNG, and other running containers
|
||||||
|
- Phase 3 restart stacks one at a time with per-stack health verification
|
||||||
|
- Phase 4 verify every critical service (LiteLLM, SearXNG, Zulip, Gitea, PM2, Hermes gateways)
|
||||||
|
- On failure — rollback per protocol, escalate, do not loop beyond circuit breaker
|
||||||
|
- Log actions to ~/.hermes/runs/infrastructure-maintenance/
|
||||||
|
verification:
|
||||||
|
postconditions:
|
||||||
|
- check: all critical services running after update
|
||||||
|
verify: 'curl -sf http://192.168.68.116/litellm/v1/models && curl -sf https://chat.sysloggh.net/api/v1/server_settings && curl -sf https://git.sysloggh.net/api/v1/version && curl -sf http://192.168.68.7:8888 && pm2 jlist'
|
||||||
|
expect: all probes 200 OK / processes online
|
||||||
|
- check: no regressions from pre-update health baseline
|
||||||
|
verify: diff Phase 0 health-baseline against Phase 4 results
|
||||||
|
expect: no GREEN service turned RED
|
||||||
|
- check: docker containers on latest stable tags
|
||||||
|
verify: docker inspect --format '{{.Config.Image}}' <container> per service matches image-baseline.pulled_tag
|
||||||
|
expect: all containers running pulled tags
|
||||||
|
- check: APT packages up to date with no held broken packages
|
||||||
|
verify: apt list --upgradable 2>/dev/null | wc -l and apt-get -s upgrade | grep -ci broken
|
||||||
|
expect: upgradable == 0, broken == 0
|
||||||
|
artifact: maintenance run report with phase results and any rollback/escalation
|
||||||
|
verify_commands:
|
||||||
|
- curl -sf http://192.168.68.116/litellm/v1/models
|
||||||
|
- curl -sf http://192.168.68.7:8888
|
||||||
|
- curl -sf https://chat.sysloggh.net/api/v1/server_settings
|
||||||
|
- curl -sf https://git.sysloggh.net/api/v1/version
|
||||||
|
- pm2 jlist
|
||||||
|
receipt:
|
||||||
|
format: json
|
||||||
|
storage: ~/.hermes/runs/infrastructure-maintenance/
|
||||||
|
graph_node: true
|
||||||
|
schema:
|
||||||
|
contract: string
|
||||||
|
run_id: string
|
||||||
|
timestamp: ISO 8601
|
||||||
|
agent: string
|
||||||
|
status: pass|fail|escalated
|
||||||
|
phase: preflight|apt|images|restarts|verify|rollback|done|failed
|
||||||
|
actions_taken: array
|
||||||
|
postconditions: array
|
||||||
|
drift_alerts: array
|
||||||
|
evidence_path: string
|
||||||
|
escalation:
|
||||||
|
info:
|
||||||
|
action: log_to_receipt
|
||||||
|
notify: []
|
||||||
|
warning:
|
||||||
|
action: relay_alert
|
||||||
|
notify:
|
||||||
|
- abiba
|
||||||
|
- mumuni
|
||||||
|
critical:
|
||||||
|
action: relay_alert
|
||||||
|
notify:
|
||||||
|
- abiba
|
||||||
|
- mumuni
|
||||||
|
fatal:
|
||||||
|
action: relay_alert + pause + human_required
|
||||||
|
notify:
|
||||||
|
- abiba
|
||||||
|
- mumuni
|
||||||
|
- kwame
|
||||||
|
circuit_breaker:
|
||||||
|
max_retries: 2
|
||||||
|
window: 7200
|
||||||
|
trip_action: escalate_to_fatal
|
||||||
|
depends_on:
|
||||||
|
- infrastructure-monitoring
|
||||||
|
last_run: null
|
||||||
|
last_status: null
|
||||||
|
drift_alerts: []
|
||||||
- name: infrastructure-update
|
- name: infrastructure-update
|
||||||
file: infrastructure-update.prose.md
|
file: infrastructure-update.prose.md
|
||||||
kind: responsibility
|
kind: responsibility
|
||||||
category: maintenance
|
category: maintenance
|
||||||
sensitivity: high
|
sensitivity: high
|
||||||
status: active
|
status: active
|
||||||
owner: abiba
|
owner: ops
|
||||||
version: 1.0.0
|
version: 1.0.0
|
||||||
trigger:
|
trigger:
|
||||||
type: scheduled
|
type: scheduled
|
||||||
|
|||||||
+22
-35
@@ -9,10 +9,9 @@ description: >
|
|||||||
gpu-dense, gpu-light. These never change — only the underlying model does.
|
gpu-dense, gpu-light. These never change — only the underlying model does.
|
||||||
Strix Halo: strix-moe → unsloth/Qwen3.6-35B-A3B-MTP (UD-Q4_K_M, 22GB).
|
Strix Halo: strix-moe → unsloth/Qwen3.6-35B-A3B-MTP (UD-Q4_K_M, 22GB).
|
||||||
RTX 5070: gemma-4-12b Q4_K_M → IQ4_NL + MTP draft (122 tok/s, 2x faster).
|
RTX 5070: gemma-4-12b Q4_K_M → IQ4_NL + MTP draft (122 tok/s, 2x faster).
|
||||||
UPDATED 2026-07-17: Strix Halo model swapped to Genesis Hermes V3 APEX (LuffyTheFox, 24GB, uncensored,
|
UPDATED 2026-07-17: Context reduced fleet-wide from 256K to 128K for stability.
|
||||||
Hermes agent fine-tune, tensor repair, multimodal with mmproj).
|
Strix Halo model swapped to qwen3.6-35B-udq4 (22GB, strix-moe alias).
|
||||||
RTX 5070 swapped to HauhauCS Gemma4-12B QAT Uncensored Balanced (Q4_K_M, 87 tok/s, 0/465 refusals).
|
Instability observed near 100K at 256K (now all GPUs at 128K). 128K is the stable ceiling.
|
||||||
Instability observed near 100K at 256K. 128K is the stable ceiling.
|
|
||||||
For larger context needs → fall back to external providers (deepseek).
|
For larger context needs → fall back to external providers (deepseek).
|
||||||
VRAM headroom improved: RTX 3090 ~70%, RTX 5070 ~65%.
|
VRAM headroom improved: RTX 3090 ~70%, RTX 5070 ~65%.
|
||||||
agent: abiba
|
agent: abiba
|
||||||
@@ -87,31 +86,19 @@ When a model is swapped on a GPU, ONLY the infrastructure layer changes — agen
|
|||||||
| Alias | GPU | Current Model | Will Route To |
|
| Alias | GPU | Current Model | Will Route To |
|
||||||
|-------|-----|---------------|---------------|
|
|-------|-----|---------------|---------------|
|
||||||
| `strix-moe` | Strix Halo (.15) | qwen3.6-35B-udq4 | Whatever runs on Strix Halo |
|
| `strix-moe` | Strix Halo (.15) | qwen3.6-35B-udq4 | Whatever runs on Strix Halo |
|
||||||
| `gpu-dense` | RTX 3090 (.8) | qwen3.6-27B-code (ThinkingCap) | Whatever runs on RTX 3090 |
|
| `gpu-dense` | RTX 3090 (.8) | qwen3.6-27B-code | Whatever runs on RTX 3090 |
|
||||||
| `gpu-light` | RTX 5070 (.110) | gemma-4-12b | Whatever runs on RTX 5070 |
|
| `gpu-light` | RTX 5070 (.110) | gemma-4-12b | Whatever runs on RTX 5070 |
|
||||||
|
|
||||||
**Backward compatibility**: Old model-specific names (qwen3.6-27B-code, gemma-4-12b, qwen3.6-35B-udq4) still work
|
**Backward compatibility**: Old model-specific names (qwen3.6-27B-code, gemma-4-12b, qwen3.6-35B-udq4) still work
|
||||||
but are deprecated for agent configs. Only the stable aliases survive model swaps.
|
but are deprecated for agent configs. Only the stable aliases survive model swaps.
|
||||||
|
|
||||||
## Current Model Assignments (2026-07-17)
|
## Current Model Assignments (2026-07-15)
|
||||||
|
|
||||||
| Model | GPU | Host | VRAM | Ctx | KV Cache | Parallel | Batch/Ubatch | Status |
|
| Model | GPU | Host | VRAM | Ctx | KV Cache | Parallel | Batch/Ubatch | Status |
|
||||||
|-------|-----|------|------|-----|----------|----------|-------------|--------|
|
|-------|-----|------|------|-----|----------|----------|-------------|--------|
|
||||||
| qwen3.6-27B-code (ThinkingCap) | RTX 3090 | .8 (llm-gpu) | ~20.9/24.6GB (85%) | **128K** | turbo4 | 1 | default | ✅ 68 tok/s |
|
| qwen3.6-27B-code (MTP) | RTX 3090 | .8 (llm-gpu) | ~17/24.6GB (70%) | **128K** | turbo4 | 2 | default | ✅ 63 tok/s |
|
||||||
| gemma-4-12b (HauhauCS QAT) | RTX 5070 | .110 (ocu-llm) | ~10.0/12.2GB (82%) | 128K | q4_0 | 1 | 2048/1024 | ✅ 87 tok/s |
|
| gemma-4-12b | RTX 5070 | .110 (ocu-llm) | ~7.8/12.2GB (65%) | 128K | q4_0 | 2 | 2048/1024 | ✅ healthy |
|
||||||
| Genesis Hermes V3 APEX | Strix Halo Vulkan | .15 (amdpve) | ~10GB/64GB | 128K | q4_0 | 1 | 4096/1024 | ✅ 65 tok/s |
|
| qwen3.6-35B-udq4 | Strix Halo Vulkan | .15 (amdpve) | ~22GB/64GB | 128K | q4_0 | 1 | 4096/1024 | ✅ 65 tok/s |
|
||||||
|
|
||||||
> **RTX 5070 model swap (2026-07-17)**: Switched from `gemma-4-12b-it-IQ4_NL` (Unsloth, 191 tok/s)
|
|
||||||
> to `HauhauCS/Gemma4-12B-QAT-Uncensored-HauhauCS-Balanced` (Q4_K_M QAT, 87 tok/s).
|
|
||||||
> Trade: 54% slower generation for QAT quality, 0/465 refusals, and agent-optimized tuning.
|
|
||||||
> MTP draft also swapped: Q8_0 (444MB) → tuned draft (242MB), saving 200MB VRAM.
|
|
||||||
> Role unchanged: gpu-light (vision, web extract, light auxiliary tasks).
|
|
||||||
|
|
||||||
> **RTX 3090 model swap (2026-07-17)**: Switched from `Qwopus3.6-27B-v2-MTP-Q4_K_M` (63 tok/s)
|
|
||||||
> to `bottlecapai/ThinkingCap-Qwen3.6-27B` (Q4_K_M QAT, 68 tok/s).
|
|
||||||
> RL-finetuned: 50% fewer thinking tokens, MMLU-Pro 0.85 vs 0.83 base.
|
|
||||||
> Self-spec MTP REQUIRED (crashes without it on turboquant build).
|
|
||||||
> Added vision via mmproj (0.9GB). VRAM 85%.
|
|
||||||
|
|
||||||
## Routing Configuration (LiteLLM — July 2026)
|
## Routing Configuration (LiteLLM — July 2026)
|
||||||
|
|
||||||
@@ -120,7 +107,7 @@ but are deprecated for agent configs. Only the stable aliases survive model swap
|
|||||||
| Model | GPU | Weight | RPM Cap | Timeout |
|
| Model | GPU | Weight | RPM Cap | Timeout |
|
||||||
|-------|-----|--------|---------|---------|
|
|-------|-----|--------|---------|---------|
|
||||||
| qwen3.6-27B-code | RTX 3090 (.8:8080) | **0.55** | 500 | **300s** |
|
| qwen3.6-27B-code | RTX 3090 (.8:8080) | **0.55** | 500 | **300s** |
|
||||||
| Genesis Hermes V3 APEX | Strix Halo (.15:8080) | **0.30** | 60 | **300s** |
|
| qwen3.6-35B-udq4 | Strix Halo (.15:8080) | **0.30** | 60 | **300s** |
|
||||||
| gemma-4-12b | RTX 5070 (.110:8080) | **0.15** | 200 | **120s** |
|
| gemma-4-12b | RTX 5070 (.110:8080) | **0.15** | 200 | **120s** |
|
||||||
|
|
||||||
Note: All syslog-auto entries route directly to GPUs with `api_key: not-needed`. The router (port 9000) is NOT in the inference path.
|
Note: All syslog-auto entries route directly to GPUs with `api_key: not-needed`. The router (port 9000) is NOT in the inference path.
|
||||||
@@ -129,17 +116,17 @@ Note: All syslog-auto entries route directly to GPUs with `api_key: not-needed`.
|
|||||||
|
|
||||||
| Model | RPM Cap | Notes |
|
| Model | RPM Cap | Notes |
|
||||||
|-------|---------|-------|
|
|-------|---------|-------|
|
||||||
| strix-moe (Hermes V3) | 40 | Tight cap — prevents Strix overload |
|
| strix-moe (qwen3.6-35B-udq4) | 40 | Tight cap — prevents Strix overload |
|
||||||
| qwen3.6-27B-code | 500 | ThinkingCap Q4_K_M + MTP self-spec + vision, 68 tok/s |
|
| qwen3.6-27B-code | 500 | High cap — primary workhorse |
|
||||||
| gemma-4-12b | 500 | HauhauCS QAT Uncensored Balanced + MTP, 87 tok/s |
|
| gemma-4-12b | 500 | High cap — IQ4_NL+MTP, 122 tok/s |
|
||||||
|
|
||||||
### Stable Aliases (for agent configs — never change)
|
### Stable Aliases (for agent configs — never change)
|
||||||
|
|
||||||
| Alias | RPM Cap | Routes To | Purpose |
|
| Alias | RPM Cap | Routes To | Purpose |
|
||||||
|-------|---------|-----------|---------|
|
|-------|---------|-----------|---------|
|
||||||
| `strix-moe` | 40 | Strix Halo | Compression tasks (MoE models) |
|
| `strix-moe` | 40 | Strix Halo | Compression tasks (MoE models) |
|
||||||
| `gpu-dense` | 500 | RTX 3090 (ThinkingCap) | Heavy reasoning, code gen, delegation |
|
| `gpu-dense` | 500 | RTX 3090 | Heavy reasoning |
|
||||||
| `gpu-light` | 500 | RTX 5070 (HauhauCS QAT) | Vision, web extract, light tasks |
|
| `gpu-light` | 500 | RTX 5070 | Vision, web extract, light tasks |
|
||||||
|
|
||||||
### Fallback Chains
|
### Fallback Chains
|
||||||
- gemma → qwen
|
- gemma → qwen
|
||||||
@@ -261,10 +248,10 @@ If no SSH access, send Zulip DM via abiba-bot with vault update instructions.
|
|||||||
- **LiteLLM /metrics**: Requires auth. Prometheus uses `/health/liveliness` as workaround.
|
- **LiteLLM /metrics**: Requires auth. Prometheus uses `/health/liveliness` as workaround.
|
||||||
- **VRAM (2026-07-15)**: RTX 3090 at ~17/24.6GB (~70%) with **128K context** (reduced from 256K 2026-07-17). RTX 5070 at ~7.8/12.2GB (~65%) with 128K context + MTP. Strix Halo at ~7GB/64GB.
|
- **VRAM (2026-07-15)**: RTX 3090 at ~17/24.6GB (~70%) with **128K context** (reduced from 256K 2026-07-17). RTX 5070 at ~7.8/12.2GB (~65%) with 128K context + MTP. Strix Halo at ~7GB/64GB.
|
||||||
- **RTX 3090 runs `--parallel 2`** with MTP draft (spec-type draft-mtp, spec-draft-n-max 2).
|
- **RTX 3090 runs `--parallel 2`** with MTP draft (spec-type draft-mtp, spec-draft-n-max 2).
|
||||||
- **RTX 3090 config**: `-c 131072 -ctk turbo4 -ctv turbo4 --parallel 1 --flash-attn on --cont-batching --spec-type draft-mtp --spec-draft-n-max 4`. ThinkingCap Qwen3.6-27B Q4_K_M (15.7GB) + mmproj (0.9GB) + MTP self-spec. VRAM: ~85%. Service: `/home/llmuser/llama-wrapper.sh`. ⚠️ MTP REQUIRED for stability on this turboquant build — model segfaults without `--spec-type draft-mtp`. Outputs reasoning_content (hidden from agent, improves answer quality).
|
- **RTX 3090 config**: `-c 131072 -ctk turbo4 -ctv turbo4 --parallel 2 --flash-attn on --cont-batching --spec-type draft-mtp`. Context reduced to 128K (2026-07-17, was 256K). VRAM: ~70%. Service: `/home/llmuser/llama-wrapper.sh`.
|
||||||
- **RTX 5070 config (2026-07-17)**: HauhauCS Gemma4-12B QAT Uncensored Balanced (Q4_K_M) + tuned MTP draft (242MB) at 128K context, single slot. Gen speed: 87 tok/s (vs 191 IQ4_NL). VRAM: ~10.0/12.2GB (~82%). Service: `/home/llmuser/llama-wrapper.sh`. Model: `Gemma4-12B-QAT-Uncensored-HauhauCS-Balanced-Q4_K_M.gguf`, MTP: `mtp-gemma-4-12B-it.gguf`, mmproj: `mmproj-Gemma4-12B-QAT-Uncensored-HauhauCS-Balanced-BF16.gguf`. Recommended sampling: temp 0.6, top_k 64, top_p 0.9, min_p 0.05, repeat_penalty 1.1.
|
- **RTX 5070 config (2026-07-15)**: Switched to IQ4_NL + MTP draft (Q8_0) at 128K context. Gen speed: 122 tok/s. VRAM: ~7.8/12.2GB (~65%). Service: `/home/llmuser/llama-wrapper.sh`. Config: `--model gemma-4-12b-it-IQ4_NL.gguf --spec-draft-model gemma-4-12b-it-Q8_0-MTP.gguf --spec-type draft-mtp --spec-draft-n-max 4 --ctx-size 131072`.
|
||||||
- **LiteLLM timeout tuning (verified 2026-07-16 against `/opt/inference-harness/litellm_config.yaml` on CT 116)**: gemma-4-12b 120s, qwen3.6-27B-code 300s, qwen3.6-35B-udq4 300s, strix-moe 300s, syslog-auto routes all 300s. Nginx proxy_read_timeout: 600s. Global request_timeout: 300s.
|
- **LiteLLM timeout tuning (verified 2026-07-16 against `/opt/inference-harness/litellm_config.yaml` on CT 116)**: gemma-4-12b 120s, qwen3.6-27B-code 300s, qwen3.6-35B-udq4 300s, strix-moe 300s, syslog-auto routes all 300s. Nginx proxy_read_timeout: 600s. Global request_timeout: 300s.
|
||||||
- **Strix Halo GPU**: Vulkan is the working backend (ROCm/HIP path abandoned — HSA runtime blocked on Debian 13). Build at `/root/llama.cpp/build-vk/`, commit `4fc4ec5` (2026-07-01), ggml 0.15.3 shared-lib arch. Mesa RADV 25.0.7, KHR_coopmat fast path active. ~70 tok/s gen, 532 tok/s prompt. Service: `strix-server.service` on port 8080, model: `LuffyTheFox/Qwen3.6-35B-A3B-Uncensored-Genesis-Hermes-V3-GGUF` (APEX quant), alias `strix-moe`, 128K context, flash-attn + q4 KV, multimodal (mmproj loaded). Hermes agent fine-tune, tensor repair (SSM layers fixed via SVD), uncensored (0/465 refusals).
|
- **Strix Halo GPU**: Vulkan is the working backend (ROCm/HIP path abandoned — HSA runtime blocked on Debian 13). Build at `/root/llama.cpp/build-vk/`, commit `4fc4ec5` (2026-07-01), ggml 0.15.3 shared-lib arch. Mesa RADV 25.0.7, KHR_coopmat fast path active. ~70 tok/s gen, 532 tok/s prompt. Service: `strix-server.service` on port 8080, model: `qwen3.6-35B-udq4`, alias `strix-moe`, 128K context, flash-attn + q4 KV, multimodal (mmproj loaded).
|
||||||
- **Port conflict detection (2026-07-05)**: All 3 GPU wrappers now detect ghost processes squatting port 8080 before starting. `.8` and `.110` use inline pre-start check in `llama-wrapper.sh`; `.15` uses `/usr/local/bin/port-cleanup.sh` ExecStartPre. Replaces the blanket `pkill -9 -x llama-server` on .15 which would kill ALL llama-server instances regardless of port. Ghost detection was the root cause of .8 crash-looping for 27+ restarts (stale pid 25836 squatting 8080 after OOM kill).
|
- **Port conflict detection (2026-07-05)**: All 3 GPU wrappers now detect ghost processes squatting port 8080 before starting. `.8` and `.110` use inline pre-start check in `llama-wrapper.sh`; `.15` uses `/usr/local/bin/port-cleanup.sh` ExecStartPre. Replaces the blanket `pkill -9 -x llama-server` on .15 which would kill ALL llama-server instances regardless of port. Ghost detection was the root cause of .8 crash-looping for 27+ restarts (stale pid 25836 squatting 8080 after OOM kill).
|
||||||
- **Strix Halo thermal safeguard (2026-07-02)**: `strix-server.service` has `-n 8192` (hard generation cap per request). Without it, `--predict` defaults to -1 (infinity) — a runaway request from .123 (Mumuni) decoded 39,868 tokens over 24 min, pushing Tctl to 98°C (crit 89.8°C) and throttling 70→29 t/s. The cap bounds worst-case generation to ~5 min. Do NOT remove `-n` without a replacement ceiling. Sustained load hits ~84°C even at 92s; the APU is fanless/low-flow. Clients MUST also set `max_tokens`.
|
- **Strix Halo thermal safeguard (2026-07-02)**: `strix-server.service` has `-n 8192` (hard generation cap per request). Without it, `--predict` defaults to -1 (infinity) — a runaway request from .123 (Mumuni) decoded 39,868 tokens over 24 min, pushing Tctl to 98°C (crit 89.8°C) and throttling 70→29 t/s. The cap bounds worst-case generation to ~5 min. Do NOT remove `-n` without a replacement ceiling. Sustained load hits ~84°C even at 92s; the APU is fanless/low-flow. Clients MUST also set `max_tokens`.
|
||||||
- **Port 8080 firewall**: amdpve iptables restricts 8080 to 192.168.68.116 (LiteLLM/router host) only. All inbound connections are from .116 (LiteLLM proxied via nginx). Localhost curls hang (SYN dropped). Always test from .116.
|
- **Port 8080 firewall**: amdpve iptables restricts 8080 to 192.168.68.116 (LiteLLM/router host) only. All inbound connections are from .116 (LiteLLM proxied via nginx). Localhost curls hang (SYN dropped). Always test from .116.
|
||||||
@@ -278,11 +265,11 @@ If no SSH access, send Zulip DM via abiba-bot with vault update instructions.
|
|||||||
|
|
||||||
| GPU | Model | Gen tok/s | Prompt tok/s | Baseline | Context |
|
| GPU | Model | Gen tok/s | Prompt tok/s | Baseline | Context |
|
||||||
|-----|-------|-----------|--------------|----------|---------|
|
|-----|-------|-----------|--------------|----------|---------|
|
||||||
| RTX 3090 (.8) | ThinkingCap-Qwen3.6-27B Q4_K_M | **68** | — | — | **128K** |
|
| RTX 3090 (.8) | qwen3.6-27B-code (MTP) | **63** | — | — | **128K** |
|
||||||
| RTX 5070 (.110) | HauhauCS QAT Uncensored Balanced | **87** | — | — | **128K** |
|
| RTX 5070 (.110) | gemma-4-12b (IQ4_NL+MTP) | **191** | — | — | **128K** |
|
||||||
| Strix Halo (.15) | Genesis Hermes V3 APEX | **65** | 140 | — | **128K** |
|
| Strix Halo (.15) | qwen3.6-35B-udq4 | **65** | 140 | — | **128K** |
|
||||||
|
|
||||||
Benchmarks from 2026-07-17. Strix Halo swapped to Genesis Hermes V3 APEX (LuffyTheFox). RTX 5070 MTP provides 2.7x speedup over pre-upgrade 70 tok/s.
|
Benchmarks from 2026-07-17. Strix Halo model: qwen3.6-35B-udq4. RTX 5070 MTP provides 2.7x speedup over pre-upgrade 70 tok/s.
|
||||||
All 3 GPUs now at 128K context (2026-07-17, reduced from 256K for stability).
|
All 3 GPUs now at 128K context (2026-07-17, reduced from 256K for stability).
|
||||||
|
|
||||||
Benchmarks run through LiteLLM proxy (192.168.68.116:4001) every 5 minutes.
|
Benchmarks run through LiteLLM proxy (192.168.68.116:4001) every 5 minutes.
|
||||||
@@ -328,7 +315,7 @@ Mumuni (CT114, 192.168.68.123) is the primary business assistant. This profile i
|
|||||||
| `compression.protect_last_n` | 40 | Preserves last 40 messages |
|
| `compression.protect_last_n` | 40 | Preserves last 40 messages |
|
||||||
| `memory.memory_char_limit` | 800 | Brief memory entries |
|
| `memory.memory_char_limit` | 800 | Brief memory entries |
|
||||||
| `personalities` | `creative` | Creative assistant personality |
|
| `personalities` | `creative` | Creative assistant personality |
|
||||||
| Platforms | cli, discord, homeassistant, signal, telegram, zulip | All Hermes platforms |
|
| Platforms | cli, homeassistant, signal, telegram, zulip | All Hermes platforms |
|
||||||
| Main model timeout | 300s | LiteLLM global timeout |
|
| Main model timeout | 300s | LiteLLM global timeout |
|
||||||
| Compression model timeout | 300s | strix-moe timeout increased from 120s |
|
| Compression model timeout | 300s | strix-moe timeout increased from 120s |
|
||||||
|
|
||||||
|
|||||||
@@ -47,7 +47,7 @@ poll .15:8080 directly; must go through router on .116.
|
|||||||
| Router (unified) | `http://192.168.68.116/health/unified` | 15s | models, CB, scores, GPU status |
|
| Router (unified) | `http://192.168.68.116/health/unified` | 15s | models, CB, scores, GPU status |
|
||||||
| Router (basic) | `http://192.168.68.116/health` | 15s | basic aliveness |
|
| Router (basic) | `http://192.168.68.116/health` | 15s | basic aliveness |
|
||||||
| LiteLLM | `http://192.168.68.116/litellm/health` | 15s | proxy health, model count |
|
| LiteLLM | `http://192.168.68.116/litellm/health` | 15s | proxy health, model count |
|
||||||
| Strix Halo | `http://192.168.68.116/health/unified` (router) | 15s | ornith status via router — cannot poll .15:8080 directly (firewalled to .116 only) |
|
| Strix Halo | `http://192.168.68.116/health/unified` (router) | 15s | Strix Halo status via router — cannot poll .15:8080 directly (firewalled to .116 only) |
|
||||||
| Dashboard | `http://192.168.68.116/dashboard/` | 15s | harness-dashboard aliveness |
|
| Dashboard | `http://192.168.68.116/dashboard/` | 15s | harness-dashboard aliveness |
|
||||||
|
|
||||||
### Alert Delivery
|
### Alert Delivery
|
||||||
|
|||||||
@@ -46,7 +46,7 @@ depends_on:
|
|||||||
|-------|-----|------|-------|------|-----|-------|------|
|
|-------|-----|------|-------|------|-----|-------|------|
|
||||||
| `gpu-dense` | RTX 3090 24GB | ct8 (.8:8080) | ThinkingCap Qwen3.6-27B Q4_K_M + MTP + vision | 21.6/24.6GB (88%) | 128K | 74.9 | Heavy reasoning, code gen |
|
| `gpu-dense` | RTX 3090 24GB | ct8 (.8:8080) | ThinkingCap Qwen3.6-27B Q4_K_M + MTP + vision | 21.6/24.6GB (88%) | 128K | 74.9 | Heavy reasoning, code gen |
|
||||||
| `gpu-light` | RTX 5070 12GB | ct110 (.110:8080) | HauhauCS Gemma4-12B QAT Q4_K_M + MTP draft | 10.1/12.2GB (83%) | 128K | 169.6 | Vision, web extract, light tasks |
|
| `gpu-light` | RTX 5070 12GB | ct110 (.110:8080) | HauhauCS Gemma4-12B QAT Q4_K_M + MTP draft | 10.1/12.2GB (83%) | 128K | 169.6 | Vision, web extract, light tasks |
|
||||||
| `strix-moe` | Strix Halo 64GB | ct15 (.15:8080) | Genesis Hermes V3 APEX (LuffyTheFox, 24GB) | ~10/64GB (16%) | 128K | 62.9 | Compression, summarization, long docs |
|
| `strix-moe` | Strix Halo 64GB | ct15 (.15:8080) | qwen3.6-35B-udq4 | ~10/64GB (16%) | 128K | 62.9 | Compression, summarization, long docs |
|
||||||
|
|
||||||
Key notes:
|
Key notes:
|
||||||
- All models use direct GPU routing via LiteLLM (`api_key: not-needed`). Router (port 9000) is deprecated and NOT in the inference path.
|
- All models use direct GPU routing via LiteLLM (`api_key: not-needed`). Router (port 9000) is deprecated and NOT in the inference path.
|
||||||
@@ -143,7 +143,7 @@ Key notes:
|
|||||||
- **Detect**: Benchmark tok/s vs baseline for each GPU at current context (all 128K)
|
- **Detect**: Benchmark tok/s vs baseline for each GPU at current context (all 128K)
|
||||||
- RTX 3090 (128K ctx, ThinkingCap): baseline 74.8 tok/s — currently at 74.9 (100%)
|
- RTX 3090 (128K ctx, ThinkingCap): baseline 74.8 tok/s — currently at 74.9 (100%)
|
||||||
- RTX 5070 (128K ctx, HauhauCS QAT): baseline 165.2 tok/s — currently at 169.6 (103%)
|
- RTX 5070 (128K ctx, HauhauCS QAT): baseline 165.2 tok/s — currently at 169.6 (103%)
|
||||||
- Strix Halo (128K ctx, Genesis Hermes V3): baseline 70.5 tok/s — currently at 62.9 (89%)
|
- Strix Halo (128K ctx, qwen3.6-35B-udq4): baseline 70.5 tok/s — currently at 62.9 (89%)
|
||||||
- **Fix**:
|
- **Fix**:
|
||||||
- If tok/s > baseline → context has headroom, consider increasing
|
- If tok/s > baseline → context has headroom, consider increasing
|
||||||
- If tok/s < 90% baseline → reduce context by 25% and retest
|
- If tok/s < 90% baseline → reduce context by 25% and retest
|
||||||
|
|||||||
@@ -5,7 +5,7 @@ version: 1.0.0
|
|||||||
description: >
|
description: >
|
||||||
Canonical known-good baseline for all Syslog Hermes agents. Captures the exact
|
Canonical known-good baseline for all Syslog Hermes agents. Captures the exact
|
||||||
configuration state, keys, workarounds, and audit procedure. When an agent's
|
configuration state, keys, workarounds, and audit procedure. When an agent's
|
||||||
configuration goes sideways, restore from this baseline. Last verified 2026-07-16. All GPUs 256K context (RTX 3090 .8, RTX 5070 .110, Strix Halo .15). Parallel 1 fleet-wide (Strix Halo handles compression solo).
|
configuration goes sideways, restore from this baseline. Last verified 2026-07-16. All GPUs 128K context (reduced from 256K for stability Jul 2026) (RTX 3090 .8, RTX 5070 .110, Strix Halo .15). Parallel 1 fleet-wide (Strix Halo handles compression solo).
|
||||||
author: Abiba (pi agent)
|
author: Abiba (pi agent)
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -25,7 +25,7 @@ done
|
|||||||
| Agent | CT | Node | IP | LiteLLM Alias | Key Source | Platform |
|
| Agent | CT | Node | IP | LiteLLM Alias | Key Source | Platform |
|
||||||
|-------|-----|------|-----|---------------|------------|----------|
|
|-------|-----|------|-----|---------------|------------|----------|
|
||||||
| Tanko | 112 | amdpve | .122 | `tanko` | Infisical vault | Hermes |
|
| Tanko | 112 | amdpve | .122 | `tanko` | Infisical vault | Hermes |
|
||||||
| Mumuni | 114 | minipve | .123 | `mumuni` | Infisical vault | Hermes |
|
| Mumuni | 114 | hwepve | .123 | `mumuni` | Infisical vault | Hermes |
|
||||||
| Koby | 129 | amdpve | srv1079750 | `koby` | Infisical vault | **Hermes** |
|
| Koby | 129 | amdpve | srv1079750 | `koby` | Infisical vault | **Hermes** |
|
||||||
| Koonimo | 114 | amdpve | ? | `koonimo` | Infisical vault | Hermes |
|
| Koonimo | 114 | amdpve | ? | `koonimo` | Infisical vault | Hermes |
|
||||||
| Shumba | — | 192.168.68.119 | N/A | N/A (DeepSeek) | Hermes (RETIRED — CT119 now Infisical vault) |
|
| Shumba | — | 192.168.68.119 | N/A | N/A (DeepSeek) | Hermes (RETIRED — CT119 now Infisical vault) |
|
||||||
@@ -193,6 +193,8 @@ Key is injected via `infisical run --` wrapper at PM2 startup:
|
|||||||
"models": [
|
"models": [
|
||||||
{ "id": "syslog-auto" },
|
{ "id": "syslog-auto" },
|
||||||
{ "id": "strix-moe" },
|
{ "id": "strix-moe" },
|
||||||
|
{ "id": "gpu-dense" },
|
||||||
|
{ "id": "gpu-light" },
|
||||||
{ "id": "qwen3.6-27B-code" },
|
{ "id": "qwen3.6-27B-code" },
|
||||||
{ "id": "gemma-4-12b" }
|
{ "id": "gemma-4-12b" }
|
||||||
]
|
]
|
||||||
|
|||||||
@@ -5,11 +5,14 @@ description: >
|
|||||||
Standard Hermes configuration template for Syslog Solution LLC agents.
|
Standard Hermes configuration template for Syslog Solution LLC agents.
|
||||||
Enforces shared infrastructure setup (Firecrawl, SearXNG, local models,
|
Enforces shared infrastructure setup (Firecrawl, SearXNG, local models,
|
||||||
RA-H OS MCP) while keeping agent-specific API keys and model choices.
|
RA-H OS MCP) while keeping agent-specific API keys and model choices.
|
||||||
UPDATED 2026-07-16: Compression model is the stable alias `strix-moe` (NOT `ornith-1.0-35b`,
|
UPDATED 2026-07-18: Compression model switched to `syslog-auto` (was `strix-moe`)
|
||||||
|
to relieve Strix Halo pressure. syslog-auto distributes compression across the
|
||||||
|
weighted pool (55% RTX 3090, 30% Strix Halo, 15% RTX 5070).
|
||||||
|
UPDATED 2026-07-16: Compression model was the stable alias `strix-moe` (NOT `ornith-1.0-35b`,
|
||||||
which LiteLLM does not serve). All 3 GPUs verified at 128K (reduced from 256K 2026-07-17 for stability).
|
which LiteLLM does not serve). All 3 GPUs verified at 128K (reduced from 256K 2026-07-17 for stability).
|
||||||
Added Rule 12 (Context-Issue Diagnostic) + Rule 13 (.env fallback enforcement) from the
|
Added Rule 12 (Context-Issue Diagnostic) + Rule 13 (.env fallback enforcement) from the
|
||||||
2026-07-16 Mumuni root-cause investigation (WAL #1300).
|
2026-07-16 Mumuni root-cause investigation (WAL #1300).
|
||||||
UPDATED 2026-07-12: GPU workload redistributed. Compression → Strix Halo. RTX 3090 context verified at 128K. Infisical .env fallback required (Rule 3/13).
|
UPDATED 2026-07-12: GPU workload redistributed. Compression → Strix Halo (later switched to syslog-auto 2026-07-18). RTX 3090 context verified at 128K. Infisical .env fallback required (Rule 3/13).
|
||||||
---
|
---
|
||||||
|
|
||||||
## Maintains
|
## Maintains
|
||||||
@@ -130,7 +133,9 @@ mcp_servers:
|
|||||||
# ─── Compression ───
|
# ─── Compression ───
|
||||||
compression:
|
compression:
|
||||||
enabled: true
|
enabled: true
|
||||||
model: strix-moe # ⚠️ Must match auxiliary.compression.model. Stable alias (gpu-fleet § Stable Role-Based Aliases). NOT ornith-1.0-35b (LiteLLM does not serve that name).
|
model: syslog-auto # ⚠️ Switched from strix-moe 2026-07-18 to relieve Strix Halo.
|
||||||
|
# syslog-auto distributes across weighted pool (55% RTX 3090,
|
||||||
|
# 30% Strix Halo, 15% RTX 5070). All GPUs at 128K.
|
||||||
provider: harness
|
provider: harness
|
||||||
max_context_window: 131072 # MUST match actual GPU capacity. All 3 GPUs are 128K (Jul 17).
|
max_context_window: 131072 # MUST match actual GPU capacity. All 3 GPUs are 128K (Jul 17).
|
||||||
threshold: 0.65 # Fires at ~170K for 262K window, ~85K for 128K
|
threshold: 0.65 # Fires at ~170K for 262K window, ~85K for 128K
|
||||||
@@ -145,8 +150,9 @@ compression:
|
|||||||
# model: gpu-light # stable alias (NOT raw "gemma-4-12b")
|
# model: gpu-light # stable alias (NOT raw "gemma-4-12b")
|
||||||
# base_url: http://192.168.68.116/v1
|
# base_url: http://192.168.68.116/v1
|
||||||
# api_key_env: LITELLM_API_KEY
|
# api_key_env: LITELLM_API_KEY
|
||||||
# Do NOT use syslog-auto for auxiliary tasks — it routes to the primary GPU.
|
# Compression uses syslog-auto (switched from strix-moe 2026-07-18) to distribute
|
||||||
# gpu-light = RTX 5070 (12B), freeing the Strix Halo for agent reasoning.
|
# load across the weighted pool and relieve Strix Halo pressure.
|
||||||
|
# Vision and web_extract use gpu-light = RTX 5070 (12B).
|
||||||
# Heavy aux (delegation, x_search) use gpu-dense (RTX 3090) instead.
|
# Heavy aux (delegation, x_search) use gpu-dense (RTX 3090) instead.
|
||||||
# NEVER use raw model names (gemma-4-12b, qwen3.6-27B-code, qwen3.6-35B-udq4)
|
# NEVER use raw model names (gemma-4-12b, qwen3.6-27B-code, qwen3.6-35B-udq4)
|
||||||
# in agent configs — use the stable aliases so model swaps don't break agents.
|
# in agent configs — use the stable aliases so model swaps don't break agents.
|
||||||
@@ -166,7 +172,7 @@ auxiliary:
|
|||||||
timeout: 30
|
timeout: 30
|
||||||
compression:
|
compression:
|
||||||
provider: harness
|
provider: harness
|
||||||
model: strix-moe # MUST match compression.model above. Stable alias for Strix Halo.
|
model: syslog-auto # Switched from strix-moe 2026-07-18. Relieves Strix Halo pressure.
|
||||||
base_url: http://192.168.68.116/v1 # Rule 5: /v1 NOT /litellm/v1
|
base_url: http://192.168.68.116/v1 # Rule 5: /v1 NOT /litellm/v1
|
||||||
api_key_env: LITELLM_API_KEY
|
api_key_env: LITELLM_API_KEY
|
||||||
timeout: 300 # gpu-fleet: 300s for large-history summarization (was 60)
|
timeout: 300 # gpu-fleet: 300s for large-history summarization (was 60)
|
||||||
@@ -247,29 +253,30 @@ The following MUST be identical across ALL profiles:
|
|||||||
- Apply to BOTH main config AND all sub-agent profiles
|
- Apply to BOTH main config AND all sub-agent profiles
|
||||||
- For agents needing longer outputs: raise to 8192, but never omit
|
- For agents needing longer outputs: raise to 8192, but never omit
|
||||||
|
|
||||||
### Rule 7: Auxiliary Model Consistency (UPDATED 2026-07-16)
|
### Rule 7: Auxiliary Model Consistency (UPDATED 2026-07-18)
|
||||||
- Vision and web_extract use `gemma-4-12b` (RTX 5070 — 12GB, vision-optimized)
|
- Vision and web_extract use `gpu-light` (stable alias, RTX 5070 — 12GB, vision-optimized)
|
||||||
- Compression uses `strix-moe` (stable alias for Strix Halo — 64GB, 128K ctx, compression-optimized)
|
- Compression now uses `syslog-auto` (switched from `strix-moe` 2026-07-18) to distribute
|
||||||
- **`strix-moe` is the only valid compression model name** — LiteLLM does NOT serve `ornith-1.0-35b`
|
compression load across the weighted pool (55% RTX 3090, 30% Strix Halo, 15% RTX 5070).
|
||||||
(it serves `strix-moe`, `qwen3.6-35B-udq4`, `gpu-dense`, `gpu-light`, `syslog-auto`, `gemma-4-12b`, `qwen3.6-27B-code`). Old configs with `ornith-1.0-35b` cause 403/model-not-found on compression calls.
|
This relieves Strix Halo pressure while keeping compression functional on all GPUs.
|
||||||
|
- **`syslog-auto` is the valid compression model** — LiteLLM serves it as the weighted pool.
|
||||||
|
Old configs with `strix-moe` for compression should be updated to `syslog-auto`.
|
||||||
- All auxiliary services MUST use identical routing:
|
- All auxiliary services MUST use identical routing:
|
||||||
- `base_url: http://192.168.68.116/v1` (Rule 5: `/v1`, NOT `/litellm/v1`)
|
- `base_url: http://192.168.68.116/v1` (Rule 5: `/v1`, NOT `/litellm/v1`)
|
||||||
- `api_key_env: LITELLM_API_KEY`
|
- `api_key_env: LITELLM_API_KEY`
|
||||||
- **Do NOT use `syslog-auto`** for auxiliary tasks — it routes unpredictably
|
- **Compression via syslog-auto**: Routes through the weighted pool. Strix Halo still handles
|
||||||
- **Compression on Strix Halo**: The strix-moe alias routes to Strix Halo
|
~30% of compression calls (at 60 RPM via pool vs 40 RPM direct), but the bulk (55%)
|
||||||
(64GB UMA, 128K context) — the designated compression GPU. This frees the
|
goes to RTX 3090 which has ample spare capacity.
|
||||||
RTX 5070 for vision and web search, and the RTX 3090 for heavy reasoning.
|
|
||||||
- The `compression:` block's `model` MUST match `auxiliary: compression: model`
|
- The `compression:` block's `model` MUST match `auxiliary: compression: model`
|
||||||
- The `compression: max_context_window: 131072` MUST match actual GPU capacity (128K)
|
- The `compression: max_context_window: 131072` MUST match actual GPU capacity (128K)
|
||||||
|
|
||||||
### Rule 8: GPU Workload Distribution (UPDATED 2026-07-16)
|
### Rule 8: GPU Workload Distribution (UPDATED 2026-07-18)
|
||||||
- **RTX 3090 (24GB, 128K ctx, qwen3.6-27B-code)**: Heavy reasoning, code gen, long conversations
|
- **RTX 3090 (24GB, 128K ctx, qwen3.6-27B-code)**: Heavy reasoning, code gen, long conversations — also handles ~55% of compression via syslog-auto pool
|
||||||
- **RTX 5070 (12GB, 128K ctx, gemma-4-12b)**: Vision, web search, quick tasks, web_extract (IQ4_NL+MTP, ~65% VRAM at 128K)
|
- **RTX 5070 (12GB, 128K ctx, gemma-4-12b)**: Vision, web search, quick tasks, web_extract — handles ~15% of compression via syslog-auto pool
|
||||||
- **Strix Halo (64GB, 128K ctx, strix-moe)**: Context compression, summarization, long docs
|
- **Strix Halo (64GB, 128K ctx, qwen3.6-35B-udq4)**: Agent reasoning, compression (~30% via syslog-auto pool), fallback for other GPUs
|
||||||
- Agent profiles MUST route auxiliary tasks to the correct GPU:
|
- Agent profiles MUST route auxiliary tasks to the correct GPU:
|
||||||
- `auxiliary.vision.model: gemma-4-12b` (RTX 5070)
|
- `auxiliary.vision.model: gpu-light` (RTX 5070)
|
||||||
- `auxiliary.web_extract.model: gemma-4-12b` (RTX 5070)
|
- `auxiliary.web_extract.model: gpu-light` (RTX 5070)
|
||||||
- `auxiliary.compression.model: strix-moe` (Strix Halo)
|
- `auxiliary.compression.model: syslog-auto` (distributed pool, switched from strix-moe 2026-07-18)
|
||||||
- Default model (`model.default`) and custom_provider remain `syslog-auto` for auto-routing
|
- Default model (`model.default`) and custom_provider remain `syslog-auto` for auto-routing
|
||||||
- For 128K context window: `threshold: 0.65` (fires at ~85K tokens)
|
- For 128K context window: `threshold: 0.65` (fires at ~85K tokens)
|
||||||
- Do NOT use `threshold: 0.25` — this fires at 65K, causing premature context loss
|
- Do NOT use `threshold: 0.25` — this fires at 65K, causing premature context loss
|
||||||
@@ -325,7 +332,8 @@ verify ALL FOUR of these against the live config. They are the only root causes
|
|||||||
|
|
||||||
One-line agent health check (run on the agent host):
|
One-line agent health check (run on the agent host):
|
||||||
```bash
|
```bash
|
||||||
PID=$(pgrep -f "python -m hermes_cli.main gateway run" | head -1)
|
# Use grep -v infisical to avoid matching the bash wrapper that contains the same string
|
||||||
|
PID=$(pgrep -f "python -m hermes_cli.main gateway run" | grep -v infisical | head -1)
|
||||||
cat /proc/$PID/environ | tr '\0' '\n' | grep ^LITELLM_API_KEY= | sed 's/=.*/<set>/'
|
cat /proc/$PID/environ | tr '\0' '\n' | grep ^LITELLM_API_KEY= | sed 's/=.*/<set>/'
|
||||||
curl -s -o /dev/null -w 'key_health: %{http_code}\n' -H "Authorization: Bearer $(cat /proc/$PID/environ | tr '\0' '\n' | grep ^LITELLM_API_KEY= | cut -d= -f2)" http://192.168.68.116/v1/models
|
curl -s -o /dev/null -w 'key_health: %{http_code}\n' -H "Authorization: Bearer $(cat /proc/$PID/environ | tr '\0' '\n' | grep ^LITELLM_API_KEY= | cut -d= -f2)" http://192.168.68.116/v1/models
|
||||||
```
|
```
|
||||||
@@ -351,9 +359,19 @@ directly (no infisical). Apply with `systemctl daemon-reload && systemctl restar
|
|||||||
The wrapper sources `~/.hermes/.env` then exports `LITELLM_API_KEY="$<AGENT>_LITELLM_API_KEY"`.
|
The wrapper sources `~/.hermes/.env` then exports `LITELLM_API_KEY="$<AGENT>_LITELLM_API_KEY"`.
|
||||||
See litellm-api-keys.prose.md § Machine Identity for Vault Writes for vault sync.
|
See litellm-api-keys.prose.md § Machine Identity for Vault Writes for vault sync.
|
||||||
|
|
||||||
|
**⚠️ Vault empty-key guard:** If the vault stores the secret as an empty string,
|
||||||
|
the wrapper will inject an empty key and the gateway will silently get 401 errors
|
||||||
|
on all LiteLLM requests (triggering silent DeepSeek fallback). The `.env` fallback
|
||||||
|
is present but the vault takes precedence when the secret key exists (even if empty).
|
||||||
|
|
||||||
|
**Fix:** The wrapper MUST validate the key length after injection. If LITELLM_API_KEY
|
||||||
|
is empty or shorter than 20 chars, log a warning and either fail with a clear error
|
||||||
|
message or fall back to the `.env` value before starting the gateway.
|
||||||
|
|
||||||
**Verification (all agents):**
|
**Verification (all agents):**
|
||||||
```bash
|
```bash
|
||||||
GP=$(pgrep -f "python -m hermes_cli.main gateway run" | head -1)
|
# Use grep -v infisical to avoid matching the bash wrapper that contains the same string
|
||||||
|
GP=$(pgrep -f "python -m hermes_cli.main gateway run" | grep -v infisical | head -1)
|
||||||
K=$(cat /proc/$GP/environ | tr '\0' '\n' | grep '^LITELLM_API_KEY=' | cut -d= -f2)
|
K=$(cat /proc/$GP/environ | tr '\0' '\n' | grep '^LITELLM_API_KEY=' | cut -d= -f2)
|
||||||
curl -s -o /dev/null -w '%{http_code}' -H "Authorization: Bearer $K" http://192.168.68.116/v1/models # must be 200
|
curl -s -o /dev/null -w '%{http_code}' -H "Authorization: Bearer $K" http://192.168.68.116/v1/models # must be 200
|
||||||
```
|
```
|
||||||
|
|||||||
@@ -51,7 +51,7 @@ gateway restart, and connection validation.
|
|||||||
|
|
||||||
| Host | CT | Proxmox | IP (direct) | Hermes Home | User |
|
| Host | CT | Proxmox | IP (direct) | Hermes Home | User |
|
||||||
|------|-----|---------|-------------|-------------|------|
|
|------|-----|---------|-------------|-------------|------|
|
||||||
| Mumuni | CT114 | — | 192.168.68.123 | /root/.hermes | root |
|
| Mumuni | CT114 | hwepve | 192.168.68.123 | /root/.hermes | root |
|
||||||
| Tanko | CT112 | amdpve | 192.168.68.122 | /home/jerome/.hermes | jerome |
|
| Tanko | CT112 | amdpve | 192.168.68.122 | /home/jerome/.hermes | jerome |
|
||||||
| Koby | CT111 | amdpve | 192.168.68.129 | /root/.hermes | root |
|
| Koby | CT111 | amdpve | 192.168.68.129 | /root/.hermes | root |
|
||||||
| Shumba | — | — | 192.168.68.119 | /home/lucky/.hermes | lucky |
|
| Shumba | — | — | 192.168.68.119 | /home/lucky/.hermes | lucky |
|
||||||
|
|||||||
@@ -22,14 +22,14 @@ management, and prompt caching — without sacrificing agent capability.
|
|||||||
- `agent-configs`: current config.yaml from each active Hermes agent (Mumuni
|
- `agent-configs`: current config.yaml from each active Hermes agent (Mumuni
|
||||||
.123, any others on .129/.122) including compression, model, context_window,
|
.123, any others on .129/.122) including compression, model, context_window,
|
||||||
prompt_caching, memory settings
|
prompt_caching, memory settings
|
||||||
- `gpu-health`: health check response from all 3 GPU backends (ornith .15:8080,
|
- `gpu-health`: health check response from all 3 GPU backends (strix-moe .15:8080,
|
||||||
qwen .8:8080, gemma .110:8080)
|
qwen .8:8080, gemma .110:8080)
|
||||||
|
|
||||||
### Maintains
|
### Maintains
|
||||||
|
|
||||||
The optimized inference stack configuration — every change is applied and
|
The optimized inference stack configuration — every change is applied and
|
||||||
verified end-to-end. Postcondition: avg request_duration_ms ≤ 15000 for 90% of
|
verified end-to-end. Postcondition: avg request_duration_ms ≤ 15000 for 90% of
|
||||||
non-ornith traffic; ≤ 30000 for ornith-bound agentic calls.
|
inference calls.
|
||||||
|
|
||||||
#### liteLLM-routing
|
#### liteLLM-routing
|
||||||
The syslog-auto routing weights, model-specific timeouts, RPM limits, and
|
The syslog-auto routing weights, model-specific timeouts, RPM limits, and
|
||||||
@@ -53,18 +53,17 @@ duration.
|
|||||||
|
|
||||||
### Strategies
|
### Strategies
|
||||||
|
|
||||||
**Context is the root cause.** Every ~46K prompt token costs ~87s of ornith
|
**Context is the root cause.** Every ~46K prompt token costs ~87s of
|
||||||
prefill time at 532 tok/s. Fix context first, routing second.
|
prefill time at 532 tok/s. Fix context first, routing second.
|
||||||
|
|
||||||
- **Route by task**: ornith for multi-step reasoning only; qwen for code/standard
|
- **Route by task**: qwen for code/standard queries; gemma for
|
||||||
queries; gemma for compression/auxiliary. Never send simple completion to a
|
compression/auxiliary; strix-moe for compression tasks.
|
||||||
35B MoE.
|
- **Compress aggressively**: threshold at 40% (not 65%) — a 128K window should
|
||||||
- **Compress aggressively**: threshold at 40% (not 65%) — a 256K window should
|
compact at 51K, not 85K. Target 15% tail (not 30%).
|
||||||
compact at 102K, not 166K. Target 15% tail (not 30%).
|
|
||||||
- **Cache everything repeated**: system prompts, skill docs, AGENTS.md — these
|
- **Cache everything repeated**: system prompts, skill docs, AGENTS.md — these
|
||||||
never change between turns. Single-digit cache hit rate is unacceptable.
|
never change between turns. Single-digit cache hit rate is unacceptable.
|
||||||
- **Lower context ceiling**: 128K window is the stable ceiling for agent conversations.
|
- **Lower context ceiling**: 128K window is the stable ceiling for agent conversations.
|
||||||
GPUs reduced from 256K to 128K (2026-07-17). For larger contexts, route to external providers.
|
GPUs reduced from 256K to 128K (2026-07-17). 128K window should compact at 85K (0.65 threshold). For larger contexts, route to external providers.
|
||||||
|
|
||||||
### Shape
|
### Shape
|
||||||
|
|
||||||
@@ -100,5 +99,5 @@ call enable-prompt-caching
|
|||||||
|
|
||||||
call verify-latency
|
call verify-latency
|
||||||
host: 192.168.68.116
|
host: 192.168.68.116
|
||||||
models: [syslog-auto, qwen3.6-27B-code, gemma-4-12b, ornith-1.0-35b]
|
models: [syslog-auto, qwen3.6-27B-code, gemma-4-12b]
|
||||||
```
|
```
|
||||||
|
|||||||
@@ -3,7 +3,7 @@ kind: pattern
|
|||||||
name: infrastructure-control
|
name: infrastructure-control
|
||||||
description: >
|
description: >
|
||||||
Full infrastructure monitoring and control pattern covering the
|
Full infrastructure monitoring and control pattern covering the
|
||||||
5-node Proxmox cluster, 3 Docker ecosystems (22 containers),
|
6-node Proxmox cluster, 3 Docker ecosystems (22 containers),
|
||||||
NFS storage, and network services. Defines monitors, remediations,
|
NFS storage, and network services. Defines monitors, remediations,
|
||||||
and the access matrix for all environments.
|
and the access matrix for all environments.
|
||||||
|
|
||||||
@@ -12,6 +12,11 @@ description: >
|
|||||||
never mutate infrastructure based on them without first confirming
|
never mutate infrastructure based on them without first confirming
|
||||||
against the live system. Policy fields are authoritative. See the
|
against the live system. Policy fields are authoritative. See the
|
||||||
`verify-before-mutate` skill.
|
`verify-before-mutate` skill.
|
||||||
|
|
||||||
|
**Last verified:** 2026-07-24 — corrected Gitea IP (.17 not .110),
|
||||||
|
AdGuard IP (.10 not .102), AdGuard placement (minipve not acerpve),
|
||||||
|
Abiba placement (hwepve not amdpve), added hwepve as 6th node,
|
||||||
|
added dns.sysloggh.net route. See data/learnings.md.
|
||||||
---
|
---
|
||||||
|
|
||||||
# Infrastructure Control Pattern
|
# Infrastructure Control Pattern
|
||||||
@@ -42,8 +47,8 @@ description: >
|
|||||||
│ │ │ │ │
|
│ │ │ │ │
|
||||||
┌────┘ ┌────┘ ┌────┘ ┌────┘ ┌────┘
|
┌────┘ ┌────┘ ┌────┘ ┌────┘ ┌────┘
|
||||||
▼ ▼ ▼ ▼ ▼
|
▼ ▼ ▼ ▼ ▼
|
||||||
minipve amdpve storepve acerpve ocupve
|
minipve amdpve storepve acerpve ocupve hwepve
|
||||||
(.12) (.15) (.6) (.9) (.5)
|
(.12) (.15) (.6) (.9) (.5) (.4)
|
||||||
|
|
||||||
▼
|
▼
|
||||||
┌─────────────────────────────────────────────┐
|
┌─────────────────────────────────────────────┐
|
||||||
@@ -95,15 +100,21 @@ description: >
|
|||||||
|
|
||||||
## Section 2: Proxmox Cluster — Monitoring
|
## Section 2: Proxmox Cluster — Monitoring
|
||||||
|
|
||||||
### Nodes (5)
|
### Nodes (6)
|
||||||
|
|
||||||
| Node | IP | CPU | RAM | VMs/CTs | Role |
|
| Node | IP | CPU | RAM | VMs/CTs | Role |
|
||||||
|------|----|-----|-----|---------|------|
|
|------|----|-----|-----|---------|------|
|
||||||
| minipve | .12 | 16C | 30GB | authentik, gitea, mumuni, syslog-api, jitsi | Auth, git, messaging |
|
| minipve | .12 | 16C | 30GB | authentik, gitea, syslog-api, infisical-vault, jitsi | Auth, git, messaging |
|
||||||
| amdpve | .15 | 32C | 62GB | abiba, kagentz, tanko, tdunna, baggy, scottdenya | Agents, compute |
|
| amdpve | .15 | 32C | 62GB | kagentz, tanko, tdunna, baggy, scottdenya | Agents, compute |
|
||||||
| storepve | .6 | 28C | 31GB | docker-vm, ra-h-os, PBS, media, zulip | Docker, storage, chat |
|
| storepve | .6 | 28C | 31GB | docker-vm, ra-h-os, PBS, media, jdownloader, zulip | Docker, storage, chat |
|
||||||
| acerpve | .9 | 28C | 31GB | llm-gpu, adguard | GPU VMs |
|
| acerpve | .9 | 28C | 31GB | llm-gpu | GPU VMs |
|
||||||
| ocupve | .5 | 12C | 14GB | ocu-llm | GPU VMs |
|
| ocupve | .5 | 12C | 14GB | ocu-llm | GPU VMs |
|
||||||
|
| hwepve | .4 | ? | ? | abiba, (mumuni CT 114 stopped) | Agents (new node) |
|
||||||
|
|
||||||
|
> **Note:** CTs on storepve include jdownloader (CT 118). AdGuard (CT 102) is on
|
||||||
|
> minipve at .10, not acerpve. Abiba (CT 100) is on hwepve, not amdpve. Mumuni
|
||||||
|
> (CT 114) is on hwepve (currently stopped), not minipve. Mumuni also has a
|
||||||
|
> second instance on minipve at .123 — distinguish by CT ID, not hostname.
|
||||||
|
|
||||||
### Checks (every 5 min)
|
### Checks (every 5 min)
|
||||||
|
|
||||||
@@ -199,7 +210,7 @@ description: >
|
|||||||
**Prometheus targets**:
|
**Prometheus targets**:
|
||||||
- 192.168.68.8:9400 (RTX 3090 — qwen)
|
- 192.168.68.8:9400 (RTX 3090 — qwen)
|
||||||
- 192.168.68.110:9400 (RTX 5070 — gemma)
|
- 192.168.68.110:9400 (RTX 5070 — gemma)
|
||||||
- 192.168.68.15:9400 (Strix Halo — ornith)
|
- 192.168.68.15:9400 (Strix Halo — qwen3.6-35B-udq4)
|
||||||
- 192.168.68.24:9401 (Router metrics exporter)
|
- 192.168.68.24:9401 (Router metrics exporter)
|
||||||
- harness-litellm:4000 (LiteLLM health)
|
- harness-litellm:4000 (LiteLLM health)
|
||||||
|
|
||||||
@@ -355,15 +366,17 @@ fine. Services that resolve directly to a LAN IP are NetBird-independent.
|
|||||||
| Proxmox API | minipve.sysloggh.net:8006 | 192.168.68.12 | LAN IP | No | ✅ |
|
| Proxmox API | minipve.sysloggh.net:8006 | 192.168.68.12 | LAN IP | No | ✅ |
|
||||||
| LiteLLM | litellm.sysloggh.net | 192.168.68.116 | LAN IP | No | ✅ |
|
| LiteLLM | litellm.sysloggh.net | 192.168.68.116 | LAN IP | No | ✅ |
|
||||||
| Authentik | auth.sysloggh.net:443 | 192.168.68.11 | CNAME → netbird | **Yes** | ⚠️ |
|
| Authentik | auth.sysloggh.net:443 | 192.168.68.11 | CNAME → netbird | **Yes** | ⚠️ |
|
||||||
| Gitea | git.sysloggh.net:443 | 192.168.68.110 | CNAME → netbird | **Yes** | ⚠️ |
|
| Gitea | git.sysloggh.net:443 | 192.168.68.17:3000 | CNAME → netbird | **Yes** | ⚠️ |
|
||||||
| Zulip | chat.sysloggh.net:443 | 192.168.68.19 | CNAME → netbird | **Yes** | ⚠️ VERIFY-BEFORE-USE |
|
| Zulip | chat.sysloggh.net:443 | 192.168.68.19 | CNAME → netbird | **Yes** | ⚠️ VERIFY-BEFORE-USE |
|
||||||
| Pulse | pulse.sysloggh.net:443 | 192.168.68.7 | CNAME → netbird | **Yes** | ⚠️ |
|
| Pulse | pulse.sysloggh.net:443 | 192.168.68.7 | CNAME → netbird | **Yes** | ⚠️ |
|
||||||
| DNS UI | dns.sysloggh.net:443 | 192.168.68.102 | CNAME → netbird | **Yes** | ⚠️ |
|
| DNS UI | dns.sysloggh.net:443 | 192.168.68.10:80 | CNAME → netbird | **Yes** | ⚠️ |
|
||||||
| SearXNG | searxng.sysloggh.net:8888 | 192.168.68.7:8888 | LAN IP | No | ✅ |
|
| SearXNG | searxng.sysloggh.net:8888 | 192.168.68.7:8888 | LAN IP | No | ✅ |
|
||||||
| Firecrawl | firecrawl.sysloggh.net:3002 | 192.168.68.7:3002 | LAN IP | No | ✅ |
|
| Firecrawl | firecrawl.sysloggh.net:3002 | 192.168.68.7:3002 | LAN IP | No | ✅ |
|
||||||
|
|
||||||
**Verified 2026-07-02:** NetBird VPS rebooted after a hang; all CNAME'd
|
**Verified 2026-07-24:** NetBird VPS rebooted after a hang; all CNAME'd
|
||||||
services recovered. LAN-IP-direct paths stayed up throughout the outage.
|
services recovered. LAN-IP-direct paths stayed up throughout the outage.
|
||||||
|
Also added `dns.sysloggh.net` route (was missing entirely).
|
||||||
|
See `scripts/netbird-add-domain.sh` for adding new proxy routes.
|
||||||
|
|
||||||
### 5.2 Checks (every 2 min)
|
### 5.2 Checks (every 2 min)
|
||||||
|
|
||||||
@@ -511,8 +524,8 @@ enforced by the `routing-regression.config_url_violations` check in Section
|
|||||||
| LiteLLM API | `http://192.168.68.116:4000` | `https://litellm.sysloggh.net` |
|
| LiteLLM API | `http://192.168.68.116:4000` | `https://litellm.sysloggh.net` |
|
||||||
| LiteLLM (nginx) | `http://192.168.68.116` | — |
|
| LiteLLM (nginx) | `http://192.168.68.116` | — |
|
||||||
| Grafana | `http://192.168.68.116:3001` | — |
|
| Grafana | `http://192.168.68.116:3001` | — |
|
||||||
| Authentik | `https://192.168.68.11` | `https://auth.sysloggh.net` |
|
| Authentik | `https://192.168.68.11:9000` | `https://auth.sysloggh.net` |
|
||||||
| Gitea | `http://192.168.68.110:3000` | `https://git.sysloggh.net` |
|
| Gitea | `http://192.168.68.17:3000` | `https://git.sysloggh.net` |
|
||||||
| Zulip API | `http://192.168.68.19` | `https://chat.sysloggh.net` |
|
| Zulip API | `http://192.168.68.19` | `https://chat.sysloggh.net` |
|
||||||
| SearXNG | `http://192.168.68.7:8888` | — |
|
| SearXNG | `http://192.168.68.7:8888` | — |
|
||||||
| Firecrawl | `http://192.168.68.7:3002` | — |
|
| Firecrawl | `http://192.168.68.7:3002` | — |
|
||||||
@@ -575,25 +588,28 @@ ssh root@192.168.68.110 "systemctl restart llama-server"
|
|||||||
|
|
||||||
| CT | Name | Node | IP | Role | Agent |
|
| CT | Name | Node | IP | Role | Agent |
|
||||||
|----|------|------|----|------|-------|
|
|----|------|------|----|------|-------|
|
||||||
| 100 | abiba | amdpve | .24 | Pi agent (this host) | ✅ pi |
|
| CT | Name | Node | IP | Role | Agent |
|
||||||
|
|----|------|------|----|------|-------|
|
||||||
|
| 100 | abiba | **hwepve** | .24 | Pi agent | ✅ pi |
|
||||||
| 101 | llm-gpu | acerpve | .8 | GPU RTX 3090 | ❌ |
|
| 101 | llm-gpu | acerpve | .8 | GPU RTX 3090 | ❌ |
|
||||||
| 102 | adguard | acerpve | — | DNS | ❌ |
|
| 102 | adguard | **minipve** | **.10** | DNS | ❌ |
|
||||||
| 103 | ocu-llm | ocupve | .110 | GPU RTX 5070 | ❌ |
|
| 103 | ocu-llm | ocupve | .110 | GPU RTX 5070 | ❌ |
|
||||||
| 104 | authentik | minipve | .11 | OIDC | ❌ |
|
| 104 | authentik | minipve | .11 | OIDC | ❌ |
|
||||||
| 105 | kagentz | amdpve | — | Agent Zero | ✅ |
|
| 105 | kagentz | **hwepve** | — | Agent Zero | ✅ |
|
||||||
| 106 | ra-h-os | storepve | .65 | KG bridge | ✅ MCP |
|
| 106 | ra-h-os | storepve | .65 | KG bridge | ✅ MCP |
|
||||||
| 107 | pbs | storepve | — | Backups | ❌ |
|
| 107 | pbs | storepve | — | Backups | ❌ |
|
||||||
| 108 | media | storepve | — | Media | ❌ |
|
| 108 | media | storepve | — | Media | ❌ |
|
||||||
| 109 | docker-vm | storepve | .7 | Docker host | ❌ |
|
| 109 | docker-vm | storepve | .7 | Docker host | ❌ |
|
||||||
| 110 | gitea | minipve | — | Git | ❌ |
|
| 110 | gitea | minipve | **.17** | Git | ❌ |
|
||||||
| 111 | tdunna | amdpve | .129 | Hermes agent | ✅ |
|
| 111 | tdunna | amdpve | .129 | Hermes agent | ✅ |
|
||||||
| 112 | tanko | amdpve | .122 | Hermes agent | ✅ |
|
| 112 | tanko | amdpve | .122 | Hermes agent | ✅ |
|
||||||
| 113 | baggy | amdpve | ? | Hermes agent | ✅ |
|
| 113 | baggy | amdpve | .114 | Hermes agent | ✅ |
|
||||||
| 114 | mumuni | minipve | .123 | Hermes agent | ✅ |
|
| 114 | mumuni | **hwepve** | .123 | Hermes agent (stopped) | ✅ |
|
||||||
| 115 | scottdenya | amdpve | — | ? | ❌ |
|
| 115 | scottdenya | amdpve | .75 | Denya OneCare | ❌ |
|
||||||
| 116 | syslog-api | minipve | .116 | LiteLLM + Grafana | ❌ |
|
| 116 | syslog-api | minipve | .116 | LiteLLM + Grafana | ❌ |
|
||||||
| 117 | zulip | storepve | — | Chat | ❌ |
|
| 117 | zulip | storepve | .19 | Chat | ❌ |
|
||||||
| 118 | jitsi | minipve | — | Video | ❌ |
|
| 118 | jdownloader | storepve | — | JDownloader container | ❌ |
|
||||||
|
| 119 | infisical-vault | minipve | — | Vault | ❌ |
|
||||||
|
|
||||||
## Appendix C: Docker Compose Files Location
|
## Appendix C: Docker Compose Files Location
|
||||||
|
|
||||||
@@ -613,7 +629,7 @@ Source of truth: `/root/scripts/pct-run.sh` or `prose-contracts/scripts/pct-run.
|
|||||||
|
|
||||||
| CT | Name | Node | pct-run |
|
| CT | Name | Node | pct-run |
|
||||||
|-----|------|------|---------|
|
|-----|------|------|---------|
|
||||||
| 100 | abiba | amdpve | `pct-run 100` |
|
| 100 | abiba | hwepve | `pct-run 100` |
|
||||||
| 105 | kagentz | amdpve | `pct-run 105` |
|
| 105 | kagentz | amdpve | `pct-run 105` |
|
||||||
| 111 | tdunna | amdpve | `pct-run 111` |
|
| 111 | tdunna | amdpve | `pct-run 111` |
|
||||||
| 112 | tanko | amdpve | `pct-run 112` |
|
| 112 | tanko | amdpve | `pct-run 112` |
|
||||||
@@ -627,13 +643,14 @@ Source of truth: `/root/scripts/pct-run.sh` or `prose-contracts/scripts/pct-run.
|
|||||||
| 107 | proxmox-backup | storepve | `pct-run 107` |
|
| 107 | proxmox-backup | storepve | `pct-run 107` |
|
||||||
| 108 | media | storepve | `pct-run 108` |
|
| 108 | media | storepve | `pct-run 108` |
|
||||||
| 117 | zulip | storepve | `pct-run 117` |
|
| 117 | zulip | storepve | `pct-run 117` |
|
||||||
| 102 | adguard | acerpve | `pct-run 102` |
|
| 102 | adguard | **minipve** | `pct-run 102` |
|
||||||
|
|
||||||
GPU bare-metal hosts (.8 acerpve, .110 ocupve, .15 amdpve) are NOT CTs — use SSH directly:
|
GPU bare-metal hosts (.8 acerpve, .110 ocupve, .15 amdpve) are NOT CTs — use SSH directly:
|
||||||
```bash
|
```bash
|
||||||
ssh root@192.168.68.8 # RTX 3090
|
ssh root@192.168.68.8 # RTX 3090
|
||||||
ssh root@192.168.68.110 # RTX 5070
|
ssh root@192.168.68.110 # RTX 5070
|
||||||
ssh root@192.168.68.15 # Strix Halo
|
ssh root@192.168.68.15 # Strix Halo
|
||||||
|
ssh root@192.168.68.4 # hwepve (abiba, kagentz, mumuni)
|
||||||
```
|
```
|
||||||
|
|
||||||
## Section 7: Agent Health Check (consolidated — 2026-07-05)
|
## Section 7: Agent Health Check (consolidated — 2026-07-05)
|
||||||
|
|||||||
@@ -0,0 +1,200 @@
|
|||||||
|
---
|
||||||
|
kind: responsibility
|
||||||
|
name: infrastructure-maintenance
|
||||||
|
description: >
|
||||||
|
Weekly system-level maintenance for the Syslog inference fleet: OS package
|
||||||
|
updates on the primary host, Docker image pulls for LiteLLM/SearXNG and other
|
||||||
|
running containers, container restarts with health verification, post-update
|
||||||
|
verification of every critical service (LiteLLM proxy, SearXNG, Zulip, Gitea,
|
||||||
|
PM2 processes, Hermes gateways), and rollback on failure. Consolidates the
|
||||||
|
raw shell scripts that previously did this piecemeal. This contract owns the
|
||||||
|
HOST-LEVEL weekly maintenance loop on the primary host plus Docker image
|
||||||
|
pulls ONLY for .116 and .7, while infrastructure-update owns the FULL-FLEET
|
||||||
|
cluster-wide wave (apt across the full PVE cluster + CTs/VMs AND its Docker
|
||||||
|
image Wave 3 across all stacks). Runs Sunday 2am ET. Owner:
|
||||||
|
ops (firstmate secondmate). Blast radius: an unverified image pull can break
|
||||||
|
LiteLLM (all agents lose inference) or SearXNG (search-stack down); a bad apt
|
||||||
|
upgrade can leave the host in a half-upgraded state. Pre-update backup check
|
||||||
|
and rollback are mandatory for this reason.
|
||||||
|
agent: ops
|
||||||
|
triggers:
|
||||||
|
- weekly (Sunday 02:00 ET) via cron
|
||||||
|
- on demand when ops/abiba triggers "infra maintenance"
|
||||||
|
version: 1.0.0
|
||||||
|
---
|
||||||
|
|
||||||
|
## Maintains
|
||||||
|
|
||||||
|
- maintenance-status: { phase: idle|preflight|apt|images|restarts|verify|rollback|done|failed, host, step, result, timestamp }
|
||||||
|
- image-baseline: { service, current_tag, pulled_tag, digest, updated_at } — last known-good image per container
|
||||||
|
- apt-state: { upgradable_before, upgradable_after, held_broken, kernel_reboot_required }
|
||||||
|
- health-baseline: snapshot of critical-service health captured pre-update (used for regression check post-update)
|
||||||
|
- rollback-snapshot: { backup_path, configs, image_digests, timestamp } — restore point created in preflight
|
||||||
|
- maintenance-history: array of past runs with phase results and any escalations
|
||||||
|
|
||||||
|
## Scope
|
||||||
|
|
||||||
|
Primary host is the maintenance host where apt updates apply. Docker image pulls
|
||||||
|
span the two Docker ecosystems that run critical services. infrastructure-update
|
||||||
|
runs the full-fleet cluster-wide wave (including its Wave 3 Docker pulls across
|
||||||
|
all stacks/hosts); this contract runs a narrower host-level weekly pull limited
|
||||||
|
to .116 and .7. Topology, CT IDs, and IPs are live-state fields — verify against
|
||||||
|
`infrastructure-control.prose.md` (the source of truth) and the live system
|
||||||
|
before mutating.
|
||||||
|
|
||||||
|
| Host | IP | Role | Trust |
|
||||||
|
|------|----|------|-------|
|
||||||
|
| CT 116 (syslog-api) | 192.168.68.116 | LiteLLM proxy + Grafana + Prometheus (inference harness) | ⚠️ VERIFY-BEFORE-USE |
|
||||||
|
| VM 109 (docker-vm) | 192.168.68.7 | SearXNG + Firecrawl + home stack (Docker host) | ⚠️ VERIFY-BEFORE-USE |
|
||||||
|
| CT 117 (zulip) | 192.168.68.19 | Zulip (storepve bridge IP .19) | ⚠️ VERIFY-BEFORE-USE |
|
||||||
|
| Gitea | https://git.sysloggh.net | Prose-contracts + agent configs source control | ⚠️ VERIFY-BEFORE-USE |
|
||||||
|
| CT 100 (abiba/pi) | 192.168.68.24 | PM2 processes (pi agent harness) | ⚠️ VERIFY-BEFORE-USE |
|
||||||
|
|
||||||
|
> "Primary host" for the apt phase is the host the ops agent runs maintenance
|
||||||
|
> from. Confirm which host that is against infrastructure-control before
|
||||||
|
> running; do not assume. If the ops agent is containerized/CT-based, apt runs
|
||||||
|
> inside that CT.
|
||||||
|
|
||||||
|
## Requires
|
||||||
|
|
||||||
|
- SSH/exec access to CT 116 (.116) and VM 109 (.7) for Docker operations
|
||||||
|
- `apt`, `docker`, `docker compose` available on target hosts
|
||||||
|
- LiteLLM master key available (Infisical vault, `LITELLM_API_KEY`) for health verification
|
||||||
|
- `infrastructure-monitoring` run completed within the last 30 minutes — provides the pre-update health baseline used by the regression check
|
||||||
|
- Writable backup directory `/tmp/infra-maintenance-backup-<date>/` on each mutated host
|
||||||
|
- Proxmox snapshot of the primary host available (or confirmed not required) before apt phase
|
||||||
|
|
||||||
|
## Continuity
|
||||||
|
|
||||||
|
- Self-driven: weekly cron `0 2 * * 0` (Sunday 02:00 ET)
|
||||||
|
- Also wakes on: explicit "infra maintenance" trigger from ops/abiba
|
||||||
|
- Depends on `infrastructure-monitoring` for the pre-update health baseline — do not run if the last monitoring run is stale (>30 min) or RED; abort and escalate instead
|
||||||
|
|
||||||
|
## Execution
|
||||||
|
|
||||||
|
### Phase 0 — Preflight (snapshot/backup check + health baseline)
|
||||||
|
|
||||||
|
1. **Capture health baseline** — run the `infrastructure-monitoring` postcondition checks (LiteLLM, Zulip, Gitea, SearXNG, Proxmox API) and record results as `health-baseline`. If any critical service is already down, **abort**: maintenance must not run on a degraded fleet.
|
||||||
|
2. **Backup check** — confirm a Proxmox snapshot of the primary host exists OR `/tmp/infra-maintenance-backup-<date>/` was created this run. Snapshot critical config files into the backup dir:
|
||||||
|
- `/opt/inference-harness/docker-compose.yml`, `/opt/inference-harness/litellm_config.yaml` (CT 116)
|
||||||
|
- `/opt/search-stack/searxng/docker-compose.yml`, `/opt/search-stack/firecrawl-source/docker-compose.yaml` (VM 109)
|
||||||
|
3. **Record image baseline** — `docker inspect --format '{{.Image}} {{.Config.Image}}' <container>` for every running container on .116 and .7; store digests in `image-baseline` so rollback can restore them.
|
||||||
|
4. **Disk check** — `df -h` on each mutated host; abort if free space <20% (apt upgrade + image pulls need headroom).
|
||||||
|
|
||||||
|
### Phase 1 — OS package updates (primary host)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# On the primary host only (VERIFY host against infrastructure-control first)
|
||||||
|
apt update
|
||||||
|
apt upgrade -y
|
||||||
|
```
|
||||||
|
|
||||||
|
- Capture `apt list --upgradable` before and after → store in `apt-state`.
|
||||||
|
- If apt reports held/broken packages (`apt-get -s upgrade | grep -i broken`, or non-zero exit), **stop** — do not force. Record `held_broken` and go to rollback/escalate.
|
||||||
|
- If `/var/run/reboot-required` exists after upgrade, flag `kernel_reboot_required: true` in `apt-state` but **do not reboot automatically** — that's a separate coordinated action (see infra-update Wave 4). Note it in the report.
|
||||||
|
|
||||||
|
### Phase 2 — Docker image pulls
|
||||||
|
|
||||||
|
Pull latest stable tags for every running container. Do NOT pin to `:main`/`:nightly` — use stable tags where the compose file specifies them; otherwise `latest`.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# CT 116 (.116) — inference harness
|
||||||
|
cd /opt/inference-harness && docker compose pull
|
||||||
|
|
||||||
|
# VM 109 (.7) — search + home stacks
|
||||||
|
cd /opt/search-stack/searxng && docker compose pull
|
||||||
|
cd /opt/search-stack/firecrawl-source && docker compose pull
|
||||||
|
# any other running stacks on .7 (home stack, audiobookshelf) — pull per their compose files
|
||||||
|
```
|
||||||
|
|
||||||
|
- LiteLLM and SearXNG are the two explicitly required pulls; "any other running containers" means every stack with a compose file on .116 and .7.
|
||||||
|
- Record pulled tag + digest per service in `image-baseline`.
|
||||||
|
|
||||||
|
### Phase 3 — Container restarts with health verification
|
||||||
|
|
||||||
|
Restart one stack at a time, verify health before moving to the next. Do not restart everything at once — a failure mid-wave must leave the rest running.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# CT 116
|
||||||
|
cd /opt/inference-harness && docker compose up -d
|
||||||
|
# VM 109
|
||||||
|
cd /opt/search-stack/searxng && docker compose up -d
|
||||||
|
cd /opt/search-stack/firecrawl-source && docker compose up -d
|
||||||
|
```
|
||||||
|
|
||||||
|
After each stack comes up, wait for health (max 120s):
|
||||||
|
- `docker ps` shows the container `Up` (and `healthy` if a healthcheck is defined)
|
||||||
|
- Service-specific probe passes (see Phase 4 probes)
|
||||||
|
|
||||||
|
If a stack fails to come up within 120s, **stop the wave** and go to rollback for that stack only; do not proceed to the next.
|
||||||
|
|
||||||
|
### Phase 4 — Post-update service verification
|
||||||
|
|
||||||
|
After ALL updates (apt + images + restarts), verify every critical service is back up and matches the pre-update baseline. This is the regression gate.
|
||||||
|
|
||||||
|
| Service | Probe | Expect |
|
||||||
|
|---------|-------|--------|
|
||||||
|
| LiteLLM proxy | `curl -sf http://192.168.68.116/litellm/v1/models` | 200 OK, models returned |
|
||||||
|
| LiteLLM MCP gateway | `curl -sf http://192.168.68.116:4000/mcp-rest/tools/list -H "Authorization: Bearer $MASTER_KEY"` | 90 tools (23 RA-H OS + 67 GitHub) |
|
||||||
|
| SearXNG | `curl -sf http://192.168.68.7:8888` | 200 OK |
|
||||||
|
| Zulip | `curl -sf https://chat.sysloggh.net/api/v1/server_settings` | 200 OK |
|
||||||
|
| Gitea | `curl -sf https://git.sysloggh.net/api/v1/version` | 200 OK |
|
||||||
|
| PM2 processes | `pm2 jlist` (CT 100) | all pi-agent processes `online` |
|
||||||
|
| Hermes gateways | SSH to Mumuni CT 114, Tanko CT 112; `systemctl is-active hermes-gateway` | `active` for each |
|
||||||
|
|
||||||
|
Regression check: every service that was GREEN in `health-baseline` must still be GREEN. A service that was already RED (and caused a preflight abort) is excluded — but Phase 0 should have aborted before we got here.
|
||||||
|
|
||||||
|
## Rollback Protocol
|
||||||
|
|
||||||
|
If ANY service in Phase 4 fails to come back up (or regresses vs baseline):
|
||||||
|
|
||||||
|
1. **Image rollback** — for the failing stack, restore the previous image:
|
||||||
|
```bash
|
||||||
|
# Restore from recorded image-baseline digest
|
||||||
|
docker compose down
|
||||||
|
# Pin the service image to the recorded digest in compose, then recreate
|
||||||
|
# image: <name>@sha256:<previous_digest>
|
||||||
|
docker compose pull && docker compose up -d
|
||||||
|
```
|
||||||
|
2. **APT rollback** — restore the primary host from the Proxmox snapshot taken/confirmed in Phase 0. If no snapshot, `apt install <pkg>=<old_version>` per package using apt history (`/var/log/apt/history.log`).
|
||||||
|
3. **Config rollback** — restore configs from `/tmp/infra-maintenance-backup-<date>/`.
|
||||||
|
4. **Re-verify** — re-run the Phase 4 probes on the rolled-back service. If still failing, escalate (do not loop — circuit breaker below).
|
||||||
|
5. **Escalate** — send a Zulip DM to abiba + mumuni with: failing service, phase, baseline vs current, rollback actions taken, backup path.
|
||||||
|
|
||||||
|
## Circuit Breaker
|
||||||
|
|
||||||
|
- `max_retries: 2` per failing phase — after 2 rollback attempts on the same service, stop and escalate.
|
||||||
|
- `window: 7200` seconds — no more than 2 retries within a 2-hour window.
|
||||||
|
- `trip_action: escalate_to_fatal` — when tripped, escalate to fatal (abiba + mumuni + kwame) and pause; a human must clear before the next scheduled run.
|
||||||
|
|
||||||
|
## Report
|
||||||
|
|
||||||
|
After completion (or on abort), emit a receipt (JSON) to `~/.hermes/runs/infrastructure-maintenance/` and send a Zulip DM summary:
|
||||||
|
|
||||||
|
```
|
||||||
|
🛠 Infrastructure Maintenance — YYYY-MM-DD
|
||||||
|
|
||||||
|
Phase: apt | images | restarts | verify | rollback
|
||||||
|
Primary host: <host>
|
||||||
|
APT: <N> packages upgraded, <M> held/broken, kernel_reboot_required=<bool>
|
||||||
|
Images pulled: LiteLLM <tag>, SearXNG <tag>, <others>
|
||||||
|
Services: all GREEN | <service> FAILED (rolled back)
|
||||||
|
Baseline regression: none | <details>
|
||||||
|
Backup: /tmp/infra-maintenance-backup-YYYYMMDD/
|
||||||
|
Escalation: none | warning | critical | fatal
|
||||||
|
```
|
||||||
|
|
||||||
|
## Verification Postconditions
|
||||||
|
|
||||||
|
- All critical services running after update (Phase 4 all GREEN)
|
||||||
|
- No regressions from pre-update health baseline (Phase 0 baseline)
|
||||||
|
- Docker containers on latest stable tags (`image-baseline.pulled_tag` recorded)
|
||||||
|
- APT packages up to date with no held broken packages (`apt-state.held_broken == 0`)
|
||||||
|
|
||||||
|
## Related Contracts
|
||||||
|
|
||||||
|
- `infrastructure-update.prose.md` — owns the full-fleet cluster-wide wave INCLUDING its Wave 3 Docker image updates across all stacks (SearXNG, Firecrawl, Inference Harness on .116, home stack, audiobookshelf); infrastructure-maintenance is a deliberately narrower host-level weekly pull scoped to .116 and .7.
|
||||||
|
- `infrastructure-monitoring.prose.md` — provides the pre-update health baseline (depends_on).
|
||||||
|
- `infrastructure-control.prose.md` — topology source of truth (CT IDs, IPs, hostnames).
|
||||||
|
- `litellm-health.prose.md` — LiteLLM probe details.
|
||||||
|
- `proxmox-monitor.prose.md` — Docker stats + monitoring stack health.
|
||||||
@@ -67,7 +67,7 @@ Before ANY update wave:
|
|||||||
- All VMs/CTs running: check via Proxmox API
|
- All VMs/CTs running: check via Proxmox API
|
||||||
- LiteLLM healthy: `curl localhost:4000/health/liveliness` (via CT 116)
|
- LiteLLM healthy: `curl localhost:4000/health/liveliness` (via CT 116)
|
||||||
- LiteLLM MCP tools: `curl localhost:4000/mcp-rest/tools/list -H "Authorization: Bearer $MASTER_KEY"` → 90 tools
|
- LiteLLM MCP tools: `curl localhost:4000/mcp-rest/tools/list -H "Authorization: Bearer $MASTER_KEY"` → 90 tools
|
||||||
- GPU servers responding: check :8080 on VM 101, VM 103; check ornith via router (http://192.168.68.116/health/unified — .15:8080 is firewalled to .116 only)
|
- GPU servers responding: check :8080 on VM 101, VM 103; check strix-moe via router (http://192.168.68.116/health/unified — .15:8080 is firewalled to .116 only)
|
||||||
- Zulip agents connected: check Mumuni/Tanko gateway state
|
- Zulip agents connected: check Mumuni/Tanko gateway state
|
||||||
- Abiba PM2 processes online: `pm2 status`
|
- Abiba PM2 processes online: `pm2 status`
|
||||||
|
|
||||||
@@ -91,17 +91,54 @@ Before ANY update wave:
|
|||||||
- Firecrawl test: `curl :3002/`
|
- Firecrawl test: `curl :3002/`
|
||||||
- SearXNG test: `curl :8888`
|
- SearXNG test: `curl :8888`
|
||||||
|
|
||||||
## Wave 4: Proxmox Kernel Reboot (if needed)
|
## Wave 4: Proxmox Kernel Reboot
|
||||||
|
|
||||||
Only if `[ -f /var/run/reboot-required ]` on any node.
|
Only if `[ -f /var/run/reboot-required ]` on any node.
|
||||||
|
|
||||||
| Target | Action |
|
| Target | Action |
|
||||||
|--------|--------|
|
|--------|--------|
|
||||||
| Affected PVE node | Verify all CTs/VMs migrated or stopped |
|
| Affected PVE node | Verify all CTs/VMs migrated or stopped |
|
||||||
| | `reboot` via PVE API |
|
| | `reboot` via PVE API (or `systemctl reboot -f` if dbus fails) |
|
||||||
| | Wait 120s for node to come back |
|
| | Wait 120s for node to come back |
|
||||||
| | Start any stopped CTs |
|
| | Start any stopped CTs |
|
||||||
|
|
||||||
|
### Post-reboot sweep (known gaps)
|
||||||
|
|
||||||
|
After every node reboot, run these checks:
|
||||||
|
|
||||||
|
1. **CT auto-start sweep** — LXC containers sometimes don't start despite
|
||||||
|
`onboot: 1`. Check every CT on the rebooted node and start any left stopped:
|
||||||
|
```bash
|
||||||
|
pct list | awk '/stopped/{print $1}' | xargs -I{} pct start {}
|
||||||
|
```
|
||||||
|
Known cases: scottdenya (CT 115 on amdpve), authentik (CT 104 on minipve).
|
||||||
|
|
||||||
|
2. **Zulip recovery** — When docker-vm or storepve reboots, the Zulip main
|
||||||
|
container loses its Docker network assignment (SIGKILL during storage
|
||||||
|
outage detaches it from `zulip_default` network). Run:
|
||||||
|
```bash
|
||||||
|
ssh root@192.168.68.19
|
||||||
|
docker rm -f zulip-zulip-1
|
||||||
|
cd /opt/zulip && docker compose up -d
|
||||||
|
```
|
||||||
|
The compose restart recreates the container on the correct network.
|
||||||
|
|
||||||
|
3. **docker-vm Docker daemon** — After reboot, Docker can take 3-4 minutes
|
||||||
|
to become `active`. The docker-proxy for Pulse (port 7655) starts early,
|
||||||
|
so Pulse is accessible before `docker ps` reports ready. Wait for Docker
|
||||||
|
before checking other stacks.
|
||||||
|
|
||||||
|
### VPS ↔ docker-vm tunnel
|
||||||
|
|
||||||
|
After any VPS or docker-vm reboot, verify the dedicated WireGuard tunnel:
|
||||||
|
```bash
|
||||||
|
ssh root@72.61.0.17 'wg show wg1' | grep "latest handshake"
|
||||||
|
# If no handshake in >60s:
|
||||||
|
ssh root@72.61.0.17 'wg-quick up wg1'
|
||||||
|
```
|
||||||
|
The tunnel uses PersistentKeepalive=25 and is systemd-enabled, but should
|
||||||
|
be verified after a reboot.
|
||||||
|
|
||||||
## Rollback Protocol
|
## Rollback Protocol
|
||||||
|
|
||||||
If ANY verification fails:
|
If ANY verification fails:
|
||||||
@@ -124,7 +161,7 @@ Before Wave 1, snapshot these files:
|
|||||||
/opt/home_stack/docker-compose.yml (VM 109 .7)
|
/opt/home_stack/docker-compose.yml (VM 109 .7)
|
||||||
/opt/audiobookshelf/docker-compose.yml (VM 109 .7)
|
/opt/audiobookshelf/docker-compose.yml (VM 109 .7)
|
||||||
/root/.pi/agent/extensions/config.yaml (CT 100 .24)
|
/root/.pi/agent/extensions/config.yaml (CT 100 .24)
|
||||||
/etc/systemd/system/ornith-server.service (amdpve .15)
|
/etc/systemd/system/ornith-server.service (amdpve .15 — strix-moe)
|
||||||
/etc/systemd/system/llama-server.service (VM 101 .8, VM 103 .110)
|
/etc/systemd/system/llama-server.service (VM 101 .8, VM 103 .110)
|
||||||
# Hermes agent configs (key enforcement — 2026-07-10)
|
# Hermes agent configs (key enforcement — 2026-07-10)
|
||||||
/root/.hermes/config.yaml (Mumuni CT 114, Tanko CT 112, etc.)
|
/root/.hermes/config.yaml (Mumuni CT 114, Tanko CT 112, etc.)
|
||||||
|
|||||||
@@ -8,18 +8,18 @@ description: >
|
|||||||
Ensures agents never use the master key directly. Rotation is event-driven,
|
Ensures agents never use the master key directly. Rotation is event-driven,
|
||||||
not calendar-driven — rotate only on compromise, personnel change, or
|
not calendar-driven — rotate only on compromise, personnel change, or
|
||||||
periodic security hygiene (quarterly/annually).
|
periodic security hygiene (quarterly/annually).
|
||||||
|
|
||||||
UPDATED 2026-07-12: Keys are stored in Infisical vault (project=agents, env=production)
|
UPDATED 2026-07-12: Keys are stored in Infisical vault (project=agents, env=production)
|
||||||
BUT each agent host MUST keep a local .env fallback. Infisical service tokens can
|
BUT each agent host MUST keep a local .env fallback. Infisical service tokens can
|
||||||
expire/404. The .env fallback prevents agents from running without keys.
|
expire/404. The .env fallback prevents agents from running without keys.
|
||||||
Tanko incident: token 404 → gateway had no LITELLM_API_KEY for hours.
|
Tanko incident: token 404 → gateway had no LITELLM_API_KEY for hours.
|
||||||
|
|
||||||
UPDATED 2026-07-16: Vault is SYNCED (session-13 keys written to vault via abiba service
|
UPDATED 2026-07-16: Vault is SYNCED (session-13 keys written to vault via abiba service
|
||||||
token, all validate 200). Koby/Koonimo migrated from hardcoded drop-ins to the
|
token, all validate 200). Koby/Koonimo migrated from hardcoded drop-ins to the
|
||||||
infisical-gateway.sh wrapper (live vault injection). 4/5 agents now vault-backed.
|
infisical-gateway.sh wrapper (live vault injection). 4/5 agents now vault-backed.
|
||||||
Canonical process: see § Production Vault Access Process. Tanko (user jerome) pending.
|
Canonical process: see § Production Vault Access Process. Tanko (user jerome) pending.
|
||||||
Abiba's key is now a proper agent key (NOT the master key — stale note removed).
|
Abiba's key is now a proper agent key (NOT the master key — stale note removed).
|
||||||
|
|
||||||
UPDATED 2026-07-17: FLEET-WIDE STANDARDIZATION. All 4 agents (Mumuni, Tanko, Koby, Koonimo)
|
UPDATED 2026-07-17: FLEET-WIDE STANDARDIZATION. All 4 agents (Mumuni, Tanko, Koby, Koonimo)
|
||||||
standardized on a single pattern: systemd drop-in (ExecStart= reset + wrapper path) →
|
standardized on a single pattern: systemd drop-in (ExecStart= reset + wrapper path) →
|
||||||
infisical-gateway.sh while-true loop → /usr/bin/infisical run --token → bash -c key
|
infisical-gateway.sh while-true loop → /usr/bin/infisical run --token → bash -c key
|
||||||
@@ -30,7 +30,7 @@ description: >
|
|||||||
Critical lessons: (1) NEVER use shell variables inside single-quoted bash -c in wrappers
|
Critical lessons: (1) NEVER use shell variables inside single-quoted bash -c in wrappers
|
||||||
— hardcode absolute paths. (2) Drop-ins override unit file ExecStart permanently.
|
— hardcode absolute paths. (2) Drop-ins override unit file ExecStart permanently.
|
||||||
(3) Capture /proc/<pid>/environ before gateway restarts to preserve running env set.
|
(3) Capture /proc/<pid>/environ before gateway restarts to preserve running env set.
|
||||||
|
|
||||||
Current key inventory and agent list: see gpu-fleet.prose.md § Agent Keys.
|
Current key inventory and agent list: see gpu-fleet.prose.md § Agent Keys.
|
||||||
Source of truth for LiteLLM config: /opt/inference-harness/litellm_config.yaml
|
Source of truth for LiteLLM config: /opt/inference-harness/litellm_config.yaml
|
||||||
on CT 116. Last verified: 2026-07-17.
|
on CT 116. Last verified: 2026-07-17.
|
||||||
@@ -154,7 +154,7 @@ through its agent wrapper.
|
|||||||
The `ExecStart=` (empty reset) clears any ExecStart from the main unit file,
|
The `ExecStart=` (empty reset) clears any ExecStart from the main unit file,
|
||||||
then the second `ExecStart=` sets the wrapper. This drop-in **survives unit file
|
then the second `ExecStart=` sets the wrapper. This drop-in **survives unit file
|
||||||
regeneration** by `hermes gateway install` — the drop-in always wins.
|
regeneration** by `hermes gateway install` — the drop-in always wins.
|
||||||
|
|
||||||
**Why a drop-in instead of editing the unit file:** `hermes gateway install`
|
**Why a drop-in instead of editing the unit file:** `hermes gateway install`
|
||||||
(called during Hermes updates and some self-heal operations) regenerates the
|
(called during Hermes updates and some self-heal operations) regenerates the
|
||||||
systemd unit file with `ExecStart=/path/to/python -m hermes_cli.main gateway run`.
|
systemd unit file with `ExecStart=/path/to/python -m hermes_cli.main gateway run`.
|
||||||
@@ -171,7 +171,7 @@ through its agent wrapper.
|
|||||||
- **Survives gateway crash**: the wrapper's `while true` + systemd `Restart=always` revive the gateway. Two-layer defense.
|
- **Survives gateway crash**: the wrapper's `while true` + systemd `Restart=always` revive the gateway. Two-layer defense.
|
||||||
- **Survives Hermes updates**: systemd drop-in overrides unit file ExecStart — `hermes gateway install` cannot break the vault injection.
|
- **Survives Hermes updates**: systemd drop-in overrides unit file ExecStart — `hermes gateway install` cannot break the vault injection.
|
||||||
- **Survives reboot**: systemd user service + `loginctl enable-linger` ensures gateway starts at boot without a login session.
|
- **Survives reboot**: systemd user service + `loginctl enable-linger` ensures gateway starts at boot without a login session.
|
||||||
- **Auditable**: `cat /proc/$(pgrep hermes_cli)/environ` shows all injected keys; `infisical secrets` shows the vault source.
|
- **Auditable**: `cat /proc/$(pgrep -f 'python.*hermes_cli.main.gateway.run' | grep -v infisical | head -1)/environ` shows all injected keys (note: pipe through grep -v infisical to avoid matching the bash wrapper); `infisical secrets` shows the vault source.
|
||||||
|
|
||||||
### Migration status (2026-07-17)
|
### Migration status (2026-07-17)
|
||||||
|
|
||||||
|
|||||||
@@ -42,7 +42,7 @@ Request → nginx:80 → LiteLLM:4000 → GPU(llama-server, parallel 2)
|
|||||||
**What changed (v3.2.0 → v4.0.0 — 2026-07-08)**:
|
**What changed (v3.2.0 → v4.0.0 — 2026-07-08)**:
|
||||||
- Router REMOVED from request path — LiteLLM proxies directly to GPU
|
- Router REMOVED from request path — LiteLLM proxies directly to GPU
|
||||||
- All GPUs at parallel 2 (was parallel 1)
|
- All GPUs at parallel 2 (was parallel 1)
|
||||||
- NVIDIA context reduced 256K→128K to free VRAM (SUPERSEDED 2026-07-16: all GPUs back to 256K — see litellm-self-heal)
|
- NVIDIA context reduced 256K→128K to free VRAM — now the stable ceiling across all GPUs (2026-07-17)
|
||||||
- LiteLLM timeouts tuned: gemma 25→120s, qwen 40→90s (SUPERSEDED 2026-07-16: qwen 300s, gemma 120s, strix 300s — see litellm-self-heal)
|
- LiteLLM timeouts tuned: gemma 25→120s, qwen 40→90s (SUPERSEDED 2026-07-16: qwen 300s, gemma 120s, strix 300s — see litellm-self-heal)
|
||||||
- nginx proxy_read_timeout: 600s, LiteLLM request_timeout: 300s
|
- nginx proxy_read_timeout: 600s, LiteLLM request_timeout: 300s
|
||||||
|
|
||||||
@@ -72,9 +72,9 @@ Request → nginx:80 → LiteLLM:4000 → GPU(llama-server, parallel 2)
|
|||||||
|
|
||||||
| Host | IP | Hardware | Models Served | Engine | Context | Parallel |
|
| Host | IP | Hardware | Models Served | Engine | Context | Parallel |
|
||||||
|------|-----|----------|---------------|--------|---------|----------|
|
|------|-----|----------|---------------|--------|---------|----------|
|
||||||
| llm-gpu | 192.168.68.8 | NVIDIA RTX 3090 (24 GB) | qwen3.6-27B-code | llama-server systemd | **256K** | 2 |
|
| llm-gpu | 192.168.68.8 | NVIDIA RTX 3090 (24 GB) | qwen3.6-27B-code | llama-server systemd | **128K** | 2 |
|
||||||
| ocu-llm | 192.168.68.110 | NVIDIA RTX 5070 (12 GB) | gemma-4-12b | llama-server systemd | **256K** | 2 |
|
| ocu-llm | 192.168.68.110 | NVIDIA RTX 5070 (12 GB) | gemma-4-12b | llama-server systemd | **128K** | 2 |
|
||||||
| amdpve | 192.168.68.15 | AMD Strix Halo 64GB UMA | qwen3.6-35B-udq4 (LiteLLM alias: strix-moe) | llama-server systemd (Vulkan) | 256K | 2 |
|
| amdpve | 192.168.68.15 | AMD Strix Halo 64GB UMA | qwen3.6-35B-udq4 (LiteLLM alias: strix-moe) | llama-server systemd (Vulkan) | 128K | 2 |
|
||||||
|
|
||||||
## Model Fallback Chains (LiteLLM)
|
## Model Fallback Chains (LiteLLM)
|
||||||
|
|
||||||
|
|||||||
@@ -57,9 +57,9 @@ Request → nginx:80 → LiteLLM:4000 → GPU(llama-server, parallel 2)
|
|||||||
|
|
||||||
| Host | IP | Hardware | Models Served | Engine | Context | Parallel |
|
| Host | IP | Hardware | Models Served | Engine | Context | Parallel |
|
||||||
|------|-----|----------|---------------|--------|---------|----------|
|
|------|-----|----------|---------------|--------|---------|----------|
|
||||||
| llm-gpu | 192.168.68.8 | NVIDIA RTX 3090 (24 GB) | qwen3.6-27B-code | llama-server systemd (`/home/llmuser/llama-wrapper.sh`, `-c 262144 --parallel 2 --ngl 99`) | **256K** | 2 |
|
| llm-gpu | 192.168.68.8 | NVIDIA RTX 3090 (24 GB) | qwen3.6-27B-code | llama-server systemd (`/home/llmuser/llama-wrapper.sh`, `-c 131072 --parallel 2 --ngl 99`) | **128K** | 2 |
|
||||||
| ocu-llm | 192.168.68.110 | NVIDIA RTX 5070 (12 GB) | gemma-4-12b | llama-server systemd (`/home/llmuser/llama-wrapper.sh`, `--ctx-size 262144 --parallel 2`, IQ4_NL + MTP draft) | **256K** | 2 |
|
| ocu-llm | 192.168.68.110 | NVIDIA RTX 5070 (12 GB) | gemma-4-12b | llama-server systemd (`/home/llmuser/llama-wrapper.sh`, `--ctx-size 131072 --parallel 2`, IQ4_NL + MTP draft) | **128K** | 2 |
|
||||||
| amdpve | 192.168.68.15 | AMD Strix Halo 64GB UMA | qwen3.6-35B-udq4 (LiteLLM alias: `strix-moe`) | llama-server systemd (Vulkan) | 256K | 2 |
|
| amdpve | 192.168.68.15 | AMD Strix Halo 64GB UMA | qwen3.6-35B-udq4 (LiteLLM alias: `strix-moe`) | llama-server systemd (Vulkan) | 128K | 2 |
|
||||||
|
|
||||||
> Verified on ground 2026-07-16 via `curl /v1/models` on each host + `llama-wrapper.sh`. The AMD host's underlying model is `qwen3.6-35B-udq4`; LiteLLM exposes it under two `model_name`s: `qwen3.6-35B-udq4` and `strix-moe` (rpm 40). The legacy name `ornith-1.0-35b` does NOT exist in LiteLLM and must not be referenced.
|
> Verified on ground 2026-07-16 via `curl /v1/models` on each host + `llama-wrapper.sh`. The AMD host's underlying model is `qwen3.6-35B-udq4`; LiteLLM exposes it under two `model_name`s: `qwen3.6-35B-udq4` and `strix-moe` (rpm 40). The legacy name `ornith-1.0-35b` does NOT exist in LiteLLM and must not be referenced.
|
||||||
|
|
||||||
@@ -101,7 +101,7 @@ Request → nginx:80 → LiteLLM:4000 → GPU(llama-server, parallel 2)
|
|||||||
## Script Operations (synced 2026-07-16)
|
## Script Operations (synced 2026-07-16)
|
||||||
|
|
||||||
- **Health-check script** (`/opt/inference-harness/scripts/litellm-health-check.sh` on CT 116): `gpu-fleet` check fails only on **critical** alerts (warnings are informational). Tests `strix-moe` (not `ornith-1.0-35b`).
|
- **Health-check script** (`/opt/inference-harness/scripts/litellm-health-check.sh` on CT 116): `gpu-fleet` check fails only on **critical** alerts (warnings are informational). Tests `strix-moe` (not `ornith-1.0-35b`).
|
||||||
- **GPU monitor** (`/root/scripts/gpu-monitor-server.py` on pi .24): runs as **systemd unit `gpu-monitor.service`** (was bare `&` process). `gpu_count` includes Strix Halo (was 2, now 3). VRAM alert thresholds: warning 93%, critical 97% (raised from 90/95 — 256K context steady-state is ~96% on RTX 3090, not a fault).
|
- **GPU monitor** (`/root/scripts/gpu-monitor-server.py` on pi .24): runs as **systemd unit `gpu-monitor.service`** (was bare `&` process). `gpu_count` includes Strix Halo (was 2, now 3). VRAM alert thresholds: warning 93%, critical 97% (raised from 90/95 — 128K context steady-state is ~70% on RTX 3090, not a fault).
|
||||||
- **Agent key monitor** (`/root/scripts/agent-health-check.py` on pi .24, cron `*/10`): reads each agent's **live** `LITELLM_API_KEY` from its gateway process env via SSH — never hardcodes keys (hardcoded keys rot on rotation and caused 9×401/30min). Fleet roster: abiba, tanko, mumuni, koby, koonimo (legacy `tdunna`/`baggy` removed — never existed).
|
- **Agent key monitor** (`/root/scripts/agent-health-check.py` on pi .24, cron `*/10`): reads each agent's **live** `LITELLM_API_KEY` from its gateway process env via SSH — never hardcodes keys (hardcoded keys rot on rotation and caused 9×401/30min). Fleet roster: abiba, tanko, mumuni, koby, koonimo (legacy `tdunna`/`baggy` removed — never existed).
|
||||||
- **Stale keys cleaned**: `daily-infra-report.py` SYNTHETIC_API_KEY was stale (`sk-U_ydi3B` → 401); now reads `LITELLM_MASTER_KEY` from env. Deprecated scripts (`router-original.py`, `router-phase0-backup.py`, `apply-fixes.py`) still reference `sk-syslog-local-master-key` but do not actively poll LiteLLM.
|
- **Stale keys cleaned**: `daily-infra-report.py` SYNTHETIC_API_KEY was stale (`sk-U_ydi3B` → 401); now reads `LITELLM_MASTER_KEY` from env. Deprecated scripts (`router-original.py`, `router-phase0-backup.py`, `apply-fixes.py`) still reference `sk-syslog-local-master-key` but do not actively poll LiteLLM.
|
||||||
|
|
||||||
|
|||||||
@@ -6,7 +6,7 @@ description: >
|
|||||||
delegation, verification, and delivery. Defines when to delegate, which
|
delegation, verification, and delivery. Defines when to delegate, which
|
||||||
worker to use for what, how to handle failures, and the kanban board
|
worker to use for what, how to handle failures, and the kanban board
|
||||||
protocol. Enforces context-window discipline and separation of concerns.
|
protocol. Enforces context-window discipline and separation of concerns.
|
||||||
Runs on Mumuni (CT 118, storepve, .6) via Hermes agent.
|
Runs on Mumuni (lxc/114, hwepve, .123) via Hermes agent.
|
||||||
version: 1.0.0
|
version: 1.0.0
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -19,8 +19,8 @@ version: 1.0.0
|
|||||||
|
|
||||||
## Topology
|
## Topology
|
||||||
|
|
||||||
**Cluster:** 5 Proxmox nodes (ocupve, acerpve, minipve, amdpve, storepve)
|
**Cluster:** 6 Proxmox nodes (ocupve, acerpve, minipve, amdpve, storepve, hwepve)
|
||||||
**Manager:** Mumuni (CT 118, storepve, .6) via Hermes agent
|
**Manager:** Mumuni (lxc/114, hwepve, .123) via Hermes agent
|
||||||
**Workers:** 6 profiles, all running on the same agent — no separate hosts needed
|
**Workers:** 6 profiles, all running on the same agent — no separate hosts needed
|
||||||
|
|
||||||
This contract is infrastructure-agnostic in terms of which nodes are used.
|
This contract is infrastructure-agnostic in terms of which nodes are used.
|
||||||
|
|||||||
@@ -5,7 +5,7 @@ description: >
|
|||||||
Proxmox cluster + Docker monitoring via the existing Grafana/Prometheus stack
|
Proxmox cluster + Docker monitoring via the existing Grafana/Prometheus stack
|
||||||
on CT 116. Replaces Pulse with file-provisioned Grafana dashboards. Three
|
on CT 116. Replaces Pulse with file-provisioned Grafana dashboards. Three
|
||||||
exporters feed Prometheus: prometheus-pve-exporter (cluster-aware, single
|
exporters feed Prometheus: prometheus-pve-exporter (cluster-aware, single
|
||||||
instance), node_exporter (all 5 PVE nodes), and a custom docker-stats-exporter
|
instance), node_exporter (all 6 PVE nodes), and a custom docker-stats-exporter
|
||||||
(Docker 29 / containerd image-store compatible, since cAdvisor cannot resolve
|
(Docker 29 / containerd image-store compatible, since cAdvisor cannot resolve
|
||||||
the layerdb). Dashboards exposed at http://192.168.68.116:3001/ (direct LAN, not behind nginx).
|
the layerdb). Dashboards exposed at http://192.168.68.116:3001/ (direct LAN, not behind nginx).
|
||||||
agent: abiba
|
agent: abiba
|
||||||
@@ -33,8 +33,8 @@ agent: abiba
|
|||||||
|
|
||||||
| Exporter | Host:Port | Scope | Notes |
|
| Exporter | Host:Port | Scope | Notes |
|
||||||
|----------|-----------|-------|-------|
|
|----------|-----------|-------|-------|
|
||||||
| prometheus-pve-exporter | .116:9221 (container) | All 5 nodes + 14 guests + 36 storage pools | Single instance, cluster-aware via amdpve API. Config `/opt/monitoring/pve.yml` (token `monitoring@pve!prometheus`, PVEAuditor role). Metric schema is label-based (`id=node/amdpve`, `id=lxc/100`). |
|
| prometheus-pve-exporter | .116:9221 (container) | All 6 nodes + guests + 36 storage pools | Single instance, cluster-aware via amdpve API. Config `/opt/monitoring/pve.yml` (token `monitoring@pve!prometheus`, PVEAuditor role). Metric schema is label-based (`id=node/amdpve`, `id=lxc/100`). |
|
||||||
| node_exporter | .5/.6/.9/.12/.15:9100 (systemd) | Per-node CPU/mem/disk/net/temp | Installed via apt on all 5 PVE nodes, enabled (reboot-persistent). Collectors: textfile, systemd, tcpstat, ethtool. |
|
| node_exporter | .5/.6/.9/.12/.15/.4:9100 (systemd) | Per-node CPU/mem/disk/net/temp | Installed via apt on all 6 PVE nodes, enabled (reboot-persistent). Collectors: textfile, systemd, tcpstat, ethtool. hwepve (.4) added 2026-07-19. |
|
||||||
| docker-stats-exporter | .116:9324 (container) | 10 Docker containers on .116 | **Custom** (cAdvisor v0.51 incompatible with Docker 29 containerd image store — layerdb gone). Uses Docker Engine API over unix socket. Script `/opt/monitoring/docker-stats-exporter.py`. |
|
| docker-stats-exporter | .116:9324 (container) | 10 Docker containers on .116 | **Custom** (cAdvisor v0.51 incompatible with Docker 29 containerd image store — layerdb gone). Uses Docker Engine API over unix socket. Script `/opt/monitoring/docker-stats-exporter.py`. |
|
||||||
|
|
||||||
## PVE API Token
|
## PVE API Token
|
||||||
@@ -48,7 +48,7 @@ agent: abiba
|
|||||||
|
|
||||||
| UID | Title | Panels | Source |
|
| UID | Title | Panels | Source |
|
||||||
|-----|-------|--------|--------|
|
|-----|-------|--------|--------|
|
||||||
| proxmox-cluster | Proxmox Cluster Overview | 16 | cluster status, 5-node CPU/mem/disk/load gauges, guests table, storage pools, guest CPU/mem timeseries |
|
| proxmox-cluster | Proxmox Cluster Overview | 16 | cluster status, 6-node CPU/mem/disk/load gauges, guests table, storage pools, guest CPU/mem timeseries |
|
||||||
| proxmox-node | Proxmox Node Detail | 13 | per-node CPU per-core, memory, network, disk IO/IOPS/latency, temperature, disk space (variable: $node) |
|
| proxmox-node | Proxmox Node Detail | 13 | per-node CPU per-core, memory, network, disk IO/IOPS/latency, temperature, disk space (variable: $node) |
|
||||||
| docker-containers | Docker Containers | 10 | per-container CPU/mem/network, restarts, memory limit ratio (variable: $container) |
|
| docker-containers | Docker Containers | 10 | per-container CPU/mem/network, restarts, memory limit ratio (variable: $container) |
|
||||||
| gpu-fleet | GPU Fleet | 7 | (existing, preserved in DB, not provisioned) |
|
| gpu-fleet | GPU Fleet | 7 | (existing, preserved in DB, not provisioned) |
|
||||||
@@ -77,9 +77,9 @@ agent: abiba
|
|||||||
| `/opt/monitoring/grafana/dashboards/build-dashboards.py` | .116 | dashboard JSON generator |
|
| `/opt/monitoring/grafana/dashboards/build-dashboards.py` | .116 | dashboard JSON generator |
|
||||||
| `/opt/monitoring/grafana/dashboards/json/*.json` | .116 | provisioned dashboard definitions |
|
| `/opt/monitoring/grafana/dashboards/json/*.json` | .116 | provisioned dashboard definitions |
|
||||||
| `/opt/monitoring/grafana/datasources/prometheus.yml` | .116 | datasource provisioning |
|
| `/opt/monitoring/grafana/datasources/prometheus.yml` | .116 | datasource provisioning |
|
||||||
| `/etc/default/prometheus-node-exporter` | .5/.6/.9/.12/.15 | node_exporter collector config |
|
| `/etc/default/prometheus-node-exporter` | .5/.6/.9/.12/.15/.4 | node_exporter collector config |
|
||||||
|
|
||||||
## Cluster "Tabiri" — 5 Nodes
|
## Cluster "Tabiri" — 6 Nodes
|
||||||
|
|
||||||
| Node | IP | Role |
|
| Node | IP | Role |
|
||||||
|------|----|----|
|
|------|----|----|
|
||||||
@@ -87,7 +87,8 @@ agent: abiba
|
|||||||
| storepve | 192.168.68.6 | PVE |
|
| storepve | 192.168.68.6 | PVE |
|
||||||
| acerpve | 192.168.68.9 | PVE (hosts llm-gpu qemu/101) |
|
| acerpve | 192.168.68.9 | PVE (hosts llm-gpu qemu/101) |
|
||||||
| minipve | 192.168.68.12 | PVE |
|
| minipve | 192.168.68.12 | PVE |
|
||||||
| amdpve | 192.168.68.15 | PVE + Strix Halo LLM (ornith) |
|
| amdpve | 192.168.68.15 | PVE + Strix Halo LLM (qwen3.6-35B-udq4, strix-moe) |
|
||||||
|
| hwepve | 192.168.68.4 | PVE (Huawei Matebook 16, 12C/15GB) — hosts Mumuni (lxc/114) migrated from minipve 2026-07-20 |
|
||||||
|
|
||||||
## Operations
|
## Operations
|
||||||
|
|
||||||
|
|||||||
@@ -184,8 +184,8 @@ def check_agents():
|
|||||||
print(f" ⬜ {name} (CT {ct}): cannot SSH — skip liveness check")
|
print(f" ⬜ {name} (CT {ct}): cannot SSH — skip liveness check")
|
||||||
continue
|
continue
|
||||||
|
|
||||||
# Gateway process
|
# Gateway process (exclude the infisical bash wrapper that contains the same string)
|
||||||
pid = ssh(host, "pgrep -f 'hermes_cli.main gateway run' | head -1", user=user)
|
pid = ssh(host, "pgrep -f 'hermes_cli.main gateway run' | grep -v infisical | head -1", user=user)
|
||||||
if not pid:
|
if not pid:
|
||||||
print(f" ❌ {name}: GATEWAY NOT RUNNING")
|
print(f" ❌ {name}: GATEWAY NOT RUNNING")
|
||||||
FAIL.append(f"gateway-down:{name}")
|
FAIL.append(f"gateway-down:{name}")
|
||||||
|
|||||||
@@ -0,0 +1,65 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
# Netbird Reverse Proxy — Add a new domain route
|
||||||
|
#
|
||||||
|
# Usage: netbird-add-domain.sh <domain> <backend_ip> [port] [protocol]
|
||||||
|
#
|
||||||
|
# Example:
|
||||||
|
# netbird-add-domain.sh dns.sysloggh.net 192.168.68.10 80
|
||||||
|
#
|
||||||
|
# This script adds a domain to the Netbird proxy by inserting records
|
||||||
|
# directly into the management server's SQLite database, then restarting
|
||||||
|
# the proxy stack.
|
||||||
|
#
|
||||||
|
# Prerequisites: SSH root access to 72.61.0.17
|
||||||
|
# sqlite3 available on VPS
|
||||||
|
#
|
||||||
|
# Requires: The domain must already have a DNS CNAME to netbird.sysloggh.net
|
||||||
|
# pointing to 72.61.0.17.
|
||||||
|
|
||||||
|
set -euo pipefail
|
||||||
|
|
||||||
|
DOMAIN="${1:?Usage: netbird-add-domain.sh <domain> <backend_ip> [port] [protocol]}"
|
||||||
|
BACKEND_IP="${2:?Usage: netbird-add-domain.sh <domain> <backend_ip> [port] [protocol]}"
|
||||||
|
PORT="${3:-80}"
|
||||||
|
PROTOCOL="${4:-http}"
|
||||||
|
|
||||||
|
VPS="root@72.61.0.17"
|
||||||
|
DB_VOLUME="/var/lib/docker/volumes/root_netbird_data/_data"
|
||||||
|
DB="$DB_VOLUME/store.db"
|
||||||
|
|
||||||
|
echo "=== Adding Netbird proxy route ==="
|
||||||
|
echo "Domain: $DOMAIN"
|
||||||
|
echo "Backend: $BACKEND_IP:$PORT ($PROTOCOL)"
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
ssh "$VPS" bash << REMOTESCRIPT
|
||||||
|
set -euo pipefail
|
||||||
|
|
||||||
|
# Generate unique ID using timestamp hash (Netbird format)
|
||||||
|
ID_SUFFIX=\$(date +%s | md5sum | head -c 16)
|
||||||
|
SVC_ID="d9\${ID_SUFFIX}ptsnc73\$(date +%s | md5sum | head -c 10)"
|
||||||
|
TGT_ID=\$(sqlite3 "$DB" "SELECT COALESCE(MAX(id), 100) + 1 FROM targets;")
|
||||||
|
ACCOUNT_ID="d88av3aptsnc73clmogg"
|
||||||
|
ZONE_ID="d8adqjaptsnc73fro5g0"
|
||||||
|
|
||||||
|
echo "Service ID: \$SVC_ID"
|
||||||
|
echo "Target ID: \$TGT_ID"
|
||||||
|
|
||||||
|
# Insert service
|
||||||
|
sqlite3 "$DB" "INSERT INTO services (id, account_id, name, domain, proxy_cluster, enabled, terminated, pass_host_header, rewrite_redirects, mode, source, port_auto_assigned, private) VALUES (\"\$SVC_ID\", \"\$ACCOUNT_ID\", \"$DOMAIN\", \"$DOMAIN\", \"netbird.sysloggh.net\", 1, 0, 1, 0, \"http\", \"permanent\", 0, 0);"
|
||||||
|
echo "Service: OK"
|
||||||
|
|
||||||
|
# Insert target
|
||||||
|
sqlite3 "$DB" "INSERT INTO targets (id, account_id, service_id, host, port, protocol, target_id, target_type, enabled, skip_tls_verify, request_timeout, session_idle_timeout, agent_network, disable_access_log) VALUES (\$TGT_ID, \"\$ACCOUNT_ID\", \"\$SVC_ID\", \"$BACKEND_IP\", $PORT, \"$PROTOCOL\", \"\$ZONE_ID\", \"subnet\", 1, 0, 0, 0, 0, 0);"
|
||||||
|
echo "Target: OK"
|
||||||
|
|
||||||
|
# Verify
|
||||||
|
sqlite3 -column "$DB" "SELECT s.name, t.host, t.port, t.protocol FROM services s JOIN targets t ON s.id=t.service_id WHERE s.name=\"$DOMAIN\";"
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "Restarting proxy stack..."
|
||||||
|
cd /root && docker compose restart netbird-server 2>/dev/null
|
||||||
|
sleep 15
|
||||||
|
docker compose restart proxy 2>/dev/null
|
||||||
|
echo "Done. Verify with: curl -sI https://$DOMAIN"
|
||||||
|
REMOTESCRIPT
|
||||||
@@ -16,7 +16,7 @@ Runs every 15 minutes in the background. Also triggers on session start.
|
|||||||
## Requires
|
## Requires
|
||||||
|
|
||||||
- **Zulip API key** for `abiba-bot@chat.sysloggh.net` in `$ZULIP_API_KEY`
|
- **Zulip API key** for `abiba-bot@chat.sysloggh.net` in `$ZULIP_API_KEY`
|
||||||
- **SSH access** to Tanko (192.168.68.122), Mumuni (192.168.68.123), and Agent Zero Docker host (192.168.68.14)
|
- **SSH access** to Tanko (192.168.68.122), Mumuni (192.168.68.123, lxc/114 on hwepve since 2026-07-20), and Agent Zero Docker host (192.168.68.14)
|
||||||
- **PM2** on localhost for pi process management
|
- **PM2** on localhost for pi process management
|
||||||
- **Network access** to `chat.sysloggh.net`, `localhost:9200`
|
- **Network access** to `chat.sysloggh.net`, `localhost:9200`
|
||||||
- **Write access** to `/root/zulip-health-monitor.log` and `/tmp/zulip-monitor-debounce`
|
- **Write access** to `/root/zulip-health-monitor.log` and `/tmp/zulip-monitor-debounce`
|
||||||
@@ -199,7 +199,7 @@ Check `platforms.zulip.state`: `connected` ✅ | `disconnected` ❌ | `error`
|
|||||||
ssh root@<CT> "ps aux | grep 'gateway run' | grep -v grep"
|
ssh root@<CT> "ps aux | grep 'gateway run' | grep -v grep"
|
||||||
```
|
```
|
||||||
|
|
||||||
Gateway PID should exist with uptime > 60s.
|
Gateway PID should exist with uptime > 60s. **Dual-gateway detection**: if more than one `gateway run` process is found, the gateway has a collision (typically one `--force` and one `--replace` process). Kill the newer/duplicate process, then restart the remaining gateway via PM2 (`pm2 restart mumuni-zulip`). Check gateway log for "Gateway running with 2 platform(s)" (not 1) to confirm Zulip reloaded.
|
||||||
|
|
||||||
**B3: Heartbeat Verification**
|
**B3: Heartbeat Verification**
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user