Upgrade documentation

Q

Quim

Hi,

Been using FreeBSD since 2009 and I love it, the documentation is always spot on - except for this one thing, which I don't understand even as an old user why its not more clear, on the upgrade page for every single minor och major version this step is just not mentioning exactly how to proceed as best practise.


"Upgrade the Userland

After rebooting, run freebsd-update(8) again to install the new userland components:
freebsd-update install
freebsd-update(8) may prompt to rebuild or reinstall all third-party software due to changes in system libraries. Follow those instructions as needed."

-------------------
The prompter just says the same thing as above, why not say exactly how to rebuild or reinstall 3rd party softare, the explicit commands that is.


Like:
pkg-static upgrade -f, which I guess is the proper way?
Because "pkg upgrade" isn't always optimal here, right?

Or should I run all of these commands to be sure?
pkg-static install -f pkg
pkg update
pkg upgrade

and then finishing off with freebsd-update install to clear out the old, which is actually says to do after upgrading/rebuilding the packages.


--

Or am I missing something that is clear for everyone else? :)
 
Quim said:
After rebooting, run freebsd-update(8) again to install the new userland components:
freebsd-update install
freebsd-update(8) may prompt to rebuild or reinstall all third-party software due to changes in system libraries. Follow those instructions as needed."
Click to expand...
Only after a major version upgrade.

Quim said:
Or should I run all of these commands to be sure?
pkg-static install -f pkg
pkg update
pkg upgrade
Click to expand...
pkg bootstrap -f
pkg upgrade

No need for pkg-update(8) unless you feel your locally cached catalog might be out of whack.
 
alright, but why isn't this information in the prompt or clear in the manual?

everything else is always clear with examples, here it just tells you to do something, as a new user you usually feel very vulnerable at this stage when doing major upgrades.
 
So, first... I don't get what it is you're hinting at. Where exactly did you find that documentation snippet? If you're commenting on something then always try to be precise, especially because FreeBSD documentation isn't limited to just the handbook or manualpages or maybe command output...

I'm pretty sure people don't mind taking a new (open minded) loko, but that vibe quickly evaporates when you need to actively search for it. I checked update-freebsd(8), I checked chapter 27 of the handbook and I just can't find what it is you're talking about.

(edit) Still, always keep in mind that the handbook is a thing. If you need more elaborate examples... that's where to look.
 
You must log in or register to reply here.
Back
Top