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