From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 7291218501940805632 X-Received: by 2002:a2e:9c09:0:b0:2c5:19ab:7270 with SMTP id s9-20020a2e9c09000000b002c519ab7270mr3139665lji.35.1697619101598; Wed, 18 Oct 2023 01:51:41 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a05:651c:486:b0:2c1:261b:7353 with SMTP id s6-20020a05651c048600b002c1261b7353ls1531407ljc.0.-pod-prod-00-eu; Wed, 18 Oct 2023 01:51:39 -0700 (PDT) X-Google-Smtp-Source: AGHT+IH591s8BljWuHlcY8cxvrKlK6QOG1oETq2bufb4XAKP3ccp/hfM3Th/sr05c/sMuYuyR+6k X-Received: by 2002:a05:651c:b29:b0:2c3:eed6:f4f with SMTP id b41-20020a05651c0b2900b002c3eed60f4fmr1722083ljr.5.1697619099647; Wed, 18 Oct 2023 01:51:39 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1697619099; cv=none; d=google.com; s=arc-20160816; b=aoUprARzGExcOxT78l9B4WwiHOpDDRykWL6o+nw+dYy6GOmb937nybyozSFur1D31P sfRG7ILftbxl3bwYMbDaTsAEoh9WBgntDFTSL1KLhP2jKZ1ZpMVGM+ZipH7xg3wMn8MG p/p7b0Jlg6ts5P+WwSQ2PPjbDoS9K3jXQvhIPyXI2bX4RLhAwVXk2hmiF7BF/kQcicqf K1NusMhg6ROZ8o+DSXe0O8v7HvZiFrfubQUUyYI0mhOk1PcapGTLAcnWfg27AS7wf5zz mgkDbay2EOzOtBhgi+85WEGYtzvaWthCJ4JnmD9uExJ1O3fweDb1m2dSTXNlVEycyeSh /5FA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from; bh=yI1OqREYwSwCngNwxZLEfxLedaEp1zrUVGU1x1I90DM=; fh=/h9QQkzJ8EboVkWg45aWwpaUro6WMavIVd2OhN45RtE=; b=Yak0EowMLiv/Zpu7BEv1lYVC9Ya7L01HkWlLe7z2vli62esAydZfmC5eLXbkWWxFRI S6cx8rfiMuVNTNtSlngS3ZlRFh+bzoD8+PmpHxxIpC2/gyXUITjaxzphGzsZkc1YxLA+ kshgeuAlUBeJyjcofh9BZGfb58eK5gZNMnpgnH1m/E2uDQWPyYrDeQJK4/pWAn6DQWcn 66iVxnd1nQn9q6rDW8H2FB4g0PgjrbwmM6N3wJ0YykzmFrmSrMqe6WsPXhaThrO7FEmw cBYp/B+e4K49PfJhUpKfbEapQZCzC3L5V+zNY8NCOf5dVSTB0HGQ5EBr6ULXBAA/9G++ NdNg== ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=pass (google.com: domain of amikan@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=amikan@ilbers.de Return-Path: Received: from shymkent.ilbers.de (shymkent.ilbers.de. [85.214.156.166]) by gmr-mx.google.com with ESMTPS id o21-20020a2e9455000000b002c12145a0cbsi126381ljh.7.2023.10.18.01.51.39 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Wed, 18 Oct 2023 01:51:39 -0700 (PDT) Received-SPF: pass (google.com: domain of amikan@ilbers.de designates 85.214.156.166 as permitted sender) client-ip=85.214.156.166; Authentication-Results: gmr-mx.google.com; spf=pass (google.com: domain of amikan@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=amikan@ilbers.de Received: from user-B660.promwad.corp ([159.148.83.123]) (authenticated bits=0) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8+deb9u1) with ESMTPSA id 39I8pXU6024948 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Wed, 18 Oct 2023 10:51:38 +0200 From: Anton Mikanovich To: isar-users@googlegroups.com Cc: Anton Mikanovich Subject: [PATCH v5 6/7] user_manual.md: Update minimal host requirements Date: Wed, 18 Oct 2023 11:51:24 +0300 Message-Id: <20231018085125.378989-7-amikan@ilbers.de> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20231018085125.378989-1-amikan@ilbers.de> References: <20231018085125.378989-1-amikan@ilbers.de> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-1.0 required=5.0 tests=ALL_TRUSTED autolearn=unavailable autolearn_force=no version=3.4.2 X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on shymkent.ilbers.de X-TUID: p4a+MOFF/XRf Using mmdebstrap requires at least Debian Bullseye on host. Update user manual with the new minimal host distro. Also remove all Buster-related notes. Signed-off-by: Anton Mikanovich --- doc/user_manual.md | 35 ++++++++++++----------------------- 1 file changed, 12 insertions(+), 23 deletions(-) diff --git a/doc/user_manual.md b/doc/user_manual.md index 6cbff8cf..512721c9 100644 --- a/doc/user_manual.md +++ b/doc/user_manual.md @@ -48,7 +48,7 @@ For demonstration purposes, Isar provides support for the following configurations: - QEMU ARM with Debian Buster - - QEMU ARM64 with Debian Buster (for host >= buster) + - QEMU ARM64 with Debian Buster - QEMU i386 with Debian Buster - QEMU amd64 with Debian Buster - Raspberry Pi various models with Raspberry OS Bullseye @@ -60,7 +60,7 @@ The steps below describe how to build the images provided by default. ### Install Host Tools -The supported host system is >= buster. +The minimal supported host system is Debian Bullseye. Install the following packages: ``` @@ -74,6 +74,7 @@ apt install \ gettext-base \ git \ python3 \ + python3-distutils \ quilt \ qemu-user-static \ reprepro \ @@ -87,28 +88,19 @@ apt install \ zstd ``` -If your host is >= buster, also install the following package. -``` -apt install python3-distutils -``` - -**NOTE:** sbuild version (<=0.78.1) packaged in Debian Buster doesn't support -`$apt_keep_downloaded_packages` option which is required in Isar for -populating `${DL_DIR}/deb`. So, host `sbuild` in this case should be manually -upgraded to >=0.81.2 version from Debian Bullseye. - Next, the user who should run Isar needs to be added to `sbuild` group. ``` sudo gpasswd -a sbuild ``` If you want to generate containerized SDKs, also install the following -packages: `umoci` and `skopeo`. -Umoci is provided by Debian Buster and can be installed with -`apt install umoci`, Skopeo is provided by Debian Bullseye/Unstable and has to -be installed either manually downloading the DEB and installing it (no other -packages required) or with `apt install -t bullseye skopeo` (if -unstable/bullseye included in `/etc/apt/sources.list[.d]`). +packages: + +``` +apt install \ + umoci \ + skopeo +``` Notes: @@ -234,9 +226,6 @@ Variables may be used in `.wks.in` files; Isar will expand them and generate a r In order to run the EFI images with `qemu`, an EFI firmware is required and available at the following address: https://github.com/tianocore/edk2/tree/3858b4a1ff09d3243fea8d07bd135478237cb8f7 -Note that the `ovmf` package in Debian Buster contains a pre-compiled firmware, but doesn't seem to be recent -enough to allow images to be testable under `qemu`. - ``` # AMD64 image, EFI qemu-system-x86_64 -m 256M -nographic -bios edk2/Build/OvmfX64/RELEASE_*/FV/OVMF.fd -hda tmp/deploy/images/qemuamd64/isar-image-base-debian-buster-qemuamd64.wic @@ -963,8 +952,8 @@ put into Isar apt. Debian cross-compilation works out of the box. Currently the following build configurations are supported in Isar: - buster armhf - - buster arm64 (for host >= buster) - - buster mipsel (for host >= buster) + - buster arm64 + - buster mipsel - bullseye armhf - bullseye arm64 - bullseye mipsel -- 2.34.1