.\"	$NetBSD: install,v 1.52.4.2 2008/09/15 08:09:57 skrll 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.
.\" 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.
.\"
.
Installing
.Nx
is a relatively complex process, but if you have
this document in hand it shouldn't be too much trouble.
.Pp
There are several ways to install
.Nx
onto your system.
The easiest way is to use the
.Pa miniroot.fs
image copied to your local disk's swap partition or a scratch drive.
If your Sparc is hooked up in a network, you may configure another
.Ul
machine as a netboot server for your Sparc.
Alternatively, there is a pair
of floppy images that will boot your system and run the installer.
.Pp
For more information on the commands and variables available in
the OpenBoot PROM (present in all sun4c and sun4m machines), go to
.Lk http://docs.sun.com
and search for
.Dq openboot reference
(without quotes).
.
.Ss2 Installing NetBSD by placing a bootable file system on a partitioned hard drive
.
.Pa installation/miniroot/miniroot.fs.gz
is a compressed, self-contained
.Nx
file system holding all utilities necessary to install
.Nx
onto a disk attached to your system.
It is distributed as a compressed plain
file you will transfer to a raw disk partition.
You will then boot this installer using the appropriate PROM command.
The simplest case is where you place the
.Pa miniroot.fs
file system on the swap partition of your disk.
Alternatively, you can place
it on any other unused partition on any disk (such as a Zip disk).
Be forewarned that you will not be able to install
.Nx
onto the partition that contains the
.Pa miniroot.fs
as this partition is needed during the install process.
.Pp
Loading the file system onto a raw partition is straightforward.
First, download
.Pa miniroot.fs
to your system.
Next, reboot in single-user mode (i.e.
.Ic "boot -s" )
to ensure that your system will not be swapping.
Finally, place the
.Pa miniroot.fs
on your partition of choice.
On
.Nx
or SunOS the commands are:
.Pp
.(disp
.No # Ic "gunzip miniroot.fs.gz"
.No # Ic "dd if=miniroot.fs of=/dev/rsd0b bs=4k"
.disp)
.Pp
Here,
.Li /dev/rsd0b
is assumed to be your swap partition.
If you decide to place
.Pa miniroot.fs
on a non-swap partition, it will overwrite all of the contents of that
partition, but you will not need to reboot into single-user mode to write it.
.Pp
After transferring the file system to disk, bring the system down by:
.Pp
.(disp
.No # Ic halt
.disp)
.Pp
Then boot the installer by typing the appropriate
command at the PROM prompt (this example is for the swap partition):
.Pp
.(tag OpenBoot\ PROM\ 2 -offset indent -compact
.It sunmon
.(disp
.No \*[Gt] Ic "b sd(,,1)netbsd -s"
.disp)
.It OpenBoot PROM 1
.(disp
.No ok Ic "boot sd(,,1)netbsd -s"
.disp)
.It OpenBoot PROM 2
.(disp
.No ok Ic "boot disk:b netbsd -s"
.disp)
.tag)
.Pp
The monitor boot command will load the
.Nx
kernel contained in the
file system image.
After the initial probe messages you'll be
asked to start the install or upgrade procedure.
Proceed to the section
.Sx Running the installation scripts.
below.
.
.Ss2 Installing NetBSD by using a bootable CD-ROM
.
If you wish to burn a CD-R containing a bootable NetBSD installation,
then you can either burn the prepared disk image in
.Pa installation/cdrom/sparccd-\*V.iso
or create your own.
If you wish to create your own, you should follow the directions on the
.Nx
Bootable CD-ROM HOW-TO at:
.Lk http://www.NetBSD.org/docs/bootcd.html#sparcimage
.Pp
Once you have downloaded
.Pa sparccd-\*V.iso
or created your own disk image, then you need to burn it to a CD-R.
.Pp
The CD-ROM attached to your Sparc must support 512 byte sectors to be
bootable.
All Sun brand CD-ROMs will work, as well as many other manufacturers.
See the Sun CD-ROM FAQ:
.Lk http://saturn.tlug.org/suncdfaq/
.Pp
Sun sets their CD-ROM drives to SCSI ID 6.
We recommend you do the same.
.Pp
Boot the installer by typing the appropriate command at the PROM prompt:
.Pp
.(tag OpenBoot\ PROM\ 2 -offset indent -compact
.It sunmon
.(disp
.No \*[Gt] Ic b "sd(,30,)"
.disp)
.It OpenBoot PROM 1
.(disp
.No ok Ic "boot sd(,30,)"
.disp)
.It OpenBoot PROM 2
.(disp
.No ok Ic "boot cdrom"
.disp)
.tag)
.Pp
After the initial probe messages you'll be asked to start the
install or upgrade procedure.
Proceed to the section
.Sx Running the installation scripts.
below.
.
.Ss2 Installing NetBSD by using the bootable floppies
.
The
.Nx
install floppies only work on the sun4c and sun4m machines.
Making the install floppies is fairly straightforward.
.Pp
.Nx
and SunOS use the same commands.
First, get two 1.44 MB floppy disks and format them either using the
.Xr fdformat 8
command or a PC.
.Pp
.(disp
.No # Ic "fdformat"
.disp)
.Pp
Be sure that the `fdformat' command completes successfully before proceeding;
on
.Nx
success is a string of all
.Sq Li V 's ,
and on
.Tn SunOS
success is a string of
.Sq Li \&. 's .
.Pp
Next, transfer the two floppy images
.Pq Pa installation/floppy/disk1.gz No and Pa installation/floppy/disk2
to the disks you just formatted.
You can do this step from
.Nx ,
.Tn SunOS ,
or a
.Tn Windows
machine using
.Nm rawrite.exe
(available in the
.Nx Ns / Ns i386
distribution).
Insert the first floppy and run the following commands:
.Pp
.(disp
.No # Ic "gunzip disk1.gz"
.No # Ic "dd if=disk1 of=/dev/rfd0a bs=36k"
.No # Ic "eject floppy"
.disp)
.Pp
Insert the second floppy and run the following commands:
.Pp
.(disp
.No # Ic "dd if=disk2 of=/dev/rfd0a bs=36k"
.No # Ic "eject floppy"
.disp)
.Pp
Note that disk2 may be a symlink to .tgz file; do not uncompress it,
just follow the instructions above, verbatim.
After writing the two floppies,
be sure to label them so you can later identify them.
.Pp
Insert the floppy made from
.Pa disk1
into your Sparc.
From the OpenBoot prompt, boot the floppy with the following command:
.Pp
.(tag OpenBoot\ PROM\ 2\ (alternate) -offset indent -compact
.It OpenBoot PROM 1
.(disp
.No ok Ic "boot fd(,,1)"
.disp)
.It OpenBoot PROM 1 (alternate)
.(disp
.No ok Ic "boot /fd"
.disp)
.It OpenBoot PROM 2
.(disp
.No ok Ic "boot floppy"
.disp)
.tag)
.Pp
After the initial probe messages you'll be asked to insert the floppy
labeled
.Dq NetBSD disk2 .
If the floppy is not automatically ejected, you can either use a
straightened paperclip to eject the disk or do the following:
.Pp
Press the
.Key STOP
key (sometimes called the
.Key L1
key, found on the left side of your keyboard) and the
.Key a
key, which will halt your system and give you a PROM prompt.
.(disp
.No ok Ic "eject"
.No ok Ic "go"
.disp)
.Pp
Now, insert the floppy labeled
.Li disk2 .
After the installation tools have been loaded,
you'll be asked to start the install or upgrade procedure.
Proceed to the section
.Sx Running the installation scripts.
below.
.
.Ss2 Installing NetBSD by using a netboot setup
.
.so ../common/netboot
.Pp
Now, netboot your Sparc from the server by entering the appropriate
.Ic boot
command at the monitor prompt.
Depending on the PROM version in your machine, this command takes one
of the following forms:
.(tag OpenBoot\ PROM\ 2 -offset indent -compact
.It sunmon
.(disp
.No \*[Gt] Ic "b le()netbsd"
.disp)
.It OpenBoot PROM 1
.(disp
.No ok Ic "b le()netbsd"
.disp)
.It OpenBoot PROM 2
.(disp
.No ok Ic "boot net netbsd"
.disp)
.tag)
.Pp
After the initial probe messages you'll be asked to start the
install or upgrade procedure.
Proceed to the section
.Sx Running the installation scripts.
below.
.
.Ss2 Installing NetBSD by using a bootable tape
.
Sun sets their tape drives to SCSI ID 4.
We recommend you do the same.
.Pp
Get the tape images
.Pq Pa installation/tape/tapefile1.gz No and Pa installation/tape/tapefile2
and transfer them to a tape.
Make sure you use the
.Sq no rewind scsi tape
device.
Run the following commands:
.Pp
.(disp
.No # Ic "gunzip tapefile1.gz"
.No # Ic "mt -f /dev/nrst0 rew"
.No # Ic "dd if=tapefile1 of=/dev/nrst0 bs=4k conv=osync"
.No # Ic "dd if=tapefile2 of=/dev/nrst0 bs=4k conv=osync"
.disp)
.Pp
Now you can transfer the
.Nx \*V.
distribution sets from
.Pq Pa binary/sets
to the tape by using a series of additional
.(disp
.No # Ic "dd if=\*[Lt]aset\*[Gt].tgz of=/dev/nrst0 bs=4k conv=osync"
.disp)
commands.
See also the section
.Sx Getting the NetBSD System on to Useful Media.
Be sure to mark the location of these files on the tape; you'll need them
during the installation procedure.
.Pp
Insert the tape into your Sparc's tapestation.
Boot the installer by typing the appropriate command at the PROM prompt:
.Pp
.(tag OpenBoot\ PROM\ 2\ (alternate) -offset indent -compact
.It sunmon
.(disp
.No \*[Gt] Ic "b st()"
.disp)
.It OpenBoot PROM 1
.(disp
.No ok Ic "boot st()"
.disp)
.It OpenBoot PROM 2
.(disp
.No ok Ic "boot tape"
.disp)
.tag)
.Pp
After the initial probe messages you'll be asked to confirm the tape
device and tape file number containing the installation tools.
Then, proceed to the section
.Sx Running the installation scripts.
below.
.
.Ss2 Running the installation scripts
.
The first thing that the installation scripts will inquire about is the
type of console you're using on your machine.
If you're using a Sun frame buffer display, choose the terminal type
.Ic sun
.Pq this is presented as the default .
.(Note
if your frame buffer device is a cgsix Sbus board, you should
change the terminal type to
.Ic sun-cgsix
to avoid triggering a bug in the board's firmware code that can garble
your screen.
.Note)
.Pp
If you're using a terminal device connected to a serial port, choose a
terminal type appropriate for that device, e.g.
.Ic vt100
or
.Ic vt200 .
.Pp
Next, you will be presented with a choice of two installation methods:
a new full-screen
.Ic sysinst
program, or the traditional script-based
.Ic miniroot
program.
The
.Ic sysinst
program is easier to use, but the
.Ic miniroot
program is more flexible.
Both of these installation methods will follow the
same set of procedures and will fully install
.Nx
on your Sparc.
.Pp
You will frequently be asked for confirmation before the system proceeds
with each phase of the installation process.
.Pp
Occasionally, you will have to provide a piece of information such as the
name of the disk you want to install on, partitioning information,
or IP addresses and domain names you want to assign.
If your system has
more than one disk, you may want to look at the output of the
.Xr dmesg 8
command to see how your disks have been identified by the kernel.
.(Note
If you repartition a hard drive, be certain that every partition starts
on a cylinder boundary for compatibility with the Sparc ROM.
.Note)
.Pp
The installation script goes through the following phases:
.(bullet -compact
determination of the disk on which to install
.Nx
.It
checking/creation of the partition information on the disk
.It
creating and mounting the
.Nx
file systems
.It
setup of network configuration
.It
extraction of the distribution tar files
.It
installation of bootstrap programs
.bullet)
.Pp
Now try a reboot.
Initially we'd suggest you
.Ic "boot sd()netbsd -bs" ,
then try multiuser after that.
If you boot single-user the
.Nx
incantation to make the root file system writable is
.Pp
.(disp
.No # Ic "mount -u /dev/sd0a /"
.disp)
.Pp
Your PROM might have been setup to instruct the boot program to load
a file called
.Pa vmunix .
On OpenBoot PROM systems you can change it to load
.Pa netbsd
instead using the following commands:
.Pp
.(tag OpenBoot\ PROM\ 2 -offset indent -compact
.It OpenBoot PROM 1
.(disp
.No ok Ic setenv boot-from sd(0,0,0)netbsd
.disp)
.It OpenBoot PROM 2
.(disp
.No ok Ic setenv boot-file netbsd
.No ok Ic setenv boot-device disk:a
.disp)
.tag)
.Pp
.Em Congratulations ,
you have successfully installed
.Nx \*V.