NetBSD Problem Report #56953

From martin@aprisoft.de  Thu Aug  4 18:25:43 2022
Return-Path: <martin@aprisoft.de>
Received: from mail.netbsd.org (mail.netbsd.org [199.233.217.200])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))
	(Client CN "mail.NetBSD.org", Issuer "mail.NetBSD.org CA" (not verified))
	by mollari.NetBSD.org (Postfix) with ESMTPS id 36E841A921F
	for <gnats-bugs@gnats.NetBSD.org>; Thu,  4 Aug 2022 18:25:43 +0000 (UTC)
Message-Id: <20220804182534.2587C5CC975@emmas.aprisoft.de>
Date: Thu,  4 Aug 2022 20:25:34 +0200 (CEST)
From: martin@NetBSD.org
Reply-To: martin@NetBSD.org
To: gnats-bugs@NetBSD.org
Subject: install notes are slightly outdated
X-Send-Pr-Version: 3.95

>Number:         56953
>Category:       install
>Synopsis:       install notes are slightly outdated
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    install-manager
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Thu Aug 04 18:30:00 +0000 2022
>Last-Modified:  Thu Aug 04 18:35:01 +0000 2022
>Originator:     Martin Husemann
>Release:        NetBSD 9.99.99
>Organization:
The NetBSD Foundation, Inc.
>Environment:
System: NetBSD martins.aprisoft.de 9.99.99 NetBSD 9.99.99 (GENERIC) #142: Sat Jul 30 14:28:52 CEST 2022 martin@martins.aprisoft.de:/usr/src/sys/arch/amd64/compile/GENERIC amd64
Architecture: x86_64
Machine: amd64
>Description:

The installation notes, especially distrib/notes/common/sysinst, are
slightly wrong/outdated.

Unfortunately they are a twisty maze of machine dependend .if and need
very carefull editing and proofreading.

>How-To-Repeat:
Read the INSTALL.html of a daily HEAD build, e.g.
https://nycdn.NetBSD.org/pub/NetBSD-daily/HEAD/latest/amd64/INSTALL.html

Note that:
 - it lists "Selecting which sets to install" very early, while it only
   actually happens after partitioning and file system creation (in
   the current numbering: between step 11 and 12)
 - in step 9 "Partitioning the disk" and 10 "Editing the NetBSD disklabel"
   it does not mention GPT options (side note: it also only explains MBR/fdisk
   for i386, but not amd64)
   Probably both of these sections should be rewritten from scratch,
   mentioning that available partitioning schemes will vary by
   architecture and sometimes even by install medium selected (due to
   space constraints). Most of the .if spagethi can probably removed
   and a general one (GPT or disklabel, depending on machine and boot
   details) or two level (outer [MBR] and inner [disklabel]) scheme
   explained.

>Fix:
yes, *roff wizards and well trained english writers: please do :-}

>Audit-Trail:
From: Martin Husemann <martin@duskware.de>
To: gnats-bugs@netbsd.org
Cc: 
Subject: Re: install/56953: install notes are slightly outdated
Date: Thu, 4 Aug 2022 20:33:00 +0200

 It also misses (after current point 18 "Extracting the distribution set"
 and point 19 "Configure additional items") one new mandatory
 item: "Setup the root password" and on some machines (where no TRNG
 is available) an optional step to seed the initial entropy.

 Martin

Home	PR Database Search