From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 7345128867348086784 X-Received: by 2002:a19:5e19:0:b0:513:2e4c:440a with SMTP id s25-20020a195e19000000b005132e4c440amr3067905lfb.17.1710171086885; Mon, 11 Mar 2024 08:31:26 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a05:6512:b82:b0:513:4766:2710 with SMTP id b2-20020a0565120b8200b0051347662710ls132436lfv.1.-pod-prod-00-eu; Mon, 11 Mar 2024 08:31:25 -0700 (PDT) X-Google-Smtp-Source: AGHT+IHW7q/o6hL85H10YHVWOqEJDtSey3XzTI6ed1hHqEHfIKPovU+W5My75EFDTVbWg+RzdfFY X-Received: by 2002:a19:8c45:0:b0:513:411e:e6d7 with SMTP id i5-20020a198c45000000b00513411ee6d7mr2632952lfj.0.1710171084854; Mon, 11 Mar 2024 08:31:24 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1710171084; cv=none; d=google.com; s=arc-20160816; b=0MYnI5URoeehuupivPMCvGdw5Cgd1um3m7WYVJ00VONcSCx+s+t/aS+tsAwswtXZTQ ApEqwa8U8VFsJJOaq1Zt2CurAxIGZyvIWrtxpcKbWknxAVustlmK55wagwFvdt6VNSAL r6nu4GXJZ/7GIAPo4PpoAbiJtmGTm7/OJiG2cZxW+Y2zvlWf/e9IsXOZkh/d9LgItnB1 9oeDp+4reURzU8s+eiGLVyla+rlB3EVXMsUf8s9jFC3UERbddvx8oMA816FCA4ggB2L7 TRavNeQehcVVmjqm+hHBfoexyZWSBgH7KOOdCdRus/wIyeinAZ2If5GPTTT+JJyaY1zH 8EaQ== 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=+0o9eFfyymva7x17qRbY95gVDKA1CHRLpnKFa01qai8=; fh=/h9QQkzJ8EboVkWg45aWwpaUro6WMavIVd2OhN45RtE=; b=TPKtmXtCHlSezY7gfcEtjioP9IV+poKKoLBstugL1orhYTKAcUpxd7G4LCC0XR4Jb1 /LoPPCbCcg2EZE1hh6fyl2OxjFpPWSkYrC6xQcHcEnzQH9C7KTBubjzzv2TrLyKJuX/b npsSdTZmspBX+P3G3LHCDNQ8TGCPFVZKVR9DLsQzvekcX9nkfBq32ifRppuurhF+gTIy +8gDcn4cpwcvuoOLLf2QVHNE7jX9aVguMrg9OwGnv2uTR1YpvQ6Q9xaL2xHLb40T5ogM 6lDBOW02KN/kPPj+ZA7ka/0j0jgGmtQCOfHp3DL2YgHMG4Ba+6XJ1nslv8Q/nyh7X8NZ sqSQ==; dara=google.com 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 k30-20020a0565123d9e00b00512f8470308si413427lfv.8.2024.03.11.08.31.24 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Mon, 11 Mar 2024 08:31:24 -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 42BFVHar007311 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Mon, 11 Mar 2024 16:31:23 +0100 From: Anton Mikanovich To: isar-users@googlegroups.com Cc: Anton Mikanovich Subject: [PATCH v8 7/8] user_manual.md: Update minimal host requirements Date: Mon, 11 Mar 2024 17:31:10 +0200 Message-Id: <20240311153111.3772144-8-amikan@ilbers.de> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20240311153111.3772144-1-amikan@ilbers.de> References: <20240311153111.3772144-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: lpuNbHv3lcJ7 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 3b658847..84ee55f7 100644 --- a/doc/user_manual.md +++ b/doc/user_manual.md @@ -54,7 +54,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 @@ -66,7 +66,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: ``` @@ -80,6 +80,7 @@ apt install \ gettext-base \ git \ python3 \ + python3-distutils \ quilt \ qemu-user-static \ reprepro \ @@ -93,28 +94,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: @@ -240,9 +232,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 @@ -997,8 +986,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