From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 7291218501940805632 X-Received: by 2002:a05:6512:3c8d:b0:507:b922:f920 with SMTP id h13-20020a0565123c8d00b00507b922f920mr15010130lfv.8.1698836345718; Wed, 01 Nov 2023 03:59:05 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a05:6512:3082:b0:507:979a:7f48 with SMTP id z2-20020a056512308200b00507979a7f48ls1623562lfd.1.-pod-prod-04-eu; Wed, 01 Nov 2023 03:59:03 -0700 (PDT) X-Google-Smtp-Source: AGHT+IFToxEqaaCnpItXmte9iuTKLXut9yBckK0S0HFQuH4G+AIOO6Mo+ksMYCRiRNgtT/mfVO3s X-Received: by 2002:a19:ca5b:0:b0:507:9ff3:ae82 with SMTP id h27-20020a19ca5b000000b005079ff3ae82mr10752028lfj.18.1698836343492; Wed, 01 Nov 2023 03:59:03 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1698836343; cv=none; d=google.com; s=arc-20160816; b=Jx2pQcPTA7AJ7mfOLp7HKDdwlEKrx55C4sQC4h+3Sr9rQWcfhXIEgRpLsIPslCcXx4 E4b2fOPeQYtes2XFPE410SWxW24cVPLUOIa1cUNFSRrFKaaEpKQdbMlhzJJbA4UOwdJM 1a4TP2ImJLmc5qSH3uwO/0Iq9B4DL5PBcRL62368N69aDHxQSMdPyfUG9DYp3qyhY59I wHWDvSpw+ruz2H1pWdN0R7QYauGURpXL4AvF+qTP0Hq757RAKW8zMyKUEM7K6zXdYhmU 556jUrYq82Ugn1yf6R3OaCBgXblLWtm48DF/3KRSe9A4Fy+lKtZwl6Ao6uCVm86lNVNy x7pQ== 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=GcDuevgeyIHx5mqd5u2F+CbjMiEkQWoCv64KgCsSaiQ8ovp50klwcly6t7pOOn+Yd5 OMxXg7QBJkQEQqnD4eeff38XZiDTNpRkwEoJHcTMFmDbXXI1QDaCcPdgtdFUUNs7bfK3 QnTZHanEAe7pyr4sop1Jprz1Rz0YseXlbSWKxwKhKqhjB7+un3TJhuiV1MhvVLcRqDPn 0uYF67OeVN6nB91k/hl25JiDAyswzInleedoDqxj4pon7vEPcwA0HOI45xqpWXGymZcc EkwU7NXtr7PwyuSvHqeH9iTagvsGqMj/OG3sCOPzomw50GPiHl+pTMSqLwAS0p2blwSg B/qg== 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 b15-20020a056512304f00b0050821a4a26csi74640lfb.7.2023.11.01.03.59.03 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Wed, 01 Nov 2023 03:59:03 -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 3A1Aw4cB010660 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Wed, 1 Nov 2023 11:58:55 +0100 From: Anton Mikanovich To: isar-users@googlegroups.com Cc: Anton Mikanovich Subject: [PATCH v7 7/8] user_manual.md: Update minimal host requirements Date: Wed, 1 Nov 2023 12:57:56 +0200 Message-Id: <20231101105757.1988498-8-amikan@ilbers.de> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20231101105757.1988498-1-amikan@ilbers.de> References: <20231101105757.1988498-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: +n3JOAHr76Oz 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