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