install revision 1.3
1The installation can be broken down into three basic steps: 2 * Run Mkfs to build a filesystem or filesystems. 3 * Run Install Utility to load the files onto your filesystems. 4 * Run the booter to boot the system. 5 6**** Preparing the filesystem(s) 7 8Double-click on the Mkfs application icon to start it up. It will ask 9you for the SCSI ID of the drive that you are installing upon. Once 10this is selected, it will present a list of the partitions on that disk. 11Select the partition on which you wish to build a filesystem and click 12on the "Format" button. You will now be asked for a bunch of parameters 13for the hard drive and the filesystem. Usually, you can just take the 14defaults. If you are installing onto a Syquest, please see the FAQ. 15Note that although this dialog only has the "OK" button, you are not 16committed, yet. Once you get the values you want, press the "OK" button. 17A dialog will be presented at this point with two options: "Format" and 18"Cancel." If you choose "Cancel," nothing will be written to your drive. 19If you choose "Format," the program will proceed to make a filesystem. 20 21Mkfs is not a well-behaved Macintosh application. It will not allow 22any other tasks to run while it does (cooperative multitasking at its 23best). When it's finished, the program will put up a dialog to ask if 24you have scanned the output for any error messages. Usually there won't 25have been any errors, but do scan the output to make sure. Simply click 26on the "I Read It" button and the program will quit. 27 28Repeat as necessary for any extra partitions that you wish to make 29filesystems on. Note that you do _not_ need a filesystem on your swap 30partition. 31 32**** Installing the files 33 34Double-click on the Install Utility icon to start it up. The installer 35will present the same SCSI ID menu that mkfs did. Select the same SCSI 36ID that you did for mkfs--i.e., the one you are installing onto. 37 38If you are installing onto a single root partition, proceed to the 39"Installation of base files" section, below. 40 41 If you have not created filesystems for the root, usr, and 42 any other filesystems, go back to "Preparing the filesystem(s)," 43 above. 44 45 When you started the installer, it mounted your root partition. 46 Just before it printed, "Mounting partition 'A' as /," it printed 47 lines like: 48 sd1 at scsi ID 5. 49 This means that the device for scsi ID 5 is sd1. The partitions 50 are signified by a trailing letter. For instance, sd1a would be 51 the root partition of the second scsi disk in the chain, and sd0g 52 would be the first usr partition on the first scsi disk. 53 54 You will need to know the proper device to mount the remaining 55 partition(s) by hand: 56 57 * Select "Build Devices" from the "File" menu. 58 59 * Select "Mini Shell" from the "File" menu. 60 61 * Mount the filesystems you wish with the command: 62 mount device path 63 For example, if you wish to mount a usr partition from 64 the first scsi disk, sd0, on /usr, you would type: 65 mount /dev/sd0g /usr 66 67 * Type "quit" after you have mounted all the filesystems. 68 69Installation of base files: 70 71 Select the "Install" menu item from the "File" menu and install 72 base11, netbsd, and any other packages you wish to install at 73 this time (see the contents section for information about what's 74 in each package). The installer will print out the filename of 75 each file as it is installed, and will take quite some time to 76 install everything. 77 78 As is the case with Mkfs, this is not a particularly well-behaved 79 Macintosh application and the machine will be completely tied up 80 while the installation takes place. 81 82 At some point after installing the base package, select the "Build 83 Devices" option from the "File" menu. This will create a bunch of 84 device nodes for you and will create your initial /etc/fstab. The 85 installer program also has an option to give you a mini-shell. Do 86 not use this unless you know what you are doing. 87 88**** Booting the system 89 90Double-click on the MacBSD Booter icon to start the application. Check 91that the options in the Booting dialog look sane--especially the SCSI ID. 92If not, correct them to your preference. When you are satisfied with 93your choices, try booting NetBSD. 94 95If you wish to save your preferences, choose the "Save Preferences" 96option in the "File" menu, then quit the application and restart. Due 97to a long-standing bug, the preferences will not be saved unless you 98quit. 99 100If the system does not come up: 101 * Check the "diagnostic gray bars" check-box. 102 * Count the number of "gray bars" you see. 103 * Send mail to alice@cray-ymp.acm.stuorg.vt.edu describing 104 your software, your hardware, and the number of bars that 105 you saw. 106 107If the system does come up, congratulations, you have successfully 108installed NetBSD 1.2. When you reboot into NetBSD, you should log 109in as "root" at the login prompt. There is no initial password, but 110if you're using the machine in a networked environment, you should 111create yourself an account and protect it and the "root" account with 112good passwords. 113 114Some of the files in the NetBSD 1.2 distribution might need to be 115tailored for your site. In particular, the /etc/sendmail.cf file will 116almost definitely need to be adjusted, and other files in /etc will 117probably need to be modified, as well. If you are unfamiliar with 118UN*X-like system administration, it's recommended that you buy a book 119that discusses it. 120