upgrade revision 1.1.2.2
1 1.1.2.2 mycroft The upgrade to NetBSD 1.2.1 is a binary upgrade; it would be prohibitive 2 1.1.2.2 mycroft to make users upgrade by compiling and installing the 1.2.1 sources, and 3 1.1.2.2 mycroft it would be very difficult to even compile a set of instructions that 4 1.1.2.2 mycroft allowed them to do so. Because of the many changes to the system, it 5 1.1.2.2 mycroft is difficult impractical to upgrade by recompiling from the sources 6 1.1.2.2 mycroft and installing. 7 1.1.2.2 mycroft 8 1.1.2.2 mycroft To do the upgrade, you must have the appropriate kernel-copy floppy 9 1.1.2.2 mycroft image on a disk, and the upgr121.fs floppy image on another. You must 10 1.1.2.2 mycroft also have at least the "base121" binary distribution set available, 11 1.1.2.2 mycroft so that you can upgrade with it, using one of the upgrade methods 12 1.1.2.2 mycroft described above. Finally, you must have sufficient disk space 13 1.1.2.2 mycroft available to install the new binaries. Since the old binaries are 14 1.1.2.2 mycroft being overwritten in place, you only need space for the new binaries, 15 1.1.2.2 mycroft which weren't previously on the system. If you have a few megabytes 16 1.1.2.2 mycroft free on each of your root and /usr partitions, you should have enough 17 1.1.2.2 mycroft space. 18 1.1.2.2 mycroft 19 1.1.2.2 mycroft Since upgrading involves replacing the boot blocks on your NetBSD 20 1.1.2.2 mycroft partition, the kernel, and most of the system binaries, it has the 21 1.1.2.2 mycroft potential to cause data loss. You are strongly advised to BACK UP ANY 22 1.1.2.2 mycroft IMPORTANT DATA ON YOUR DISK, whether on the NetBSD partition or on 23 1.1.2.2 mycroft another operating system's partition, before beginning the upgrade 24 1.1.2.2 mycroft process. 25 1.1.2.2 mycroft 26 1.1.2.2 mycroft To upgrade your system, follow the following instructions: 27 1.1.2.2 mycroft 28 1.1.2.2 mycroft Boot your machine using of the appropriate kernel-copy floppy. 29 1.1.2.2 mycroft 30 1.1.2.2 mycroft You will be prompted to insert a file system floppy. Remove 31 1.1.2.2 mycroft the kernel-copy floppy and insert the upgr121 floppy, then hit 32 1.1.2.2 mycroft any key to continue booting. 33 1.1.2.2 mycroft 34 1.1.2.2 mycroft While booting, you will probably see several warnings. You 35 1.1.2.2 mycroft should be warned that no swap space is present, and that 36 1.1.2.2 mycroft init(8) cannot find /etc/rc. Do not be alarmed, these are 37 1.1.2.2 mycroft completely normal. When you reach the prompt asking you for a 38 1.1.2.2 mycroft shell name, just hit return. 39 1.1.2.2 mycroft 40 1.1.2.2 mycroft You will be presented with some information about the upgrade 41 1.1.2.2 mycroft process and a warning message, and will be asked if you wish 42 1.1.2.2 mycroft to proceed with the upgrade process. If you answer 43 1.1.2.2 mycroft negatively, the upgrade process will stop, and your disk will 44 1.1.2.2 mycroft not be modified. If you answer affirmatively, the upgrade 45 1.1.2.2 mycroft process will begin, and your disk will be modified. You may 46 1.1.2.2 mycroft hit Control-C to stop the upgrade process at any time. 47 1.1.2.2 mycroft However, if you hit it at an inopportune moment, your system 48 1.1.2.2 mycroft may be left in an inconsistent (and possibly unusable) state. 49 1.1.2.2 mycroft 50 1.1.2.2 mycroft You will be asked if you wish to upgrade your file systems to 51 1.1.2.2 mycroft the new file system format. If you do, reply affirmatively. 52 1.1.2.2 mycroft If you don't have your file systems upgraded now, you should 53 1.1.2.2 mycroft probably do it manually after the install process is complete, 54 1.1.2.2 mycroft by using "fsck -c 2". Read the fsck(8) manual page for more 55 1.1.2.2 mycroft details. Note that this step is only important when upgrading 56 1.1.2.2 mycroft from a pre-NetBSD 1.0 release. 57 1.1.2.2 mycroft 58 1.1.2.2 mycroft The upgrade program will then check your root file system, 59 1.1.2.2 mycroft and, if you approved, will upgrade it to the new file system 60 1.1.2.2 mycroft format. It will then mount your root file system on /mnt. 61 1.1.2.2 mycroft 62 1.1.2.2 mycroft If your file systems are being upgraded, the upgrade script 63 1.1.2.2 mycroft will copy the new fsck(8) program to your hard disk and 64 1.1.2.2 mycroft upgrade your remaining file systems. 65 1.1.2.2 mycroft 66 1.1.2.2 mycroft The upgrade program will then automatically replace the boot 67 1.1.2.2 mycroft blocks on your disk with newer versions, and mount all of your 68 1.1.2.2 mycroft file systems under /mnt. (In other words, your root partition 69 1.1.2.2 mycroft will be mounted on /mnt, your /usr partition on /mnt/usr, etc.) 70 1.1.2.2 mycroft 71 1.1.2.2 mycroft If you don't already have the NetBSD distribution sets on your 72 1.1.2.2 mycroft disk, look in the installation section for information on how 73 1.1.2.2 mycroft to transfer them to your disk. 74 1.1.2.2 mycroft 75 1.1.2.2 mycroft If you have only one floppy drive, and don't have the disk 76 1.1.2.2 mycroft space to copy all of the distribution onto the hard drive, you 77 1.1.2.2 mycroft can do the following: 78 1.1.2.2 mycroft 79 1.1.2.2 mycroft Install a kernel on the hard drive as detailed a few 80 1.1.2.2 mycroft paragraphs below, then boot off the hard drive. Now 81 1.1.2.2 mycroft you can copy and install distribution sets 82 1.1.2.2 mycroft incrementally from your lone floppy drive. 83 1.1.2.2 mycroft 84 1.1.2.2 mycroft Once the distribution sets are transferred to your disk, 85 1.1.2.2 mycroft continue here. (Obviously, if the NetBSD distribution sets 86 1.1.2.2 mycroft are already on your disk, because you've transferred them 87 1.1.2.2 mycroft before starting the upgrade process, you don't need to 88 1.1.2.2 mycroft transfer them again now!) 89 1.1.2.2 mycroft 90 1.1.2.2 mycroft After the software has been transferred to the machine (or 91 1.1.2.2 mycroft mounted, in the case of upgrading via NFS), change into the 92 1.1.2.2 mycroft directory containing the "base121" distribution set. Once you 93 1.1.2.2 mycroft are there, run the "Set_tmp_dir" command, and hit return at 94 1.1.2.2 mycroft the prompt to select the default answer for the temporary 95 1.1.2.2 mycroft directory's path name. (It should be the path name of the 96 1.1.2.2 mycroft directory that you're in.) 97 1.1.2.2 mycroft 98 1.1.2.2 mycroft Run the command "Extract base121" to upgrade the base 99 1.1.2.2 mycroft distribution. 100 1.1.2.2 mycroft 101 1.1.2.2 mycroft Repeat the above two steps for all of the sets you wish to 102 1.1.2.2 mycroft upgrade. (For each, change into the directory containing the 103 1.1.2.2 mycroft set, run "Set_tmp_dir" and accept the default path name, then 104 1.1.2.2 mycroft run the "Extract <setname>" command.) 105 1.1.2.2 mycroft 106 1.1.2.2 mycroft If you were previously using the security distribution set, 107 1.1.2.2 mycroft you MUST upgrade to the new version, or you will not be able 108 1.1.2.2 mycroft to log in when the upgrade process is complete. Similarly, if 109 1.1.2.2 mycroft you were not previously using the security set, you must NOT 110 1.1.2.2 mycroft upgrade to the new version. 111 1.1.2.2 mycroft 112 1.1.2.2 mycroft When you are done upgrading all of the distribution sets you 113 1.1.2.2 mycroft wish to upgrade, issue the command "Cleanup". It will clean 114 1.1.2.2 mycroft up the installation, by remaking some system databases. When 115 1.1.2.2 mycroft it is complete, you should use "halt" to halt the system. 116 1.1.2.2 mycroft 117 1.1.2.2 mycroft When the system is halted, remove the "upgr121" floppy from 118 1.1.2.2 mycroft the floppy drive, and replace it with the NetBSD 1.2.1 119 1.1.2.2 mycroft kernel-copy floppy that you previously booted from. Reboot 120 1.1.2.2 mycroft with that floppy. 121 1.1.2.2 mycroft 122 1.1.2.2 mycroft Once again, you will be prompted to insert a file system 123 1.1.2.2 mycroft floppy. DO NOT replace the kernel-copy floppy, just hit any 124 1.1.2.2 mycroft key. 125 1.1.2.2 mycroft 126 1.1.2.2 mycroft Again, While booting, you may see several warnings. You may 127 1.1.2.2 mycroft be warned that no swap space is present, that init(8) cannot 128 1.1.2.2 mycroft find /etc/rc, and that one or more databases with names like 129 1.1.2.2 mycroft "pwd.db" cannot be found. Do not be alarmed, as, again, these 130 1.1.2.2 mycroft are completely normal. Hit return at the prompt asking you 131 1.1.2.2 mycroft for a shell name. 132 1.1.2.2 mycroft 133 1.1.2.2 mycroft You will be presented with a shell prompt, at which you should 134 1.1.2.2 mycroft enter the "copy_kernel" command. It will ask you what 135 1.1.2.2 mycroft partition to copy the kernel to, and you should reply with the 136 1.1.2.2 mycroft name of your root partition (e.g. sd0a or wd0a). 137 1.1.2.2 mycroft 138 1.1.2.2 mycroft You will be asked if you are sure that you want to copy the 139 1.1.2.2 mycroft kernel. Reply affirmatively, and it will check the file 140 1.1.2.2 mycroft system on your root partition, mount it, and copy the kernel. 141 1.1.2.2 mycroft Once the kernel is copied, you should use "halt" to halt the 142 1.1.2.2 mycroft system. 143 1.1.2.2 mycroft 144 1.1.2.2 mycroft Once the system is halted, remove the kernel-copy floppy from 145 1.1.2.2 mycroft the floppy disk drive, and hit any key to reboot. 146 1.1.2.2 mycroft 147 1.1.2.2 mycroft Your system has now been upgraded to NetBSD 1.2.1. 148 1.1.2.2 mycroft 149 1.1.2.2 mycroft After a new kernel has been copied to your hard disk, your 150 1.1.2.2 mycroft machine is a complete NetBSD 1.2.1 system. However, that 151 1.1.2.2 mycroft doesn't mean that you're finished with the upgrade process. 152 1.1.2.2 mycroft There are several things that you should do, or might have to 153 1.1.2.2 mycroft do, to insure that the system works properly. 154 1.1.2.2 mycroft 155 1.1.2.2 mycroft First, if you did not upgrade your file systems to the new 156 1.1.2.2 mycroft file system format during the upgrade process, and you are 157 1.1.2.2 mycroft upgrading from a pre-1.0 NetBSD, you may want to do so now, 158 1.1.2.2 mycroft with "fsck -c 2". If you are unsure about the process, it's 159 1.1.2.2 mycroft suggested that you read the fsck(8) manual page. 160 1.1.2.2 mycroft 161 1.1.2.2 mycroft Second, you will probably want to get the etc121 distribution, 162 1.1.2.2 mycroft extract it, and compare its contents with those in your /etc/ 163 1.1.2.2 mycroft directory. You will probably want to replace some of your 164 1.1.2.2 mycroft system configuration files, or incorporate some of the changes 165 1.1.2.2 mycroft in the new versions into yours. 166 1.1.2.2 mycroft 167 1.1.2.2 mycroft Third, you will probably want to update the set of device 168 1.1.2.2 mycroft nodes you have in /dev. If you've changed the contents of 169 1.1.2.2 mycroft /dev by hand, you will need to be careful about this, but if 170 1.1.2.2 mycroft not, you can just cd into /dev, and run the command "sh 171 1.1.2.2 mycroft MAKEDEV all". 172 1.1.2.2 mycroft 173 1.1.2.2 mycroft Fourth, you must deal with certain changes in the formats of 174 1.1.2.2 mycroft some of the configuration files. The most notable change is 175 1.1.2.2 mycroft that the "options" given to many of the file systems in 176 1.1.2.2 mycroft /etc/fstab or by hand have changed, and some of the file 177 1.1.2.2 mycroft systems have changed names. *IMPORTANT*: ANY INSTANCES OF "ufs" 178 1.1.2.2 mycroft IN /etc/fstab MUST BE CHANGED TO "ffs". To find out what the 179 1.1.2.2 mycroft new options are, it's suggested that you read the manual page 180 1.1.2.2 mycroft for the file systems' mount commands, for example mount_nfs(8) 181 1.1.2.2 mycroft for NFS. (Note that the information for mounts of type "ffs", 182 1.1.2.2 mycroft i.e. Fast File Systems, are contained in the mount(8) man 183 1.1.2.2 mycroft page.) 184 1.1.2.2 mycroft 185 1.1.2.2 mycroft Finally, you will want to delete old binaries that were part 186 1.1.2.2 mycroft of the version of NetBSD that you upgraded from and have since 187 1.1.2.2 mycroft been removed from the NetBSD distribution. If you are 188 1.1.2.2 mycroft upgrading from a pre-1.0 NetBSD, you might also 189 1.1.2.2 mycroft want to recompile any locally-built binaries, to take 190 1.1.2.2 mycroft advantage of the shared libraries. (Note that any new 191 1.1.2.2 mycroft binaries that you build will be dynamically linked, and 192 1.1.2.2 mycroft therefore take advantage of the shared libraries, by default. 193 1.1.2.2 mycroft For information on how to make statically linked binaries, 194 1.1.2.2 mycroft see the cc(1) and ld(1) manual pages.) 195
Indexes created Tue Oct 28 12:10:06 GMT 2025