diff mbox series

[v2,3/3] manuals: add minimum RAM requirements

Message ID 20230317173130.36268-4-michael.opdenacker@bootlin.com
State Accepted
Commit a05f87929eed43cef673a8c2581899a8c9ccf462
Headers show
Series Update and expand system requirements | expand

Commit Message

Michael Opdenacker March 17, 2023, 5:31 p.m. UTC 
From: Michael Opdenacker <michael.opdenacker@bootlin.com>

Measured by generating a "core-image-sato" image for a "qemux86-64"
machine from an Ubuntu 22.04 VM with 4 cores.

Less memory was not enough and caused Out of Memory failures.

Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
---
 documentation/brief-yoctoprojectqs/index.rst     | 4 ++++
 documentation/poky.yaml.in                       | 2 ++
 documentation/ref-manual/system-requirements.rst | 8 ++++++++
 3 files changed, 14 insertions(+)
diff mbox series

Patch

diff --git a/documentation/brief-yoctoprojectqs/index.rst b/documentation/brief-yoctoprojectqs/index.rst
index 07e95ee85c..0ccffccc60 100644
--- a/documentation/brief-yoctoprojectqs/index.rst
+++ b/documentation/brief-yoctoprojectqs/index.rst
@@ -44,6 +44,10 @@  following requirements:
    much more will help to run multiple builds and increase
    performance by reusing build artifacts.
 
+-  At least &MIN_RAM; Gbytes of RAM, though a modern modern build host with as
+   much RAM and as many CPU cores as possible is strongly recommended to
+   maximize build performance.
+
 -  Runs a supported Linux distribution (i.e. recent releases of Fedora,
    openSUSE, CentOS, Debian, or Ubuntu). For a list of Linux
    distributions that support the Yocto Project, see the
diff --git a/documentation/poky.yaml.in b/documentation/poky.yaml.in
index eefdd3f30d..dc0c257e50 100644
--- a/documentation/poky.yaml.in
+++ b/documentation/poky.yaml.in
@@ -45,3 +45,5 @@  MIN_MAKE_VERSION : "4.0"
 MIN_DISK_SPACE : "90"
 # Disk space (Gbytes) needed to generate qemux86-64 core-image-sato on Ubuntu 22.04 (x86-64) with "rm_work", rounded up from 38
 MIN_DISK_SPACE_RM_WORK : "40"
+# RAM (Gbytes) needed to generate qemux86-64 core-image-sato on Ubuntu 22.04 (x86-64) on a 4 core system
+MIN_RAM : "8"
diff --git a/documentation/ref-manual/system-requirements.rst b/documentation/ref-manual/system-requirements.rst
index bf50fc510a..4fe0cb841b 100644
--- a/documentation/ref-manual/system-requirements.rst
+++ b/documentation/ref-manual/system-requirements.rst
@@ -42,6 +42,14 @@  to run multiple builds and to cache build artifacts, improving build efficiency.
 If you have a shortage of disk space, see the ":doc:`/dev-manual/disk-space`"
 section of the Development Tasks Manual.
 
+Minimum System RAM
+==================
+
+You will manage to build an image such as ``core-image-sato`` for the
+``qemux86-64`` machine with as little as &MIN_RAM; Gbytes of RAM on an old
+system with 4 CPU cores, but your builds will be much faster on a system with
+as much RAM and as many CPU cores as possible.
+
 Supported Linux Distributions
 =============================