xref: /netbsd-src/distrib/notes/mac68k/install (revision f6a72fb05adb9a3452c3f49ea3789b75b74d564d)
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	base12, 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
90Prior to attempting to boot NetBSD/mac68k, please verify that all of
91the following are true:
92
93	1) 32-bit addressing is enabled[*] in the Memory control panel;
94
95	2) All forms of virtual memory are disabled (the Memory control
96	   panel, RAM Doubler, or other software-based memory enhancement
97	   products); and
98
99	3) Your system is in B&W mode (1-bit color or grayscale) as shown
100	   by the Monitors control panel.
101
102You may have to restart your Macintosh for changes to take effect before
103proceding.
104
105[* NOTE:  If you have an older II-class system (including the II, the IIx,
106and the IIcx), it is necessary to install Connectix's MODE32 to work around
107ROM issues which prevent you from enabling 32-bit addressing.  Please see
108<http://www.netbsd.org/Ports/mac68k/faq/faq.html> for more information.]
109
110Double-click on the NetBSD/mac68k Booter icon to start the application.
111Check that the options in the Booting dialog look sane -- especially the
112SCSI ID.  If not, correct them to your preference.  When you are satisfied
113with your choices, try booting NetBSD.
114
115If you wish to save your preferences, choose the "Save Preferences"
116option in the "File" menu, then quit the application and restart.  Due
117to a long-standing bug, the preferences will not be saved unless you
118quit.
119
120If the system does not come up, send mail to port-mac68k@NetBSD.ORG
121describing your software, your hardware, and as complete a description
122of the problem as you can.  You might also consider subscribing to the
123port-mac68k mailing list, since there may already be others who have
124successfully identified and resolved the problem you're seeing.
125
126If the system does come up, congratulations!  You have successfully
127installed NetBSD 1.2.  When you reboot into NetBSD, you should log
128in as "root" at the login prompt.  There is no initial password, but
129if you're using the machine in a networked environment, you should
130create yourself an account and protect it and the "root" account with
131good passwords.
132
133Some of the files in the NetBSD 1.2 distribution might need to be
134tailored for your site.  In particular, the /etc/sendmail.cf file will
135almost definitely need to be adjusted, and other files in /etc will
136probably need to be modified, as well.  If you are unfamiliar with
137UN*X-like system administration, it's recommended that you buy a book
138that discusses it.
139