upgrade revision 1.7
1The upgrade to NetBSD _VER is a binary upgrade; it would be prohibitive 2to make users upgrade by compiling and installing the _VER sources, and 3it would be very difficult to even compile a set of instructions that 4allowed them to do so. Because of the many changes to the system, it 5is difficult and impractical to upgrade by recompiling from the sources 6and installing. 7 8No automated upgrade procedure exists for upgrading to release _VER for the 9NetBSD/mac68k architecture. The current procedure is essentially to perform 10a new install from scratch. It is hoped that there will be a good upgrade 11procedure for future releases. Please feel free to volunteer to help 12replace these installation tools. 13 14The following steps outline the current upgrade procedure. These steps 15should help ease the upgrade process. Please read these instructions 16carefully and completely before proceeding: 17 181) Since upgrading involves replacing the kernel and most of the system 19 binaries, it has the potential to cause data loss. You are strongly 20 advised to BACK UP ANY IMPORTANT DATA ON YOUR DISK, whether on the 21 NetBSD partition or on another operating system's partition, before 22 beginning the upgrade process. Although the upgrade should not 23 damage your filesystem(s) in any way, you never know what may happen. 24 252) Download the distribution sets you want from the "mac68k/binaries" 26 subdirectory of the NetBSD _VER distribution. You will need the base 27 set and the kernel at a minimum. Be sure to download the files in 28 _binary_ mode. If you will be upgrading from within NetBSD, make sure 29 that you place the distribution sets on a filesystem you will be able to 30 reach from single-user mode. 31 323) Install the _VER kernel. You may either use the Installer utility 33 (included in the utils subdirectory) or install from within 34 NetBSD (the latter is recommended for speed reasons). If you choose 35 the former, proceed as you normally would. If you choose to install from 36 within NetBSD, then boot (or shutdown) into single-user mode and do the 37 following: 38 39 cd / 40 tar -zxvpf netbsd13 (substitute the full path to archive here) 41 42 There is no need to explicitly backup your old kernel since it will be 43 incapable of running many the newer binaries you are about to install. 44 454) If you are installing using the Installer, skip to step 5. Otherwise, 46 reboot into NetBSD in single-user mode. Run 'fsck -f' and then mount all 47 local partitions read/write. Usually 'mount -a -t nonfs' should do the 48 trick, but if you have several partitions on the same disk, take note of 49 the fact that a change in partition numbering may have moved a few of 50 your partitions around. You can do a 'disklabel sdX' (where X is a 51 drive on which you have NetBSD partitions) to see how the partitions are 52 currently layed out. It is likely that a partition has shifted into 53 'sdXd', a slot that was not available under previous releases of NetBSD. 54 If this is the case, you will need to manually mount your root partition 55 (via 'mount -w /') and edit your /etc/fstab file to reflect the new 56 partition layout. Unless you are familiar with 'ex', the easiest way to 57 fix your /etc/fstab file is probably to simply do a 'cat > /etc/fstab' 58 and type in the corrected file in its entirety. 59 605) Install the distribution sets. Keep in mind that the NetBSD _VER 61 distribution takes up a considerable amount more of disk space than did 62 the 1.2 or 1.2.1 distributions. If you are using the Installer, proceed 63 normally (remember that you will need to mount non-root partitions by 64 hand using the MiniShell before installing). If you are installing from 65 with NetBSD, do the following: 66 67 cd / 68 tar --unlink -zxvpf base13 (substitute the full path to the archive here) 69 70 It is crucial that you use the '--unlink' flag when invoking tar or you 71 will fail to correctly overwrite some files. Keep in mind that there is 72 no going back once you have installed the base set short of a complete 73 reinstall of an earlier distribution. Continue with the appropriate 74 command line for each of the other packages you have installed except for 75 the etc package. If you are in the Installer, open up the Minishell and 76 do the following: 77 78 cd /tmp 79 exit 80 81 Now, use the Installer to install the etc package (it will install into 82 /tmp instead of the /etc/ directory). 83 84 If you are in NetBSD, do the following instead: 85 86 cd /tmp 87 tar --unlink -zxvpf etc13 (substitute the full path to the archive here) 88 896) If you are in the Installer, quit it and boot into NetBSD in single-user 90 mode. From there, 'cd' to the /tmp/etc directory and compare each file 91 there with your old files in /etc. You will probably want to replace 92 some of your system configuration files, or incorporate some of the 93 changes in the new versions into yours. You should take note of the 94 following when upgrading to the etc13 set: 95 96 * The first file to pay attention to is /etc/rc.conf. This file did not 97 exist under NetBSD 1.2, but it is used to configure the rc scripts 98 under NetBSD _VER. Edit the file to your preferences, making sure that 99 you change the line that says: 100 101 rc_configured=NO 102 103 to read: 104 105 rc_configured=YES 106 107 This will enable all of the options you have configured in /etc/rc.conf. 108 109 * The next important item to take note of is the new networking 110 configuration files. If you currently have an /etc/hostname.xxN file 111 (fill in the xxN with either ae0 or sn0), you will need to convert it 112 into an ifconfig.xxN file before networking automatically works. The 113 format for the new file is simply the arguments which you would give 114 to ifconfig on the command line. The following is an example of the 115 minimal ifconfig.xxN file: 116 117 inet hostname.domain.dom netmask 0xffffff00 118 119 Read the ifconfig(8) man page for more details on arguments to ifconfig. 120 Be sure to set 121 122 auto_ifconfig=YES 123 124 in /etc/rc.conf to ensure that your network interfaces will be brought 125 up automatically on boot. 126 127 * Many of the options given to many of the file systems have changed, 128 and some of the file systems have changed names. IT IS IMPERATIVE THAT 129 YOU CHANGE ANY INSTANCES OF "ufs" IN /etc/fstab TO "ffs". To find out 130 more about different filesystem options, read the man page for the 131 associated mount command (e.g. mount_mfs(8) for MFS filesystems, note: 132 FFS type filesystems are documented in the mount(8) man page). If you 133 have not already done so, you may also need to correct /etc/fstab for 134 a shift in the partition numbering scheme. See step (4) above for more 135 details. 136 137 * You will also probably want to upgrade your device nodes at this time 138 as well. Make sure you have installed the latest MAKEDEV script (it 139 should be included in the etc set) and perform the following commands: 140 141 cd /dev 142 sh MAKEDEV all 143 144 1457) A number of binaries have changed their locations from NetBSD 1.2.1 to 146 NetBSD _VER (most of these have moved from /sbin to /usr/sbin). A few 147 binaries have been removed. It is probably best if you scan the 148 modification dates of the files in the /sbin directory. If there are 149 files in the directory which have newer counterparts in the /usr/sbin 150 directory, it is a very good idea to remove the older files (you will 151 probably run into difficulties later if you choose not to do this). 152 You should also check the /sbin, /bin, /usr/bin/, and /usr/sbin 153 directories for old binaries that are no longer part of the NetBSD 154 distribution and delete them as well. In general, all the files in a 155 particular distribution should have similar modification dates, so 156 looking at these is a good way of determining a file's age. 157 1588) Run 'fsck -f' to make sure that your filesystem is still consistent. If 159 fsck reports any errors, fix them by answering 'y' to its suggested 160 solutions (note: if there are a large number of errors, you may wish 161 to stop and run 'fsck -fy' to automatically answer "yes" instead). 162 1639) Exit from single-user mode and it should continue to boot into 164 multi-user mode. 165 166At this point you have successfully upgraded to NetBSD _VER. 167