docs: set 16 GB minimum supported RAM

2026-09-04 09:14:38 +03:00
parent 677f4f4006
commit 4953bb33b2
5 changed files with 35 additions and 3 deletions
@@ -0,0 +1,31 @@
+# Supported systems have at least 16 GB of RAM
+
+**Date:** 2026-09-04
+**Status:** active
+
+## Context
+
+EASY-BEE boots the live image with `toram`. The compressed live medium is
+copied into RAM before the root filesystem is used. During investigation of a
+boot failure, the large squashfs copy was observed to stop part-way through.
+
+The servers in scope are not low-memory systems. The minimum supported
+hardware configuration has 16 GB of installed physical RAM.
+
+## Decision
+
+- EASY-BEE targets and supports systems with at least 16 GB of installed RAM.
+- Capacity below 16 GB is outside the supported hardware envelope.
+- A mid-copy `toram` failure on supported hardware must not be attributed to
+  insufficient total RAM without direct evidence such as `ENOSPC`, an OOM
+  event, or an unexpectedly restricted tmpfs.
+- Diagnostics must preserve the actual copy/read error so media transport,
+  virtual-CD disconnects, and I/O failures can be distinguished from memory
+  exhaustion.
+
+## Consequences
+
+The approximately 2.8 GB live medium has sufficient capacity headroom on
+supported systems. Current v14 boot investigation therefore treats the
+part-way SquashFS copy failure as a source-media or virtual-media read-path
+failure unless boot logs provide explicit evidence of memory exhaustion.
@@ -18,3 +18,4 @@ One file per decision, named `YYYY-MM-DD-short-topic.md`.
 | 2026-08-31 | Support bundle uses private staging and unique atomic output | active |
 | 2026-09-03 | PCIe link verdict comes only from the existing real-traffic GPU bandwidth SAT | active |
 | 2026-09-03 | Runtime Copy to RAM succeeds only after active loop devices move to tmpfs | active |
+| 2026-09-04 | Supported systems have at least 16 GB of RAM | active |