upgrade revision 1.2.2.3 1 1.2 chopps The upgrade to NetBSD 1.1 is a binary upgrade; it would be prohibitive
2 1.2 chopps to make users upgrade by compiling and installing the 1.1 sources, and
3 1.2 chopps it would be very difficult to even compile a set of instructions that
4 1.2 chopps allowed them to do so. Because of the various changes to the system,
5 1.2 chopps the largest being the 64-bit file size support and shared libraries,
6 1.2 chopps it is impractical to upgrade by recompiling from the sources and
7 1.2 chopps installing.
8 1.2 chopps
9 1.2.2.1 chopps To do the upgrade, you must have the NetBSD kernel on AmigaDOS and
10 1.2.2.1 chopps you must transfer the upgrade filesystem upgr-11.fs onto the swap
11 1.2.2.1 chopps partition of the NetBSD hard disk. You must also have at least the
12 1.2.2.1 chopps "base11" binary distribution set available, so that you can upgrade
13 1.2.2.1 chopps with it, using one of the upgrade methods described above. Finally,
14 1.2.2.1 chopps you must have sufficient disk space available to install the new
15 1.2.2.1 chopps binaries. Since the old binaries are being overwritten in place,
16 1.2.2.1 chopps you only need space for the new binaries, which weren't previously
17 1.2.2.1 chopps on the system. If you have a few megabytes free on each of your
18 1.2.2.1 chopps root and /usr partitions, you should have enough space.
19 1.2 chopps
20 1.2 chopps Since upgrading involves replacing the kernel, and most of the system
21 1.2 chopps binaries, it has the potential to cause data loss. You are strongly
22 1.2 chopps advised to BACK UP ANY IMPORTANT DATA ON YOUR DISK, whether on the
23 1.2 chopps NetBSD partition or on another operating system's partition, before
24 1.2 chopps beginning the upgrade process.
25 1.2 chopps
26 1.2 chopps To upgrade your system, follow the following instructions:
27 1.2 chopps
28 1.2.2.1 chopps Transfer the upgrade miniroot filesystem onto the hard disk
29 1.2.2.1 chopps partition used by NetBSD for swapping, as described in the
30 1.2.2.1 chopps "Preparing your System for NetBSD Installation" section above.
31 1.2.2.1 chopps
32 1.2.2.1 chopps Now boot up NetBSD using the 1.1 kernel using the loadbsd
33 1.2.2.1 chopps command:
34 1.2.2.1 chopps
35 1.2.2.1 chopps loadbsd -b netbsd
36 1.2.2.1 chopps
37 1.2.2.1 chopps You should see the screen clear and some information about
38 1.2.2.1 chopps your system as the kernel configures the hardware. Note which
39 1.2.2.1 chopps hard disk device is configured that contains your root and
40 1.2.2.1 chopps swap partition. When prompted for the root device, type
41 1.2.2.1 chopps 'sd0*' (replacing 0 with the disk number that NetBSD used for
42 1.2.2.1 chopps your root/swap device). The '*' character indicates that the
43 1.2.2.1 chopps root filesystem is contained on the swap partition.
44 1.2.2.1 chopps When you reach the prompt asking you for a shell name, just
45 1.2.2.1 chopps hit return.
46 1.2 chopps
47 1.2 chopps You will be presented with some information about the upgrade
48 1.2 chopps process and a warning message, and will be asked if you wish
49 1.2 chopps to proceed with the upgrade process. If you answer
50 1.2 chopps negatively, the upgrade process will stop, and your disk will
51 1.2 chopps not be modified. If you answer affirmatively, the upgrade
52 1.2 chopps process will begin, and your disk will be modified. You may
53 1.2 chopps hit Control-C to stop the upgrade process at any time.
54 1.2 chopps However, if you hit it at an inopportune moment, your system
55 1.2 chopps may be left in an inconsistent (and possibly unusable) state.
56 1.2 chopps
57 1.2 chopps You will be asked if you wish to upgrade your file systems to
58 1.2 chopps the new file system format. If you do, reply affirmatively.
59 1.2 chopps If you don't have your file systems upgraded now, you should
60 1.2 chopps probably do it manually after the install process is complete,
61 1.2 chopps by using "fsck -c 2". Read the fsck(8) manual page for more
62 1.2 chopps details.
63 1.2 chopps
64 1.2 chopps The upgrade program will then check your root file system,
65 1.2 chopps and, if you approved, will upgrade it to the new file system
66 1.2 chopps format. It will then mount your root file system on /mnt.
67 1.2 chopps
68 1.2 chopps If your file systems are being upgraded, the upgrade script
69 1.2 chopps will copy the new fsck(8) program to your hard disk and
70 1.2 chopps upgrade your remaining file systems.
71 1.2 chopps
72 1.2 chopps The upgrade program will then mount all of your file systems
73 1.2 chopps under /mnt. (In other words, your root partition will be
74 1.2 chopps mounted on /mnt, your /usr partition on /mnt/usr, etc.)
75 1.2 chopps
76 1.2 chopps If you don't already have the NetBSD distribution sets on your
77 1.2 chopps disk, look in the installation section for information on how
78 1.2 chopps to transfer them to your disk.
79 1.2 chopps
80 1.2 chopps Once the distribution sets are transferred to your disk,
81 1.2 chopps continue here. (Obviously, if the NetBSD distribution sets
82 1.2 chopps are already on your disk, because you've transferred them
83 1.2 chopps before starting the upgrade process, you don't need to
84 1.2 chopps transfer them again now!)
85 1.2 chopps
86 1.2 chopps After the software has been transferred to the machine (or
87 1.2 chopps mounted, in the case of upgrading via NFS), change into the
88 1.2 chopps directory containing the "base11" distribution set. Once you
89 1.2 chopps are there, run the "Set_tmp_dir" command, and hit return at
90 1.2 chopps the prompt to select the default answer for the temporary
91 1.2 chopps directory's path name. (It should be the path name of the
92 1.2 chopps directory that you're in.)
93 1.2 chopps
94 1.2 chopps Run the command "Extract base11" to upgrade the base
95 1.2 chopps distribution.
96 1.2 chopps
97 1.2 chopps Repeat the above two steps for all of the sets you wish to
98 1.2 chopps upgrade. (For each, change into the directory containing the
99 1.2 chopps set, run "Set_tmp_dir" and accept the default path name, then
100 1.2 chopps run the "Extract <setname>" command.)
101 1.2 chopps
102 1.2 chopps If you were previously using the security distribution set,
103 1.2 chopps you MUST upgrade to the new version, or you will not be able
104 1.2 chopps to log in when the upgrade process is complete. Similarly, if
105 1.2 chopps you were not previously using the security set, you must NOT
106 1.2 chopps upgrade to the new version.
107 1.2 chopps
108 1.2 chopps When you are done upgrading all of the distribution sets you
109 1.2 chopps wish to upgrade, issue the command "Cleanup". It will clean
110 1.2 chopps up the installation, by remaking some system databases. When
111 1.2 chopps it is complete, you should use "halt" to halt the system.
112 1.2 chopps
113 1.2.2.2 chopps You will probably also want to copy the release "netbsd" kernel
114 1.2.2.2 chopps image to your root at some point.
115 1.2.2.2 chopps
116 1.2 chopps Your system has now been upgraded to NetBSD 1.1.
117 1.2 chopps
118 1.2 chopps After a new kernel has been copied to your hard disk, your
119 1.2 chopps machine is a complete NetBSD 1.1 system. However, that
120 1.2 chopps doesn't mean that you're finished with the upgrade process.
121 1.2 chopps There are several things that you should do, or might have to
122 1.2 chopps do, to insure that the system works properly.
123 1.2 chopps
124 1.2 chopps First, if you did not upgrade your file systems to the new
125 1.2 chopps file system format during the upgrade process, you may want to
126 1.2 chopps do so now, with "fsck -c 2". If you are unsure about the
127 1.2 chopps process, it's suggested that you read the fsck(8) manual page.
128 1.2 chopps
129 1.2 chopps Second, you will probably want to get the etc11 distribution,
130 1.2 chopps extract it, and compare its contents with those in your /etc/
131 1.2 chopps directory. You will probably want to replace some of your
132 1.2 chopps system configuration files, or incorporate some of the changes
133 1.2 chopps in the new versions into yours.
134 1.2 chopps
135 1.2 chopps Third, you will probably want to update the set of device
136 1.2 chopps nodes you have in /dev. If you've changed the contents of
137 1.2 chopps /dev by hand, you will need to be careful about this, but if
138 1.2 chopps not, you can just cd into /dev, and run the command "sh
139 1.2 chopps MAKEDEV all".
140 1.2 chopps
141 1.2 chopps Fourth, you must deal with certain changes in the formats of
142 1.2 chopps some of the configuration files. The most notable change is
143 1.2 chopps that the "options" given to many of the file systems in
144 1.2 chopps /etc/fstab or by hand have changed, and some of the file
145 1.2 chopps systems have changed names. To find out what the new options
146 1.2 chopps are, it's suggested that you read the manual page for the
147 1.2 chopps file systems' mount commands, for example mount_nfs(8) for
148 1.2 chopps NFS. (Note that the information for mounts of type "ufs",
149 1.2 chopps i.e. Fast File Systems, are contained in the mount(8) man
150 1.2 chopps page.)
151 1.2 chopps
152 1.2 chopps Finally, you will want to delete old binaries that were part
153 1.2 chopps of the version of NetBSD that you upgraded from and have since
154 1.2 chopps been removed from the NetBSD distribution. You might also
155 1.2 chopps want to recompile any locally-built binaries, to take
156 1.2 chopps advantage of the shared libraries. (Note that any new
157 1.2 chopps binaries that you build will be dynamically linked, and
158 1.2 chopps therefore take advantage of the shared libraries, by default.
159 1.2 chopps For information on how to make statically linked binaries,
160 1.2 chopps see the cc(1) and ld(1) manual pages.)
161