upgrade revision 1.5 
1	$NetBSD: upgrade,v 1.5 1998/01/09 18:47:15 perry Exp $	
2
3
4The preferred upgrade path is to set up a diskless-boot host, unpack
5and boot boot 1.3 diskimage as for a network installation, and to use
6the sysinst tool to upgrade your system.   Please see the `Installation'
7section for  further information.
8
9
10Upgrade via diskimage.
11----------------------
12
13If you cannot netboot, the recommended path is to upgrade by booting a
14diskimage from your swap partition.  Pmaxes cannot boot out out of
15anything but the 'a' partition. However, you *can* boot an upgrade
16kernel off your 'a' partition and tell that kernel  to use your
17'b' partition as its root.  The steps to do this
18(after you've  fetched the diskimage) with a current root of rzX are:
19
20	1) boot single-user from your current root, rzX.
21	    Be *sure* not to start swapping:
22
23		>> boot -f rz(0,X,0)netbsd -s 		# 3100
24		>> boot 5/rzX/netbsd -s 		# 5000/200
25		>> boot 3/rzX/netbsd -s 		# others
26
27	(NOTE: replace the X with the unit number of your disk:
28         boot 3/rz2/netbsd to boot drive 2 on a 5000/xxx.)
29
30	2) When you get a single-user prompt,  remount the
31	   root filesystem read-write. (You wil need to update the
32	   kernel soon.)
33
34		# mount /
35
36	   Then mount the filesystem with the diskimage, and
37	   uncompress and dd the diskimage into swap (b) partition.
38	   You will also need /usr mounted to run gunzip:
39
40		# mount /usr
41		# gunzip -c diskimage.gz | dd bs=10240 of=/dev/rrzXb
42
43	3) Mount swap (b) partition readonly on /mnt:
44		# mount -r -t ffs /dev/rzXb /mnt
45
46	4) Copy  the kernel from the B partition to your root:
47		cp -p  /mnt/netbsd /netbsd-1.3
48	   (this is important; you want the kernel in / and  swap
49	   to be a release kernel, or the release binaries will not work.)
50
51	5) halt:
52		# halt
53
54	6) Reboot with an argument of "n", telling the kernel to
55	   ask what device to use as  root:
56
57		>> boot -f rz(0,X,0)netbsd-1.3 n 	# 3100
58		>> boot 5/rzX/netbsd-1.3 n	 	# 5000/200
59		>> boot 3/rzX/netbsd-1.3 n 		# others
60
61	(NOTE: the n after the kernel name is a literal "n",
62	 not the disk unit number or partition. 
63	 It is an argument telling the kernel to ask for a root device.
64	 NOTE: replace the X with the unit number of your disk:
65         boot 3/rz2/netbsd to boot drive 2 on a 5000/xxx.)
66
67
68	7) The "n" argument tells the kernel to prompt you for
69	   the  root device, dump device, and root fileysystem type.
70	     Enter when the kernel asks for
71		Root device:
72
73	Tell it rzXb, where X is the same disk unit as in step 6.
74	Here's an example, again assuming drive  2 as in step 6:
75
76	KN03-AA V5.2b    (PC: 0x80051f1c, SP: 0xffffdeb0)
77	>> boot 3/rz2/netbsd n
78
79		boot device: rz2
80	root device (default rz2a): 
81	        <<< enter `rz2b' >>>
82	dump device (default rz2b): 
83	        <<< enter `none' >>>
84	file system (default generic): 
85	        <<< enter `ffs' >>>
86	root on rz2b
87
88
89then continue from the ``Once you've booted the diskimage'' step of
90the Installation instructions.
91
92
93
94
95