255 lines
9.2 KiB
Plaintext
255 lines
9.2 KiB
Plaintext
.\" $NetBSD: install,v 1.20 1999/01/13 07:30:06 ross Exp $
|
|
.\"
|
|
.\" Copyright (c) 1999 The NetBSD Foundation, Inc.
|
|
.\" All rights reserved.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\" 3. All advertising materials mentioning features or use of this software
|
|
.\" must display the following acknowledgement:
|
|
.\" This product includes software developed by the NetBSD
|
|
.\" Foundation, Inc. and its contributors.
|
|
.\" 4. Neither the name of The NetBSD Foundation nor the names of its
|
|
.\" contributors may be used to endorse or promote products derived
|
|
.\" from this software without specific prior written permission.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
|
|
.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
|
|
.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
|
.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
|
|
.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
.\" POSSIBILITY OF SUCH DAMAGE.
|
|
.\"
|
|
The installation can be broken down into three basic steps:
|
|
.Pp
|
|
.Bl -bullet -compact
|
|
.It
|
|
Run Mkfs to build a filesystem or filesystems.
|
|
.It
|
|
Run the Installer to load the files onto your filesystems.
|
|
.It
|
|
Run the Booter to boot the system.
|
|
.El
|
|
.
|
|
.Ss2 Preparing the filesystem(s)
|
|
.
|
|
Double-click on the Mkfs application icon to start it up. It will ask you
|
|
for the SCSI ID of the drive that you are installing upon. Once this is
|
|
selected, it will present a list of the partitions on that disk. You must
|
|
first convert the partitions to a type which
|
|
.Nx
|
|
can understand. Select
|
|
each partition on which you wish to build a filesystem and click on the
|
|
"Change" button. If you are placing the entire installation on a single
|
|
partition, select the "NetBSD Root\*&Usr" radio button. If you are using
|
|
multiple partitions, select "NetBSD Root" for the root partition and
|
|
"NetBSD Usr" for all the other partitions. You should select "NetBSD Swap"
|
|
for the swap partition.
|
|
.Pp
|
|
When you have finished converting each partition, select each partition and
|
|
click on the "Format" button. You will now be asked for a bunch of
|
|
parameters for the hard drive and the filesystem. Usually, you can just
|
|
take the defaults. If you are installing onto removable media (e.g. a Zip,
|
|
Jaz, or Syquest), please see the FAQ. Note that although this dialog only
|
|
has the "OK" button, you are not committed, yet. Once you get the values
|
|
you want, press the "OK" button. A dialog will be presented at this point
|
|
with two options: "Format" and "Cancel." If you choose "Cancel," nothing
|
|
will be written to your drive. If you choose "Format," the program will
|
|
proceed to make a filesystem.
|
|
.Pp
|
|
Mkfs is not a well-behaved Macintosh application. It will not allow any
|
|
other tasks to run while it does (cooperative multitasking at its best).
|
|
When it's finished, the program will put up a dialog to ask if you have
|
|
scanned the output for any error messages. Usually there won't have been
|
|
any errors, but do scan the output to make sure. Simply click on the "I
|
|
Read It" button and the program will quit.
|
|
.Pp
|
|
Repeat as necessary for any extra partitions that you wish to make
|
|
filesystems on. Note that you do _not_ need a filesystem on your swap
|
|
partition.
|
|
.Pp
|
|
When you are finished, click on the "Done" button and choose "Quit" from
|
|
the "File" menu to exit Mkfs.
|
|
.
|
|
.Ss2 Installing the files
|
|
.
|
|
Before using the Installer, it is probably a good idea to increase its
|
|
memory allocation. Select the Installer icon by clicking on it and choose
|
|
"Get Info" from the File menu. Increase both the Minimum and Preferred
|
|
sizes to as much as you can spare.
|
|
.Pp
|
|
Double-click on the Installer icon to start it up. The Installer will
|
|
present the same SCSI ID menu that Mkfs did. Select the same SCSI ID that
|
|
you did for Mkfs--i.e., the one you are installing onto.
|
|
.Pp
|
|
If you are installing onto a single root partition, proceed to the
|
|
.Sx Installation\ of\ base\ files
|
|
section, below.
|
|
.Bl -item
|
|
.It
|
|
If you have not created filesystems for the root, usr, and
|
|
any other filesystems, go back to "Preparing the filesystem(s),"
|
|
above.
|
|
.It
|
|
When you started the Installer, it mounted your root partition.
|
|
Just before it printed, "Mounting partition 'A' as /," it printed
|
|
lines like:
|
|
.Dl sd1 at scsi ID 5.
|
|
This means that the device for scsi ID 5 is sd1. The partitions
|
|
are signified by a trailing letter. For instance, sd1a would be
|
|
the root partition of the second scsi disk in the chain, and sd0g
|
|
would be the first Usr partition on the first scsi disk.
|
|
.It
|
|
You will need to know the proper device to mount the remaining
|
|
partition(s) by hand:
|
|
.Bl -bullet
|
|
.It
|
|
Select "Build Devices" from the "File" menu.
|
|
|
|
.It
|
|
Select "Mini Shell" from the "File" menu.
|
|
|
|
.It
|
|
You can use the 'disklabel' command to get a listing of
|
|
the available partitions and their types and sizes.
|
|
|
|
.It
|
|
Create the directory mount point(s) with the command:
|
|
.Dl mkdir path
|
|
(e.g. for the
|
|
.Pa /usr
|
|
partition type:
|
|
.Ic mkdir /usr )
|
|
|
|
.It
|
|
Mount the filesystems you wish with the command:
|
|
.Dl mount device path
|
|
For example, if you wish to mount a usr partition from
|
|
the first scsi disk, sd0, on
|
|
.Pa /usr , No you would type:
|
|
.Dl mount /dev/sd0g /usr
|
|
.It
|
|
.No Type Ic fstab force
|
|
.No to create a proper Pa /etc/fstab
|
|
file.
|
|
.It
|
|
Type
|
|
.Ic quit
|
|
after you have mounted all the filesystems.
|
|
.El
|
|
.El
|
|
.
|
|
.Ss2 Installation of base files:
|
|
.
|
|
.Bl -item
|
|
.It
|
|
Select the
|
|
.Ic Install
|
|
menu item from the
|
|
.Ic File
|
|
menu and install
|
|
.Pa base.tgz , etc.tgz , netbsd.tgz ,
|
|
and any other sets you wish to
|
|
install at this time. (See the contents section for information
|
|
about what's in each set.) The Installer will print out the
|
|
filename of each file as it is installed, and will take quite some
|
|
time to install everything (the base package alone can take over an
|
|
hour on a slow hard drive).
|
|
.It
|
|
As is the case with Mkfs, this is not a particularly well-behaved
|
|
Macintosh application and the machine will be completely tied up
|
|
while the installation takes place.
|
|
.It
|
|
At some point after installing the base set, select the
|
|
.Ic Build Devices
|
|
option from the
|
|
.Ic File
|
|
menu if you have not already done
|
|
so. This will create a bunch of device nodes for you and will
|
|
create your initial
|
|
.Pa /etc/fstab .
|
|
The Installer program also has an
|
|
option to give you a mini-shell. Do not use this unless you are
|
|
sure know what you are doing.
|
|
.It
|
|
When you are finished installing all of the sets you wish to
|
|
install, exit the Installer by choosing
|
|
.Ic Quit No from the Ic File
|
|
.No menu.
|
|
.El
|
|
.
|
|
.Ss2 Booting the system
|
|
.
|
|
Prior to attempting to boot NetBSD/mac68k, please verify that all of
|
|
the following are true:
|
|
.Bl -enum
|
|
.It
|
|
32-bit addressing is enabled[*] in the Memory control panel;
|
|
.It
|
|
All forms of virtual memory are disabled (the Memory control
|
|
panel, RAM Doubler, or other software-based memory enhancement
|
|
products); and
|
|
.It
|
|
Your system is in B\*&W mode (1-bit color or grayscale) as shown
|
|
by the Monitors control panel. You may choose to have the
|
|
Booter do this for you automatically by selecting the appropriate
|
|
check box and radio button in the
|
|
.Ic Monitors No dialog on the
|
|
.Ic Options No menu .
|
|
.El
|
|
.Pp
|
|
It is probably best to boot your machine with all extensions turned
|
|
off[*]. You can do this by booting into MacOS with the
|
|
.Tn SHIFT No key held
|
|
down. You may have to restart your Macintosh for changes to take effect
|
|
before proceeding.
|
|
.(tag Em [*]Note:
|
|
If you have an older II-class system (including the II, IIx, IIcx,
|
|
and SE/30), it is necessary to install Connectix's MODE32 to work around
|
|
ROM issues which prevent you from enabling 32-bit addressing. Please see
|
|
.if !dHTML .br
|
|
.Lk http://www.netbsd.org/Ports/mac68k/faq/ the\ FAQ
|
|
.if !dHTML .br
|
|
for more information.
|
|
.tag)
|
|
.Pp
|
|
Double-click on the NetBSD/mac68k Booter icon to start the application.
|
|
Select
|
|
.Ic Booting
|
|
from the
|
|
.Ic Options
|
|
menu. Check that all of the items in
|
|
the resulting dialog look sane--especially the SCSI ID. If not, correct
|
|
them to your preference (the SCSI ID should be the only thing you need to
|
|
change). When you are satisfied with your choices, try booting
|
|
.Nx
|
|
by selecting
|
|
.Ic Boot Now No from the
|
|
.Ic Options No menu.
|
|
.Pp
|
|
If you wish to save your preferences, choose
|
|
.Ic Save Options
|
|
from the
|
|
.Ic File
|
|
menu before Booting (your preferences will not be saved if you
|
|
forget to do this).
|
|
.Pp
|
|
If the system does not come up, send mail to
|
|
.Mt port-mac68k@netbsd.org
|
|
describing your software, your hardware, and as complete a description of
|
|
the problem as you can.
|
|
.Pp
|
|
If the system does come up, congratulations, you have successfully installed
|
|
.Nx \*V .
|