Date: Wed, 22 May 2002 19:02:53 +0300 From: Ruslan Ermilov <ru@FreeBSD.org> To: Doug Barton <dougb@FreeBSD.org>, Warner Losh <imp@FreeBSD.org>, John Baldwin <jhb@FreeBSD.org>, John De Boskey <jwd@FreeBSD.org> Cc: current@FreeBSD.org Subject: Upgrade instructions are incorrect Message-ID: <20020522160253.GD55670@sunbay.com>
next in thread | raw e-mail | index | archive | help
--bjuZg6miEcdLYP6q
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable
Hi!
The upgrade instructions found in src/UPDATING and src/Makefile.inc1
are not quite correct. Suggesting to reboot with the new kernel and
non-matching userland is safer than opposite of course, but does not
always work nor guaranteed to work at all. Here's the safest version
I could think of; it ensures everything is installed using the tools
compatible with the currently running kernel. I'd like your comments
guys as you were touching these instructions in the past.
%%%
Index: UPDATING
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
RCS file: /home/ncvs/src/UPDATING,v
retrieving revision 1.208
diff -u -r1.208 UPDATING
--- UPDATING 20 May 2002 13:06:24 -0000 1.208
+++ UPDATING 22 May 2002 15:45:49 -0000
@@ -958,10 +958,10 @@
make buildkernel KERNCONF=3DYOUR_KERNEL_HERE
cp src/sys/${MACHINE_ARCH}/conf/GENERIC.hints /boot/device.hints [2]
make installkernel KERNCONF=3DYOUR_KERNEL_HERE
- reboot in single user [3]
+ shutdown in single user [3]
mergemaster -p [5]
- make installworld
mergemaster [4]
+ make installworld
[1]
<reboot>
=20
@@ -985,14 +985,17 @@
your own device.hints to reflect your unique hardware
configuration.
=20
- [3] From the bootblocks, boot -s, and then do
+ [3] Do not reboot with the new kernel as your installed
+ binaries may be incompatible with it. Instead, shutdown
+ or reboot with the old kernel in single user mode. If
+ rebooted, from the bootblocks, boot -s, and then do
fsck -p
mount -u /
mount -a
cd /usr/src
adjkerntz -i # if CMOS is wall time
Also, when doing a major release upgrade, it is required that
- you boot into single user mode to do the installworld.
+ you operate in single user mode to do the installworld.
=20
[4] Note: This step is non-optional. Failure to do this step
can result in a significant reduction in the functionality of the
Index: Makefile
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
RCS file: /home/ncvs/src/Makefile,v
retrieving revision 1.256
diff -u -r1.256 Makefile
--- Makefile 12 May 2002 16:00:43 -0000 1.256
+++ Makefile 22 May 2002 15:45:49 -0000
@@ -48,10 +48,10 @@
# 2. `make buildworld'
# 3. `make buildkernel KERNCONF=3DYOUR_KERNEL_HERE' (default is GENER=
IC).
# 4. `make installkernel KERNCONF=3DYOUR_KERNEL_HERE' (default is GENER=
IC).
-# 5. `reboot' (in single user mode: boot -s from the loader prompt=
).
+# 5. `shutdown' or `reboot' into single user mode with the old kernel.
# 6. `mergemaster -p'
-# 7. `make installworld'
-# 8. `mergemaster'
+# 7. `mergemaster'
+# 8. `make installworld'
# 9. `reboot'
#
# See src/UPDATING `COMMON ITEMS' for more complete information.
%%%
Cheers,
--=20
Ruslan Ermilov Sysadmin and DBA,
ru@sunbay.com Sunbay Software AG,
ru@FreeBSD.org FreeBSD committer,
+380.652.512.251 Simferopol, Ukraine
http://www.FreeBSD.org The Power To Serve
http://www.oracle.com Enabling The Information Age
--bjuZg6miEcdLYP6q
Content-Type: application/pgp-signature
Content-Disposition: inline
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.7 (FreeBSD)
iD8DBQE868EtUkv4P6juNwoRAqP0AJ4ygOlGsIyr0EJifaGn0uWdsqm7pgCcCk11
QiubqsuAXvjkEHbO3Td/JZU=
=VZcs
-----END PGP SIGNATURE-----
--bjuZg6miEcdLYP6q--
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-current" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020522160253.GD55670>