Home | History | Annotate | Line # | Download | only in mac68k
install revision 1.11
      1 The installation can be broken down into three basic steps:
      2 	* Run Mkfs to build a filesystem or filesystems.
      3 	* Run the Installer to load the files onto your filesystems.
      4 	* Run the Booter to boot the system.
      5 
      6 **** Preparing the filesystem(s)
      7 
      8 Double-click on the Mkfs application icon to start it up.  It will ask you
      9 for the SCSI ID of the drive that you are installing upon.  Once this is
     10 selected, it will present a list of the partitions on that disk. You must
     11 first convert the partitions to a type which NetBSD can understand. Select
     12 each partition on which you wish to build a filesystem and click on the
     13 "Change" button.  If you are placing the entire installation on a single
     14 partition, select the "NetBSD Root&Usr" radio button.  If you are using
     15 multiple partitions, select "NetBSD Root" for the root partition and
     16 "NetBSD Usr" for all the other partitions.  You should select "NetBSD Swap"
     17 for the swap partition. 
     18 
     19 When you have finished converting each partition, select each partition and
     20 click on the "Format" button.  You will now be asked for a bunch of
     21 parameters for the hard drive and the filesystem.  Usually, you can just
     22 take the defaults.  If you are installing onto removable media (e.g. a Zip,
     23 Jaz, or Syquest), please see the FAQ.  Note that although this dialog only
     24 has the "OK" button, you are not committed, yet.  Once you get the values
     25 you want, press the "OK" button. A dialog will be presented at this point
     26 with two options: "Format" and "Cancel."  If you choose "Cancel," nothing
     27 will be written to your drive.  If you choose "Format," the program will
     28 proceed to make a filesystem.
     29 
     30 Mkfs is not a well-behaved Macintosh application.  It will not allow any
     31 other tasks to run while it does (cooperative multitasking at its best).
     32 When it's finished, the program will put up a dialog to ask if you have
     33 scanned the output for any error messages.  Usually there won't have been
     34 any errors, but do scan the output to make sure.  Simply click on the "I
     35 Read It" button and the program will quit.
     36 
     37 Repeat as necessary for any extra partitions that you wish to make
     38 filesystems on.  Note that you do _not_ need a filesystem on your swap
     39 partition.
     40 
     41 When you are finished, click on the "Done" button and choose "Quit" from
     42 the "File" menu to exit Mkfs.
     43 
     44 **** Installing the files
     45 
     46 Before using the Installer, it is probably a good idea to increase its
     47 memory allocation.  Select the Installer icon by clicking on it and choose
     48 "Get Info" from the File menu.  Increase both the Minimum and Preferred
     49 sizes to as much as you can spare.
     50 
     51 Double-click on the Installer icon to start it up.  The Installer will
     52 present the same SCSI ID menu that Mkfs did.  Select the same SCSI ID that
     53 you did for Mkfs--i.e., the one you are installing onto. 
     54 
     55 If you are installing onto a single root partition, proceed to the
     56 "Installation of base files" section, below.
     57 
     58 	If you have not created filesystems for the root, usr, and
     59 	any other filesystems, go back to "Preparing the filesystem(s),"
     60 	above.
     61 
     62 	When you started the Installer, it mounted your root partition.
     63 	Just before it printed, "Mounting partition 'A' as /," it printed
     64 	lines like:
     65 		sd1 at scsi ID 5.
     66 	This means that the device for scsi ID 5 is sd1.  The partitions
     67 	are signified by a trailing letter.  For instance, sd1a would be
     68 	the root partition of the second scsi disk in the chain, and sd0g
     69 	would be the first Usr partition on the first scsi disk.
     70 
     71 	You will need to know the proper device to mount the remaining
     72 	partition(s) by hand:
     73 
     74 		* Select "Build Devices" from the "File" menu.
     75 
     76 		* Select "Mini Shell" from the "File" menu.
     77 
     78 		* You can use the 'disklabel' command to get a listing of
     79 		  the available partitions and their types and sizes.
     80 
     81 		* Mount the filesystems you wish with the command:
     82 			mount device path
     83 		  For example, if you wish to mount a usr partition from
     84 		  the first scsi disk, sd0, on /usr, you would type:
     85 			mount /dev/sd0g /usr
     86 
     87 		* Type "fstab force" to create a proper /etc/fstab file
     88 
     89 		* Type "quit" after you have mounted all the filesystems.
     90 
     91 Installation of base files:
     92 
     93 	Select the "Install" menu item from the "File" menu and install
     94 	base.tgz, etc.tgz, netbsd.tgz, and any other sets you wish to
     95 	install	at this time (see the contents section for information
     96 	about what's in each set).  The Installer will print out the
     97 	filename of each file as it is installed, and will take quite some 
     98 	time to install everything (the base package alone can take over an
     99 	hour on a slow hard drive).
    100 
    101 	As is the case with Mkfs, this is not a particularly well-behaved
    102 	Macintosh application and the machine will be completely tied up
    103 	while the installation takes place.
    104 
    105 	At some point after installing the base set, select the "Build
    106 	Devices" option from the "File" menu if you have not already done
    107 	so.  This will create a bunch of device nodes for you and will
    108 	create your initial /etc/fstab.  The Installer program also has an
    109 	option to give you a mini-shell.  Do not use this unless you are
    110 	sure know what you are doing.
    111 
    112 	When you are finished installing all of the sets you wish to
    113 	install, exit the Installer by choosing "Quit" from the "File" menu.
    114 	
    115 **** Booting the system
    116 
    117 Prior to attempting to boot NetBSD/mac68k, please verify that all of
    118 the following are true:
    119 
    120 	1) 32-bit addressing is enabled[*] in the Memory control panel;
    121 
    122 	2) All forms of virtual memory are disabled (the Memory control
    123 	   panel, RAM Doubler, or other software-based memory enhancement
    124 	   products); and
    125 
    126 	3) Your system is in B&W mode (1-bit color or grayscale) as shown
    127 	   by the Monitors control panel.  You may choose to have the 
    128 	   Booter do this for you automatically by selecting the appropriate
    129 	   check box and radio button in the "Monitors" dialog on the
    130 	   "Options" menu.
    131 
    132 It is probably best to boot your machine with all extensions turned
    133 off[*].  You can do this by booting into MacOS with the SHIFT key held
    134 down.  You may have to restart your Macintosh for changes to take effect
    135 before proceeding.  
    136 
    137 [* NOTE:  If you have an older II-class system (including the II, IIx, IIcx,
    138 and SE/30), it is necessary to install Connectix's MODE32 to work around
    139 ROM issues which prevent you from enabling 32-bit addressing.  Please see
    140 <http://www.netbsd.org/Ports/mac68k/faq/> for more information.]
    141 
    142 Double-click on the NetBSD/mac68k Booter icon to start the application.
    143 Select "Booting" from the "Options" menu.  Check that all of the items in
    144 the resulting dialog look sane--especially the SCSI ID.  If not, correct
    145 them to your preference (the SCSI ID should be the only thing you need to
    146 change).  When you are satisfied with your choices, try booting NetBSD by
    147 selecting "Boot Now" from the "Options" menu.
    148 
    149 If you wish to save your preferences, choose "Save Options" from the
    150 "File" menu before Booting (your preferences will not be saved if you
    151 forget to do this).
    152 
    153 If the system does not come up, send mail to scottr (a] netbsd.org describing
    154 your software, your hardware, and as complete a description of the
    155 problem as you can.
    156 
    157 If the system does come up, congratulations, you have successfully
    158 installed NetBSD _VER.  When you first boot into NetBSD, it will
    159 automatically drop you into single-user mode with the root filesystem
    160 mounted read-write.  The system will ask you to choose a shell.  Simply hit
    161 return to get to a prompt.  If you are asked for a terminal type, respond
    162 with 'vt220' and hit return.  At this point, you need to configure at least
    163 one file in the /etc directory.  Change to the /etc directory and take a
    164 look at the /etc/rc.conf file.  Modify it to your tastes, making sure that
    165 you set "rc_configured=YES" so that your changes will be enabled and a
    166 multi-user boot can proceed.  If your /usr directory is on a separate
    167 partition and you do not know how to use 'ed' or 'ex', you will have to
    168 mount your /usr partition to gain access to 'vi'.  Do the following:
    169 
    170 mount /usr
    171 export TERM=vt220
    172 
    173 You can then edit /etc/rc.conf with 'vi'.  When you have finished, type
    174 'exit' at the prompt to leave the single-user shell and continue with the
    175 multi-user boot.  You should log in as "root" at the login prompt.  There
    176 is no initial password, but if you're using the machine in a networked
    177 environment, you should create yourself an account and protect it and the
    178 "root" account with good passwords.  Please see the adduser(8) man page for
    179 more information on how to add a new user. 
    180 
    181 Some of the files in the NetBSD _VER distribution might need to be
    182 tailored for your site.  In particular, the /etc/resolv.conf file will
    183 almost definitely need to be adjusted, and other files in /etc will
    184 probably need to be modified, as well.  In particular, you will want to
    185 take a look at /etc/rc.conf and modify it to your tastes.  Make sure
    186 that you set "rc_configured=YES" so that your changes will be enabled.
    187 If you are unfamiliar with UN*X-like system administration, it's
    188 recommended that you buy a book that discusses it.
    189