From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 7231094895937585152 X-Received: by 2002:a81:4517:0:b0:561:244d:c40 with SMTP id s23-20020a814517000000b00561244d0c40mr2891854ywa.5.1685527988245; Wed, 31 May 2023 03:13:08 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a25:a00a:0:b0:bb1:3ed1:4f57 with SMTP id x10-20020a25a00a000000b00bb13ed14f57ls1744ybh.1.-pod-prod-01-us; Wed, 31 May 2023 03:13:07 -0700 (PDT) X-Google-Smtp-Source: ACHHUZ7v5D+HMrs0OjJFtQUtLIrx22IloI0j0297fZWGoPsCPgPpMtC1/jE+McCS7Fwu1xXPcZfY X-Received: by 2002:a67:f59a:0:b0:436:c33:a96e with SMTP id i26-20020a67f59a000000b004360c33a96emr1726952vso.24.1685527878407; Wed, 31 May 2023 03:11:18 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1685527878; cv=none; d=google.com; s=arc-20160816; b=KqzWxCOoro/I0s0ajluUrZ7NAra3hHXduV21aLK1oODs304RgMgt77nCdVQK6CXoqy uw13QpkIf+7rimBz3HHWMslyOzFo+T87kBioLum/IKiaYjTeSKxrPnTmBgFb6KojPRUL pabUSFfsIkHnrXR4r83lby01ArXxTjBrmFazSbivstoTi0lEzXnqfxjiwOffFgxlqbbo AQOAs4xkRz5aN5hDdipOqpwtTYsyfQCA+NDPo2jUHvbbCZ+Y+PXxJUouNEua3mkkCX8m L6iskxtIJWqmqu2PcUX/S/pYKSkcQ3HXVzXlLYTjMtjJq4cgt4Hcz2PxPb9gU/0svQXR F2Rg== 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=NI8G9oaYdPRlacBO90ZMDZ8nbNw9hJcJoJu2C5GUVKQ=; b=GYeKSGWODd1nKHPt6YAHNUI2s3hQVXW4t/2nU+oqOFcUz1knUbMi371UFskItQ1SSB CpOAtfeOgCRhCRY85KDbSxWiuETJ0/Fxdk6O70uikJQh+NZyMEMmIoEx7fhBMesvhmSj oxUEuONoyu1BPobenQ/BgPRkA/3MuLf9o/eg5rOu7rvv3OhUzhuK6VdMBvo+XVDsdHqm VxYoe7d3bO5fGX0ev6C7/IN8NswHGMGXVvh28blFQWjmqt7DsOwNjavMvzFAoUUvhKaj A2HdxqXU3U5l3F+8R0sjOezbnXCdkAlHaZsN4/0G5hu4c3/cIS4qvujOvql0LxHgxG6P IZ9g== 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 dh14-20020a056102578e00b0043970219abfsi1731573vsb.0.2023.05.31.03.11.17 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Wed, 31 May 2023 03:11:18 -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.. (IN-213-226-141-203.bitemobile.lv [213.226.141.203] (may be forged)) (authenticated bits=0) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8+deb9u1) with ESMTPSA id 34VAB5C2026535 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Wed, 31 May 2023 12:11:12 +0200 From: Anton Mikanovich To: isar-users@googlegroups.com Cc: Anton Mikanovich Subject: [PATCH v3 5/7] user_manual.md: Update minimal host requirements Date: Wed, 31 May 2023 13:11:00 +0300 Message-Id: <20230531101102.101755-6-amikan@ilbers.de> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20230531101102.101755-1-amikan@ilbers.de> References: <20230531101102.101755-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: Sn8jDF/BFDol 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 cdf50e35..ed768ba7 100644 --- a/doc/user_manual.md +++ b/doc/user_manual.md @@ -46,7 +46,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 @@ -58,7 +58,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: ``` @@ -75,6 +75,7 @@ apt install \ mtools \ parted \ python3 \ + python3-distutils \ quilt \ qemu-user-static \ reprepro \ @@ -88,28 +89,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: @@ -235,9 +227,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 @@ -955,8 +944,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