svn commit: r344972 - head

[Warner Losh]

On Sat, Mar 9, 2019 at 10:32 AM Alan Somers <asomers at freebsd.org> wrote:

> On Sat, Mar 9, 2019 at 10:18 AM Warner Losh <imp at freebsd.org> wrote:
> >
> > Author: imp
> > Date: Sat Mar  9 17:17:59 2019
> > New Revision: 344972
> > URL: https://svnweb.freebsd.org/changeset/base/344972
> >
> > Log:
> >   Augment ino64 entry
> >
> >   When updating across this change (the introduction of ino64), the
> >   "fast and loose" practice of rebooting to multiuser and then doing an
> >   installworld fails with missing symbols. Recommend strongly that users
> >   do this in single user mode. The multiuser case only ever works by
> >   accident because its requirements are stronger than is supported
> >   accross this change. It usually works because critical symbols don't
> >   change their version number in libc, which wasn't the case here.
> >
> > Modified:
> >   head/UPDATING
>
> Booting into single-user mode will work, but using boot environments
> works even better.  You can install both kernel and world into the new
> boot environment and then reboot into it.  The only downside is that
> it requires booting from ZFS.
>

We don't document that as the preferred upgrade path. Adding that
documentation is likely confusing unless it's a separate section in
UPDATING, so if you want to write a new section on how to do that, and when
you can and can't use it, we can include that in UPDATING....

Also boot environments in 11.1R were somewhat tricky and difficult to
arrange, absent tools not present in base at the time, which is where I was
coming from.

Warner