.\"	$NetBSD: install,v 1.10 2008/04/30 13:10:48 martin Exp $
.\"
.\" Copyright (c) 1999-2002 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.
.\"
The miniroot's install program is very simple to use.
It will guide you through the entire process, and is well automated.
If you need to restart the installer, hit
.Key Control-C
which will return you to a shell prompt.
From there, just start it over:
.(disp
.No # Ic "./install"
.disp)
.Pp
The experimental RAM disk-based installer is not described here, but is
very self-explanatory.
.Pp
The miniroot's install program will:
.(enum
Allow you to place disklabels on additional disks.
Note that partition sizes and offsets are expressed in sectors.
When you fill out the disklabel, you will
need to specify partition types and file system parameters.
If you're unsure what these values should be, use the
following:
.(disp
fstype: 4.2BSD
fsize: 1024
bsize: 4096
cpg: 16
.disp)
.Pp
If the partition will be a swap partition, use the following:
.(disp
fstype: swap
fsize: 0 (or blank)
bsize: 0 (or blank)
cpg: 0 (or blank)
.disp)
.Pp
You will also need to specify the number of partitions.
The number of partitions is determined by the
.Sq index
of
the last partition letter, where
.Li a
=
.Li 1 ,
.Li b
=
.Li 2 ,
etc.
Therefore, if the last filled partition is partition
.Sq Li g ,
there are 7 partitions.
Any partitions with size of 0 may be removed from the list.
.Pp
Anything after a
.Sq Li #
is a comment.
.Pp
The following is an example disklabel partition map:
.(disp
7 partitions:
#      size   offset    fstype   [fsize bsize   cpg]
a:    30912      448    4.2BSD     1024  8192    16   # (Cyl.    1 - 69)
b:   130816    31360      swap                        # (Cyl.   70 - 361)
c:  1296512        0      boot                        # (Cyl.    0 - 2893)
e:    81984   162176    4.2BSD     1024  8192    16   # (Cyl.  362 - 544)
f:   102592   244160    4.2BSD     1024  4096    16   # (Cyl.  545 - 773)
g:   949760   346752    4.2BSD     1024  8192    16   # (Cyl.  774 - 2893)
.disp)
.Pp
.It
Create file systems on target partitions.
.Pp
.It
Allow you to set up your system's network configuration.
Remember to specify host names without the domain name
appended to the end.
For example use
.Li foo
instead of
.Li foo.bar.org .
If, during the process of configuring
the network interfaces, you make a mistake, you will
be able to re-configure that interface by simply selecting
it for configuration again.
.Pp
.It
Mount target file systems.
You will be given the opportunity to manually edit the resulting
.Pa /etc/fstab .
.Pp
.It
Extract binary sets from the media of your choice.
.Pp
.It
Copy configuration information gathered during the
installation process to your root file system
.Pq Pa / .
.Pp
.It
Make device nodes in your root file system under
.Pa /dev .
.Pp
.It
Copy a new kernel onto your root partition
.Pq Pa / .
.Pp
.It
Install a new boot block.
.Pp
.It
Check your file systems for integrity.
.enum)
.Pp
First-time installation on a system through a method other than the
installation program is possible, but strongly discouraged.
