upgrade revision 1.2
1It is possible to easily upgrade your existing NetBSD/hp300 system
2using the upgrade program in the miniroot.  If you wish to upgrade
3your system by this method, simply select the `upgrade' option once
4the miniroot has booted.  The upgrade program with then guide you
5through the procedure.  The upgrade program will:
6
7	* Enable the network based on your system's current
8	  network configuration.
9
10	* Mount your existing filesystems.
11
12	* Extract binary sets from the media of your choice.
13
14	* Fixup your system's existing /etc/fstab, changing the
15	  occurrences of `ufs' to `ffs' and let you edit the
16	  resulting file.
17
18	* Make new device nodes in your root filesystem.
19
20	* Copy a new kernel onto your root partition.
21	  NOTE: the existing kernel WILL NOT be backed up; doing
22	  so would be pointless, since a NetBSD 1.0 kernel will
23	  not run NetBSD 1.1 executables.
24
25	* Install a new boot block.
26
27	* Check your filesystems for integrity.
28
29While using the miniroot's upgrade program is the preferred method
30of upgrading your system, it is possible to upgrade your system
31manually.  To do this, follow the following procedure:
32
33	* Place _at least_ the `base' binary set in a filesystem
34	  accessible to the target machine.  A local filesystem
35	  is preferred, since there may be incompatibilities
36	  between the NetBSD 1.1 kernel and older route(8)
37	  binaries.
38
39	* Back up your pre-existing kernel and copy the 1.1
40	  kernel into your root partition.
41
42	* Reboot with the 1.1 kernel into single-user mode.
43
44	* Check all filesystems:
45
46		/sbin/fsck -p
47
48	* Mount all local filesystems:
49
50		/sbin/mount -a -t nonfs
51
52	* If you keep /usr or /usr/share on an NFS server, you
53	  will want to mount those filesystems as well.  To do
54	  this, you will need to enable the network:
55
56		sh /etc/netstart
57
58	  NOTE: the route(8) commands may fail due to potential
59	  incompatibilities between route(8) and the NetBSD 1.1
60	  kernel.  Once you have enabled the network, mount the
61	  NFS filesystems.  If you use amd(8), you may or may not
62	  have to mount these filesystems manually.  Your mileage
63	  may vary.
64
65	* Make sure you are in the root filesystem and extract
66	  the `base' binary set:
67
68		cd /
69		tar --unlink -zxvpf /path/to/base11.tar.gz
70
71	  NOTE: the `--unlink' option is _very_ important!
72
73	* Install a new boot block:
74
75		cd /usr/mdec
76		disklabel -B <root disk, e.g. sd0>
77
78	* Sync the filesystems:
79
80		sync
81
82	* At this point you may extract any other binary sets
83	  you may have placed on local filesystems, or you may
84	  wish to extract additional sets at a later time.
85	  To extract these sets, use the following commands:
86
87		cd /
88		tar --unlink -zxvpf <path to set>
89
90NOTE: you SHOULD NOT extract the `etc' set if upgrading.  Instead, you
91should extract that set into another area and carefully merge the changes
92by hand.
93