Files
ultix/README.md
T
mrcharles 46fe0cb6a5 Rebuild runbook + state capture + docs sync to current reality (#615)
REBUILD.md maps a full rebuild (PVE qm spec incl. nested-virt flag,
guest OS/accounts/dotfiles bootstrap, script order, package baseline,
verification checklist). 14-capture-state.sh regenerates docs/state
snapshots (guest apt/units/sysctl/fstab/docker + PVE 5111 config).
Docs sync: stale multiqueue-owed text removed from NEXT/REPORT/RUNBOOK;
README script list + open-work list current.

Details: https://projects.knownelement.com/issues/615
2026-09-01 13:31:38 -05:00

39 lines
2.2 KiB
Markdown

# ultix
Perf/ops workbench for **ultix-streaming** (KVM VM 5111 on Proxmox host
pfv-tsys5). Everything here is human-run, gated, and reversible; storage ops
are manual-only by ruling.
- Redmine: project 55 "Known Element Enterprises - Technology & Facility
Services" — open work: #601 (hardware window ~Oct 2026; presume
8 vCPU/48G until then), #603 root growth, #604 metrics/PSI wiring,
#605 k8s + proxmox token (blocked by #601), #606 GPU passthrough,
#607 account map/mkacct, #608 compose cgroup_parent wiring (gateway
starvation fix on 8 vCPU), #609 Fri 09-04 troubleshooting-only outage;
#611 RDP big-monitor fix (live, human UAT pending), #612 dotfiles v2 +
Kali addendum (human UAT pending), #615 microvm + rebuild capture,
#616 macOS VM (blocked by #601); pass record: #602.
https://projects.knownelement.com/projects/55
- Discourse doc: pending (house cross-link rule: create at next doc pass).
- Docs live in-repo (runbook exception per house rules):
- REPORT.md — full optimization report + host audit results (section 8)
- NEXT.md — current state / what is owed (usually: nothing)
- TRACKING.md — rolling HUD table + decisions log
- GROW-ROOT-RUNBOOK.md — manual root-growth checklist (#603)
- REBUILD.md — full-rebuild runbook, guest + PVE sides (#615);
docs/state/ holds regenerable state snapshots (14-capture-state.sh)
- RUNBOOK-TODAY.md, questions-v1.md
- Scripts (human-run unless noted): 1-guest-prep.sh, 2-host-one-shot.sh,
3-post-reboot-fixes.sh, 4-host-netcheck.sh (crush may run via ssh),
5-activate-multiqueue.sh (historical — multiqueue live 2026-09-01),
6-remove-agent-stacks.sh (boot-time screen/crush relauncher teardown;
backups in removed-agent-stacks/), 7-open-terminal-install.sh +
8-open-terminal-users.sh (Open Terminal fleet, #610), 9-uat-openwebui.sh
(OpenWebUI<->terminal UAT harness; uat/ holds its compose),
12-fix-rdp-bigres.sh (xrdp EGFX frame budget, #611),
13-microvm-setup.sh + microvm/ (microVM tooling, #615),
14-capture-state.sh (refresh docs/state). staged/ holds the gated configs.
- OPEN-TERMINAL.md — ops note for the terminal fleet: ports, keys location,
production OpenWebUI wiring, UAT record.
- crush.md = session preferences for agents working in this repo.