manuals: add minimum RAM requirements

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.

(From yocto-docs rev: 5009d3898a1649074d1fc252ed33ecbf3235ed75)

Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Signed-off-by: Steve Sakoman <steve@sakoman.com>
This commit is contained in:
Michael Opdenacker
2023-03-17 09:59:20 +01:00
committed by Steve Sakoman
parent 64778b45ca
commit 7b6b03a1eb
3 changed files with 18 additions and 0 deletions

View File

@@ -51,6 +51,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

View File

@@ -48,3 +48,7 @@ MIN_GCC_VERSION : "7.5"
MIN_MAKE_VERSION : "4.0"
# Disk space (Gbytes) needed to generate qemux86-64 core-image-sato on Ubuntu 22.04 (x86-64), rounded up from 87
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"

View File

@@ -40,6 +40,16 @@ 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.
.. _system-requirements-minimum-ram:
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.
.. _detailed-supported-distros:
Supported Linux Distributions