[Bug 270338] FreeBSD Handbook: minor and major upgrades with freebsd-update(8): corrections and improvements

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=270338

--- Comment #15 from Graham Perrin  ---
(In reply to Graham Perrin from comment #9)

To avoid discussion in Bugzilla …

… for users of FreeBSD Discord, I created a thread for this bug 270338 in the
#documentation channel: 



Please note, this is not to discourage discussion in areas that are more open,
e.g. . It's a convenience, for users of the
service.

-- 
You are receiving this mail because:
You are the assignee for the bug.

[Bug 270338] FreeBSD Handbook: minor and major upgrades with freebsd-update(8): corrections and improvements

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=270338

--- Comment #14 from Graham Perrin  ---
Re: comment #12

This can not be true: 

> … there may only be two install phases …

If you restart the OS after the first two runs of 
freebsd-update install
then you'll probably find a kernel-userland mismatch in response to 
freebsd-version -kru

-- 
You are receiving this mail because:
You are the assignee for the bug.

[Bug 270338] FreeBSD Handbook: minor and major upgrades with freebsd-update(8): corrections and improvements

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=270338

--- Comment #13 from Graham Perrin  ---

condensed

pkg-static upgrade -f
freebsd-update install
portmaster -af
"Reboot the machine into the new FreeBSD version."

-- 
You are receiving this mail because:
You are the assignee for the bug.

[Bug 270338] FreeBSD Handbook: minor and major upgrades with freebsd-update(8): corrections and improvements

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=270338

--- Comment #12 from Graham Perrin  ---

condensed

freebsd-update fetch
freebsd-update install
freebsd-update -r 13.2-RELEASE upgrade
freebsd-update install
shutdown -r now
freebsd-update install
"Depending upon whether any library version numbers were bumped, there may only
be two install phases instead of three."
"The upgrade is now complete. If this was a major version upgrade, reinstall
all ports and packages as described in Upgrading Packages After a Major Version
Upgrade."

-- 
You are receiving this mail because:
You are the assignee for the bug.

[Bug 270338] FreeBSD Handbook: minor and major upgrades with freebsd-update(8): corrections and improvements

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=270338

--- Comment #11 from Graham Perrin  ---

condensed

freebsd-update fetch
freebsd-update install

-- 
You are receiving this mail because:
You are the assignee for the bug.

[Bug 270338] FreeBSD Handbook: minor and major upgrades with freebsd-update(8): corrections and improvements

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=270338

--- Comment #10 from Graham Perrin  ---
 condensed

freebsd-update fetch
freebsd-update install
freebsd-update upgrade -r 13.3-RELEASE
freebsd-update install
shutdown -r now
freebsd-update install
pkg (or whatever) for ports
"only if freebsd-update(8) printed a message indicating that this was
necessary"
freebsd-update install
shutdown -r now

-- 
You are receiving this mail because:
You are the assignee for the bug.

[Bug 270338] FreeBSD Handbook: minor and major upgrades with freebsd-update(8): corrections and improvements

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=270338

--- Comment #9 from Graham Perrin  ---
(In reply to Ed Maste from comment #8)

Sorry for the slow response, I'm rarely in Bugzilla nowadays. There remain
inconsistencies, and a probable need to rethink at least one thing in the
context of pkgbase. 

Partly to simplify comparison, I'll add: 

- one comment with information condensed from www.freebsd.org/releases

- three comments with information condensed from docs.freebsd.org …

-- 
You are receiving this mail because:
You are the assignee for the bug.

[Bug 270338] FreeBSD Handbook: minor and major upgrades with freebsd-update(8): corrections and improvements

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=270338

Ed Maste  changed:

   What|Removed |Added

 CC||ema...@freebsd.org

--- Comment #8 from Ed Maste  ---
I requests in some comments followed later by "Sorry, ignore that.", and a link
to a Phabricator code review that is resolved.

Are there outstanding issues or uncommitted changes in this PR, or should it be
resolved now?

-- 
You are receiving this mail because:
You are the assignee for the bug.

[Bug 270338] FreeBSD Handbook: minor and major upgrades with freebsd-update(8): corrections and improvements

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=270338

Graham Perrin  changed:

   What|Removed |Added

  Flags|maintainer-feedback?(re@Fre |
   |eBSD.org)   |

--- Comment #7 from Graham Perrin  ---
(In reply to Graham Perrin from comment #6)

> @re please: 

Sorry, ignore that. 

Yesterday afternoon, I remembered the keyword that appears, somewhere, with
regard to major upgrades that omit prior minor updates: 

untested.

Moreover, bug 264142 comment 0:

> Required per email discussion with gjb@ if not running the 
> latest -p of the version upgrading from.

(Comment 6 here is a duplicate of already linked bug 264142.)

-- 
You are receiving this mail because:
You are the assignee for the bug.

[Bug 270338] FreeBSD Handbook: minor and major upgrades with freebsd-update(8): corrections and improvements

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=270338

Graham Perrin  changed:

   What|Removed |Added

   Keywords||needs-qa

-- 
You are receiving this mail because:
You are the assignee for the bug.

[Bug 270338] FreeBSD Handbook: minor and major upgrades with freebsd-update(8): corrections and improvements

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=270338

Graham Perrin  changed:

   What|Removed |Added

  Flags||maintainer-feedback?(re@Fre
   ||eBSD.org)
 CC||r...@freebsd.org

--- Comment #6 from Graham Perrin  ---
>From bug 213935 comment 1: 

> I think you should not skip intermediate versions. ⋯

As far as I know: this (advice to not skip) is often recommended, but not
officially made explicit. 

It is, I think, implicit in release-specific installation instructions. For
example, from instructions at  for
13.2-RELEASE: 

> ⋯ freebsd-update(8) ⋯ 12.4-RELEASE or 13.1-RELEASE can upgrade ⋯


@re please: should there be clearer advice, in the FreeBSD Handbook, to
complete minor update routines before attempting a major upgrade? 

Currently, under
: 

> ⋯ The following command, when run on a FreeBSD 13.1 system, will 
> upgrade it to FreeBSD 13.2:
> 
> # freebsd-update -r 13.2-RELEASE upgrade
> 
> ⋯


(If, say, an operator has a non-patched 13.0 system: there's no hint to patch
before attempting an upgrade.)

-- 
You are receiving this mail because:
You are the assignee for the bug.

[Bug 270338] FreeBSD Handbook: minor and major upgrades with freebsd-update(8): corrections and improvements

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=270338

Graham Perrin  changed:

   What|Removed |Added

   See Also||https://bugs.freebsd.org/bu
   ||gzilla/show_bug.cgi?id=2139
   ||35

-- 
You are receiving this mail because:
You are the assignee for the bug.

[Bug 270338] FreeBSD Handbook: minor and major upgrades with freebsd-update(8): corrections and improvements

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=270338

Graham Perrin  changed:

   What|Removed |Added

 Status|In Progress |Open
   Assignee|grahamper...@freebsd.org|d...@freebsd.org
 CC|d...@freebsd.org |

-- 
You are receiving this mail because:
You are the assignee for the bug.
You are on the CC list for the bug.

[Bug 270338] FreeBSD Handbook: minor and major upgrades with freebsd-update(8): corrections and improvements

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=270338

Graham Perrin  changed:

   What|Removed |Added

   See Also||https://bugs.freebsd.org/bu
   ||gzilla/show_bug.cgi?id=2708
   ||33

-- 
You are receiving this mail because:
You are on the CC list for the bug.

[Bug 270338] FreeBSD Handbook: minor and major upgrades with freebsd-update(8): corrections and improvements

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=270338

Graham Perrin  changed:

   What|Removed |Added

   See Also||https://bugs.freebsd.org/bu
   ||gzilla/show_bug.cgi?id=2708
   ||52

-- 
You are receiving this mail because:
You are on the CC list for the bug.

[Bug 270338] FreeBSD Handbook: minor and major upgrades with freebsd-update(8): corrections and improvements

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=270338

Graham Perrin  changed:

   What|Removed |Added

   See Also||https://bugs.freebsd.org/bu
   ||gzilla/show_bug.cgi?id=2708
   ||45

-- 
You are receiving this mail because:
You are on the CC list for the bug.

[Bug 270338] FreeBSD Handbook: minor and major upgrades with freebsd-update(8): corrections and improvements

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=270338

--- Comment #5 from Graham Perrin  ---


> [Handbook]: Clarify kernel modules on upgrades



> handbook/cutting-edge/: trailing white space

-- 
You are receiving this mail because:
You are on the CC list for the bug.

[Bug 270338] FreeBSD Handbook: minor and major upgrades with freebsd-update(8): corrections and improvements

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=270338

Graham Perrin  changed:

   What|Removed |Added

   See Also||https://bugs.freebsd.org/bu
   ||gzilla/show_bug.cgi?id=2049
   ||14

-- 
You are receiving this mail because:
You are on the CC list for the bug.

[Bug 270338] FreeBSD Handbook: minor and major upgrades with freebsd-update(8): corrections and improvements

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=270338

Graham Perrin  changed:

   What|Removed |Added

 Status|Open|In Progress
   See Also||https://reviews.freebsd.org
   ||/D39474

--- Comment #4 from Graham Perrin  ---
>From D39474: 

> Given the imminent announcement of 13.2-RELEASE, I'll appreciate 
> approval or comments at the earliest opportunity.

Thanks

-- 
You are receiving this mail because:
You are on the CC list for the bug.

[Bug 270338] FreeBSD Handbook: minor and major upgrades with freebsd-update(8): corrections and improvements

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=270338

Graham Perrin  changed:

   What|Removed |Added

   See Also||https://github.com/freebsd/
   ||freebsd-doc/pull/164

-- 
You are receiving this mail because:
You are on the CC list for the bug.

[Bug 270338] FreeBSD Handbook: minor and major upgrades with freebsd-update(8): corrections and improvements

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=270338

Graham Perrin  changed:

   What|Removed |Added

   See Also||https://bugs.freebsd.org/bu
   ||gzilla/show_bug.cgi?id=2135
   ||64

-- 
You are receiving this mail because:
You are on the CC list for the bug.

[Bug 270338] FreeBSD Handbook: minor and major upgrades with freebsd-update(8): corrections and improvements

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=270338

Graham Perrin  changed:

   What|Removed |Added

   See Also||https://bugs.freebsd.org/bu
   ||gzilla/show_bug.cgi?id=2641
   ||42

-- 
You are receiving this mail because:
You are on the CC list for the bug.

[Bug 270338] FreeBSD Handbook: minor and major upgrades with freebsd-update(8): corrections and improvements

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=270338

Graham Perrin  changed:

   What|Removed |Added

   Assignee|d...@freebsd.org |grahamper...@freebsd.org
   Keywords|needs-qa|
  Flags|maintainer-feedback?(cperci |
   |v...@freebsd.org) |
 CC|cperc...@freebsd.org|d...@freebsd.org
   See Also||https://bugs.freebsd.org/bu
   ||gzilla/show_bug.cgi?id=2659
   ||56

-- 
You are receiving this mail because:
You are the assignee for the bug.
You are on the CC list for the bug.

[Bug 270338] FreeBSD Handbook: minor and major upgrades with freebsd-update(8): corrections and improvements

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=270338

--- Comment #3 from Graham Perrin  ---
Created attachment 240990
  --> https://bugs.freebsd.org/bugzilla/attachment.cgi?id=240990&action=edit
Screenshot: two windows, FreeBSD Handbook to the right, some Diigo annotations

Briefly


Given the advice in the window to the left (yesterday's email), visualise this
scenario: 

a) kernel and world already upgraded from 12.4-RELEASE to
   13.2-RC3

b) a recommended rebuild and install of all applications

c) shutdown -r now

d) freebsd-update installto remove stale files

– I see no problem with this.





Given the advice to the right (the Handbook) and the same scenario: 

a) kernel and world already upgraded from 12.4-RELEASE to
   13.2-RC3

b) pkg-static upgrade -f using an infrastructure that does 
 not yet have any 13.2⋯-based jail 
 for build purposes

c) freebsd-update installto tie up loose ends

d) rebootto the same version of the OS
 (not a new version).

-- 
You are receiving this mail because:
You are the assignee for the bug.

[Bug 270338] FreeBSD Handbook: minor and major upgrades with freebsd-update(8): corrections and improvements

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=270338

--- Comment #2 from Graham Perrin  ---
(In reply to Graham Perrin from comment #0)

> … seems to not describe the possibility of a third run in the case of 
> a major upgrade.

Maybe ignore that. I think, it's the sequences (the order) confusing me.

-- 
You are receiving this mail because:
You are the assignee for the bug.

[Bug 270338] FreeBSD Handbook: minor and major upgrades with freebsd-update(8): corrections and improvements

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=270338

Graham Perrin  changed:

   What|Removed |Added

 CC||cperc...@freebsd.org
   Keywords||needs-patch, needs-qa
 Status|New |Open
URL||https://docs.freebsd.org/en
   ||/books/handbook/cutting-edg
   ||e/#freebsdupdate-upgrade
  Flags||maintainer-feedback?(cperci
   ||v...@freebsd.org)

--- Comment #1 from Graham Perrin  ---


> Performing Major and Minor Version Upgrades

– (currently 25.2.3) includes this (before 25.2.3.1): 

> The upgrade is now complete. If this was a major version upgrade, 
> reinstall all ports and packages as described in Upgrading Packages 
> After a Major Version Upgrade.

– with reference to
:
 

> Upgrading Packages After a Major Version Upgrade

– (currently 25.2.3.2).





I can not tally the suggested sequence of commands in the Handbook (25.2.3,
excluding 25.2.3.1, followed by 25.2.3.2) with the suggsted sequence in today's
RC3 announcement. 

Am I missing something?

-- 
You are receiving this mail because:
You are the assignee for the bug.

[Bug 270338] FreeBSD Handbook: minor and major upgrades with freebsd-update(8): corrections and improvements

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=270338

Bug ID: 270338
   Summary: FreeBSD Handbook: minor and major upgrades with
freebsd-update(8): corrections and improvements
   Product: Documentation
   Version: Latest
  Hardware: Any
OS: Any
Status: New
  Severity: Affects Many People
  Priority: ---
 Component: Books & Articles
  Assignee: d...@freebsd.org
  Reporter: grahamper...@freebsd.org

The UPGRADING section of today's
, highly condensed: 

# freebsd-update upgrade -r 13.2-RC3

# freebsd-update install

# shutdown -r now

# freebsd-update install

# shutdown -r now

# freebsd-update install

– that is, three (3) runs offreebsd-update install



at 74845c5c7f seems to not describe the possibility of a third run in the case
of a major upgrade.

-- 
You are receiving this mail because:
You are the assignee for the bug.