Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 6 Aug 2023 08:05:10 -0700
From:      Kevin Oberman <rkoberman@gmail.com>
To:        Matthias Apitz <guru@unixarea.de>, freebsd-current@freebsd.org
Subject:   Re: Has the update procedure changed?
Message-ID:  <CAN6yY1tiq4XQT_apnLo_aDgoMPEZ%2BZ4PfB8uqfMw3PeJbMGMqw@mail.gmail.com>
In-Reply-To: <ZM80rBrlSf8NVNr5@c720-r368166>
References:  <ZM80rBrlSf8NVNr5@c720-r368166>

next in thread | previous in thread | raw e-mail | index | archive | help
--000000000000c0002506024275c9
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

On Sat, Aug 5, 2023 at 10:51=E2=80=AFPM Matthias Apitz <guru@unixarea.de> w=
rote:

> In the past I was used to use the following procedure to install a new
> kernel and world:
>
>     # cd /usr/src
>     # make installkernel
>     # shutdown -r now
>
>     boot -s from the loader prompt
>
>     # adjkerntz -i
>     # mount -a -t ufs
>     # mergemaster -p
>     # cd /usr/src
>     # make installworld
>     # mergemaster
>     # yes | make delete-old
>     # yes | make delete-old-libs
>
>     # reboot
>
> Now the handbook
> https://docs.freebsd.org/en/books/handbook/cutting-edge/#makeworld
> says only:
>
>     # cd /usr/src
>     # make installkernel
>     # shutdown -r now
>     # cd /usr/src
>     # make installworld
>     # shutdown -r now
>
> Has this changed in past two years?
>
> Thanks
>
>         matthias
> --
> Matthias Apitz, =E2=9C=89 guru@unixarea.de, http://www.unixarea.de/
> +49-176-38902045
> Public GnuPG key: http://www.unixarea.de/key.pub
>

Wow! Several obvious reasons that this looks just wrong. (Then again, so is
yours in one case.)
1. "mergemaster -p" MUST be run before you build the kernel. (Actually, hte
man page says it should be run BEFORE buildworld and that is what I've
always done although I have never seen a case where it was needed until
buildkernel.
2. While mergemaster(8) is still in the system, you really should be using
etcupdate(8). You also need to understand how a three-way merge is done and
that you  often need to edit the merged file when first running it.  It's
pretty simple to run and rarely is needed after the first run, but it is
critical to do this for /etc files that you have modified. It's generally
just picking which of the two (original/yours) you want in the final file.
The big win with etcupdate(8) is that it only needs to be run once for
modified files in almost all cases.
3. Where is "make check-old" and the other tests to get rid of old files.
Leaving these around can lead to serious issues.
4. If you don't do adjkerntz -i, you might find files installed in the
future which can get REALLY  confusing!

Historically, the final source of truth for all of this is
/usr/src/UPDATING. It has been updated for etcupdate(8) and is handled by
imp@, so I tend to believe it is correct.

OK. Everyone who knows better, please explain why. I didn't mention "fsck
-p" but I'm really paranoid and it really, really should not be needed
unless something goes wrong in the shutdown after installing the new kernel=
.
--=20
Kevin Oberman, Part time kid herder and retired Network Engineer
E-mail: rkoberman@gmail.com
PGP Fingerprint: D03FB98AFA78E3B78C1694B318AB39EF1B055683

--000000000000c0002506024275c9
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr"><div dir=3D"ltr"><div class=3D"gmail_default" style=3D"fon=
t-family:tahoma,sans-serif;font-size:small">On Sat, Aug 5, 2023 at 10:51=E2=
=80=AFPM Matthias Apitz &lt;<a href=3D"mailto:guru@unixarea.de">guru@unixar=
ea.de</a>&gt; wrote:</div></div><div class=3D"gmail_quote"><blockquote clas=
s=3D"gmail_quote" style=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid r=
gb(204,204,204);padding-left:1ex">In the past I was used to use the followi=
ng procedure to install a new<br>
kernel and world:<br>
<br>
=C2=A0 =C2=A0 # cd /usr/src<br>
=C2=A0 =C2=A0 # make installkernel<br>
=C2=A0 =C2=A0 # shutdown -r now<br>
<br>
=C2=A0 =C2=A0 boot -s from the loader prompt<br>
<br>
=C2=A0 =C2=A0 # adjkerntz -i<br>
=C2=A0 =C2=A0 # mount -a -t ufs<br>
=C2=A0 =C2=A0 # mergemaster -p<br>
=C2=A0 =C2=A0 # cd /usr/src<br>
=C2=A0 =C2=A0 # make installworld<br>
=C2=A0 =C2=A0 # mergemaster<br>
=C2=A0 =C2=A0 # yes | make delete-old<br>
=C2=A0 =C2=A0 # yes | make delete-old-libs<br>
<br>
=C2=A0 =C2=A0 # reboot<br>
<br>
Now the handbook <a href=3D"https://docs.freebsd.org/en/books/handbook/cutt=
ing-edge/#makeworld" rel=3D"noreferrer" target=3D"_blank">https://docs.free=
bsd.org/en/books/handbook/cutting-edge/#makeworld</a><br>
says only:<br>
<br>
=C2=A0 =C2=A0 # cd /usr/src<br>
=C2=A0 =C2=A0 # make installkernel<br>
=C2=A0 =C2=A0 # shutdown -r now<br>
=C2=A0 =C2=A0 # cd /usr/src<br>
=C2=A0 =C2=A0 # make installworld<br>
=C2=A0 =C2=A0 # shutdown -r now<br>
<br>
Has this changed in past two years?<br>
<br>
Thanks<br>
<br>
=C2=A0 =C2=A0 =C2=A0 =C2=A0 matthias<br>
-- <br>
Matthias Apitz, =E2=9C=89 <a href=3D"mailto:guru@unixarea.de" target=3D"_bl=
ank">guru@unixarea.de</a>, <a href=3D"http://www.unixarea.de/" rel=3D"noref=
errer" target=3D"_blank">http://www.unixarea.de/</a>; +49-176-38902045<br>
Public GnuPG key: <a href=3D"http://www.unixarea.de/key.pub" rel=3D"norefer=
rer" target=3D"_blank">http://www.unixarea.de/key.pub</a><br></blockquote><=
div>=C2=A0</div></div><div style=3D"font-family:tahoma,sans-serif;font-size=
:small" class=3D"gmail_default">Wow! Several obvious reasons that this look=
s just wrong. (Then again, so is yours in one case.)</div><div style=3D"fon=
t-family:tahoma,sans-serif;font-size:small" class=3D"gmail_default">1. &quo=
t;mergemaster -p&quot; MUST be run before you build the kernel. (Actually, =
hte man page says it should be run BEFORE buildworld and that is what I&#39=
;ve always done although I have never seen a case where it was needed until=
 buildkernel.</div><div style=3D"font-family:tahoma,sans-serif;font-size:sm=
all" class=3D"gmail_default">2. While mergemaster(8) is still in the system=
, you really should be using etcupdate(8). You also need to understand how =
a three-way merge is done and that you=C2=A0 often need to edit the merged =
file when first running it.=C2=A0 It&#39;s pretty simple to run and rarely =
is needed after the first run, but it is critical to do this for /etc files=
 that you have modified. It&#39;s generally just picking which of the two (=
original/yours) you want in the final file. The big win with etcupdate(8) i=
s that it only needs to be run once for modified files in almost all cases.=
</div><div style=3D"font-family:tahoma,sans-serif;font-size:small" class=3D=
"gmail_default">3. Where is &quot;make check-old&quot; and the other tests =
to get rid of old files. Leaving these around can lead to serious issues.</=
div><div style=3D"font-family:tahoma,sans-serif;font-size:small" class=3D"g=
mail_default">4. If you don&#39;t do adjkerntz -i, you might find files ins=
talled in the future which can get REALLY=C2=A0 confusing! <br></div><div s=
tyle=3D"font-family:tahoma,sans-serif;font-size:small" class=3D"gmail_defau=
lt"><br></div><div style=3D"font-family:tahoma,sans-serif;font-size:small" =
class=3D"gmail_default">Historically, the final source of truth for all of =
this is /usr/src/UPDATING. It has been updated for etcupdate(8) and is hand=
led by imp@, so I tend to believe it is correct.</div><div style=3D"font-fa=
mily:tahoma,sans-serif;font-size:small" class=3D"gmail_default"><br></div><=
div style=3D"font-family:tahoma,sans-serif;font-size:small" class=3D"gmail_=
default">OK. Everyone who knows better, please explain why. I didn&#39;t me=
ntion &quot;fsck -p&quot; but I&#39;m really paranoid and it really, really=
 should not be needed unless something goes wrong in the shutdown after ins=
talling the new kernel.<br></div><span class=3D"gmail_signature_prefix">-- =
</span><br><div dir=3D"ltr" class=3D"gmail_signature"><div dir=3D"ltr"><div=
><div dir=3D"ltr"><div><div dir=3D"ltr"><div><div dir=3D"ltr">Kevin Oberman=
, Part time kid herder and retired Network Engineer<br>E-mail: <a href=3D"m=
ailto:rkoberman@gmail.com" target=3D"_blank">rkoberman@gmail.com</a><br></d=
iv><div>PGP Fingerprint: D03FB98AFA78E3B78C1694B318AB39EF1B055683</div></di=
v></div></div></div></div></div></div></div>

--000000000000c0002506024275c9--



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAN6yY1tiq4XQT_apnLo_aDgoMPEZ%2BZ4PfB8uqfMw3PeJbMGMqw>