334 lines
9.7 KiB
Plaintext
334 lines
9.7 KiB
Plaintext
.\" $NetBSD: install,v 1.31 2019/11/21 19:23:19 martin Exp $
|
|
.\"
|
|
.\" Copyright (c) 1999, 2000 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.
|
|
.\"
|
|
.\" 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.
|
|
.\"
|
|
.
|
|
.so ../common/sysinst --------------------------------------------
|
|
.br_ne 7P
|
|
.
|
|
.Ss "Installing the NetBSD System (Traditional Method)"
|
|
The Traditional method of
|
|
installation can be broken down into three basic steps:
|
|
.Pp
|
|
.(bullet -compact
|
|
Run Mkfs to build a file system or file systems.
|
|
.It
|
|
Run the Installer to load the files onto your file systems.
|
|
.It
|
|
Run the Booter to boot the system.
|
|
.bullet)
|
|
.
|
|
.Ss2 Preparing the file system(s)
|
|
.
|
|
Double-click on the Mkfs application icon to start it up. It will ask you
|
|
for the SCSI-ID (SCSI target number) of the drive that you are installing
|
|
.Nx
|
|
on. 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 file system and click on the
|
|
.Ic Change
|
|
button. If you are placing the entire installation on a single
|
|
partition, select the
|
|
.Ic NetBSD Root\*[Am]Usr
|
|
radio button. If you are using
|
|
multiple partitions, select
|
|
.Ic NetBSD Root
|
|
for the root partition
|
|
.Pq Pa /
|
|
and
|
|
.Ic NetBSD Usr
|
|
for all the other partitions. You should select
|
|
.Ic NetBSD Swap
|
|
for the swap partition.
|
|
.Pp
|
|
When you have finished converting each partition, select each partition and
|
|
click on the
|
|
.Ic Format
|
|
button. You will now be asked for a bunch of
|
|
parameters for the hard drive and the file system. 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
|
|
.Ic OK
|
|
button, you are not committed, yet. Once you get the values
|
|
you want, press the
|
|
.Ic OK
|
|
button. A dialog will be presented at this point
|
|
with two options:
|
|
.Ic Format
|
|
and
|
|
.Ic Cancel .
|
|
If you choose
|
|
.Ic Cancel ,
|
|
nothing will be written to your drive. If you choose
|
|
.Ic Format ,
|
|
the program will
|
|
proceed to make a file system.
|
|
.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
|
|
.Ic "I Read It"
|
|
button and the program will quit.
|
|
.Pp
|
|
Repeat as necessary for any extra partitions that you wish to make
|
|
file systems on. Note that you do
|
|
.Em not
|
|
need a file system on your swap partition.
|
|
.Pp
|
|
When you are finished, click on the
|
|
.Ic Done
|
|
button and choose
|
|
.Ic Quit
|
|
from the
|
|
.Ic 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
|
|
.Ic 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
|
|
(SCSI target number) that
|
|
you did for Mkfs - i.e., the one you are installing
|
|
.Nx
|
|
on.
|
|
.Pp
|
|
If you are installing onto a single root partition
|
|
.Pq Pa / ,
|
|
proceed to the
|
|
.Sx Installation\ of\ base\ files
|
|
section, below.
|
|
.Pp
|
|
If you have not created file systems for
|
|
.Pa /
|
|
(root),
|
|
.Pa usr ,
|
|
and any other file systems, go back to
|
|
.Sx Preparing the file system(s)
|
|
above.
|
|
.Pp
|
|
When you started the Installer, it mounted your root partition
|
|
.Pq Pa / .
|
|
Just before it printed
|
|
.Pp
|
|
.Dl "Mounting partition 'A' as /"
|
|
.Pp
|
|
it printed lines like:
|
|
.Pp
|
|
.Dl "sd1 at scsi ID 5"
|
|
.Pp
|
|
This means that the device for SCSI target 5 ("SCSI ID 5") is
|
|
.Li sd1 .
|
|
The partitions
|
|
are signified by a trailing letter. For instance,
|
|
.Li sd1a
|
|
would be
|
|
the root partition
|
|
.Pq Pa /
|
|
of the second SCSI disk in the chain, and
|
|
.Li sd0g
|
|
would be the first Usr partition on the first SCSI disk.
|
|
.Pp
|
|
You will need to know the proper device to mount the remaining
|
|
partition(s) by hand:
|
|
.(enum -offset indent
|
|
Select
|
|
.Ic Build Devices
|
|
from the
|
|
.Ic File
|
|
menu.
|
|
.It
|
|
Select
|
|
.Ic Mini Shell
|
|
from the
|
|
.Ic File
|
|
menu.
|
|
.It
|
|
You can use the
|
|
.Ic 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:
|
|
.Pp
|
|
.Dl # Ic "mkdir path"
|
|
.Pp
|
|
E.g. for the
|
|
.Pa /usr
|
|
partition type:
|
|
.Pp
|
|
.Dl # Ic "mkdir /usr"
|
|
.It
|
|
Mount the file systems you wish with the command:
|
|
.Pp
|
|
.Dl # Ic "mount device path"
|
|
For example, if you wish to mount a
|
|
.Pa /usr
|
|
partition from the first SCSI disk
|
|
.Li sd0 ,
|
|
on
|
|
.Pa /usr , No you would type:
|
|
.Pp
|
|
.Dl # Ic "mount /dev/sd0g /usr"
|
|
.It
|
|
Type
|
|
.Dl # Ic "fstab force"
|
|
to create a proper
|
|
.Pa /etc/fstab
|
|
file.
|
|
.It
|
|
Type
|
|
.Ic quit
|
|
after you have mounted all the file systems.
|
|
.bullet)
|
|
.
|
|
.Ss2 Installation of base files
|
|
.
|
|
Select the
|
|
.Ic Install
|
|
menu item from the
|
|
.Ic File
|
|
menu and install
|
|
.Pa base.\*[setsuffix] , etc.\*[setsuffix] , either kern-GENERIC.\*[setsuffix] or kern-GENERICSBC.\*[setsuffix] ,
|
|
and any other sets you wish to
|
|
install at this time (see the
|
|
.Sx NetBSD\ \*V\ Release\ Contents
|
|
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 two
|
|
hours on a slow hard drive).
|
|
.Pp
|
|
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.
|
|
.Pp
|
|
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.
|
|
.Pp
|
|
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.
|
|
.
|
|
.Ss2 Booting the system
|
|
.
|
|
Prior to attempting to boot
|
|
.Nx*M ,
|
|
please verify that all of
|
|
the following are true:
|
|
.(enum
|
|
32-bit addressing is enabled [2] 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\*[Am]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 .
|
|
.enum)
|
|
.Pp
|
|
It is probably best to boot your machine with all extensions turned
|
|
off [2]. You can do this by booting into
|
|
.Tn Mac OS
|
|
with the SHIFT key held
|
|
down. You may have to restart your Macintosh for changes to take effect
|
|
before proceeding.
|
|
.(tag [2]
|
|
.It [2]
|
|
If your version of the Memory control panel does not have a 32-bit
|
|
addressing mode radio button, this means that your system is already
|
|
32-bit clean and is running in 32-bit addressing mode by default. If the
|
|
Booter complains that you are not in 32-bit mode, it may be necessary
|
|
for you to press the
|
|
.Ic Use Defaults
|
|
button in the Memory control panel to
|
|
restore 32-bit addressing. You should probably reboot after doing so.
|
|
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 the
|
|
.Nx*M
|
|
FAQ at
|
|
.Lk http://www.NetBSD.org/ports/\*M/faq/
|
|
for more information.
|
|
.tag)
|
|
.Pp
|
|
Double-click on the
|
|
.Nx*M
|
|
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 target number.
|
|
If not, correct
|
|
them to your preference (the SCSI target number, or "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-\*M@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 .
|