upgrade revision 1.9.2.5 1 1.9.2.5 mycroft $NetBSD: upgrade,v 1.9.2.5 1998/05/29 03:42:10 mycroft Exp $
2 1.9.2.4 mycroft
3 1.9.2.4 mycroft The upgrade to NetBSD _VER is a binary upgrade; it can be quite difficult
4 1.9.2.4 mycroft to advance to a later version by recompiling from source due primarily
5 1.9.2.5 mycroft to interdependencies in the various components.
6 1.1 cgd
7 1.9.2.1 perry To do the upgrade, you must have the boot floppy image (boot.fs)
8 1.9.2.1 perry available. You must also have at least the "base" and "kern"
9 1.7 perry binary distribution sets available, so that you can upgrade with it,
10 1.7 perry using one of the upgrade methods described above. Finally, you must
11 1.7 perry have sufficient disk space available to install the new binaries.
12 1.7 perry Since the old binaries are being overwritten in place, you only need
13 1.7 perry space for the new binaries, which weren't previously on the system.
14 1.7 perry If you have a few megabytes free on each of your root and /usr
15 1.7 perry partitions, you should have enough space.
16 1.1 cgd
17 1.1 cgd Since upgrading involves replacing the boot blocks on your NetBSD
18 1.1 cgd partition, the kernel, and most of the system binaries, it has the
19 1.1 cgd potential to cause data loss. You are strongly advised to BACK UP ANY
20 1.1 cgd IMPORTANT DATA ON YOUR DISK, whether on the NetBSD partition or on
21 1.1 cgd another operating system's partition, before beginning the upgrade
22 1.1 cgd process.
23 1.1 cgd
24 1.9.2.2 perry The upgrade procedure using the sysinst tool is basically the
25 1.9.2.3 perry same as an installation, but without the hard disk partitioning.
26 1.9.2.2 perry Another difference is that existing configuration files in /etc
27 1.9.2.2 perry are backed up, and merged with the new files. Getting the binary
28 1.9.2.2 perry sets is done in the same manner as the installation procedure;
29 1.9.2.2 perry refer to the installation part of the document, section 7 and 8,
30 1.9.2.2 perry on how to do this. Also, some sanity checks are done, i.e.
31 1.9.2.2 perry filesystems are checked before unpacking the sets.
32 1.9.2.2 perry
33 1.9.2.2 perry After a new kernel has been copied to your hard disk, your
34 1.9.2.2 perry machine is a complete NetBSD _VER system. However, that
35 1.9.2.2 perry doesn't mean that you're finished with the upgrade process.
36 1.9.2.2 perry You will probably want to update the set of device
37 1.9.2.2 perry nodes you have in /dev. If you've changed the contents of
38 1.9.2.2 perry /dev by hand, you will need to be careful about this, but if
39 1.9.2.2 perry not, you can just cd into /dev, and run the command "sh
40 1.9.2.2 perry MAKEDEV all".
41 1.9.2.2 perry
42 1.9.2.2 perry You must also deal with certain changes in the formats of
43 1.9.2.2 perry some of the configuration files. The most notable change is
44 1.9.2.2 perry that the "options" given to many of the file systems in
45 1.9.2.2 perry /etc/fstab or by hand have changed, and some of the file
46 1.9.2.2 perry systems have changed names. To find out what the new options
47 1.9.2.2 perry are, it's suggested that you read the manual page
48 1.9.2.2 perry for the file systems' mount commands, for example mount_nfs(8)
49 1.9.2.2 perry for NFS.
50 1.9.2.2 perry
51 1.9.2.2 perry Finally, you will want to delete old binaries that were part
52 1.9.2.2 perry of the version of NetBSD that you upgraded from and have since
53 1.9.2.2 perry been removed from the NetBSD distribution.
54