[src/netbsd-1-5]: src/distrib/notes/sparc Pullup HEAD [pk]:

[tv <tv%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/8cff9dad55d6
branches:  netbsd-1-5
changeset: 489954:8cff9dad55d6
user:      tv <tv%NetBSD.org@localhost>
date:      Fri Oct 20 17:18:46 2000 +0000

description:
Pullup HEAD [pk]:
Update to reflect changes to the bootfs and miniroot images.

diffstat:

 distrib/notes/sparc/install |  304 +++++++++++++++++++++++++++++++------------
 1 files changed, 218 insertions(+), 86 deletions(-)

diffs (truncated from 459 to 300 lines):

diff -r 69e00d72af61 -r 8cff9dad55d6 distrib/notes/sparc/install
--- a/distrib/notes/sparc/install       Fri Oct 20 17:10:01 2000 +0000
+++ b/distrib/notes/sparc/install       Fri Oct 20 17:18:46 2000 +0000
@@ -1,6 +1,6 @@
-.\"    $NetBSD: install,v 1.23.4.1 2000/08/22 16:06:31 abs Exp $       
+.\"    $NetBSD: install,v 1.23.4.2 2000/10/20 17:18:46 tv Exp $
 .\"
-.\" Copyright (c) 1999 The NetBSD Foundation, Inc.
+.\" Copyright (c) 1999, 2000 The NetBSD Foundation, Inc.
 .\" All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
@@ -32,31 +32,41 @@
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
 .
-Installing NetBSD is a relatively complex process, but if you have
+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 NetBSD onto a disk. The easiest way
-in terms of preliminary setup is to use the NetBSD miniroot that can
-be booted off your local disk's swap partition. Alternatively, if your
-Sparcstation is hooked up in a network you can find a server and arrange
-for a diskless setup which is a convenient way to install on a machine
-whose disk does not currently hold a usable operating system (see the
-section `Installing NetBSD by using a diskless setup' below).  There is
-also a bootable 1.4MB floppy available that contains a slightly less
-featureful miniroot environment.
+There are several ways to install
+.Nx
+onto a disk. The easiest way is to use the 'miniroot.fs' image copied to
+your local disk's swap partition.
+Alternatively, if your Sparcstation is hooked up in a network you
+can find a server and arrange for a diskless setup which is a
+convenient way to install on a machine whose disk does not currently
+hold a usable operating system (see the section `Installing
+.Nx
+by using a diskless setup' below).  Also available is
+a two-disk bootable 1.44 MB floppy image set that can be used to boot into
+the miniroot environment.
 .
-.Ss2 Installing NetBSD by using the NetBSD miniroot.
+.Ss2 Installing NetBSD by using the NetBSD miniroot
 .
-The miniroot is a self-contained NetBSD filesystem holding all utilities
-necessary to install NetBSD on a local disk. It is distributed as a plain
+The miniroot is a self-contained
+.Nx
+filesystem holding all utilities
+necessary to install
+.Nx
+on a local disk. It is distributed as a plain
 file designed to be transferred to a raw disk partition from which it can
 be booted using the appropriate PROM command. Usually, the miniroot will
 be loaded into the swap partition of a disk. If needed, you can use any
-other unused partition, but remember that the partition will then not
-available during the installation process.
+other unused partition, but remember that in the case of 'miniroot.fs'
+the partition will then not available during the installation process.
 .Pp
-Loading the miniroot onto your raw partition is simple. On NetBSD as well
-as SunOS you use a command like:
+Loading the miniroot onto your raw partition is simple. On
+.Nx
+as well as SunOS you use a command like:
 .Dl # Ic dd if=miniroot.fs of=/dev/rsd0b bs=4k conv=sync
 (Here, `/dev/rsd0b' is assumed to be your swap partition.) There's a
 potential problem here if /dev/rsd0b is actually in use as a swap
@@ -81,40 +91,86 @@
 .Ic sd( Ns Ar c,u,p Ns Ic \&)
 syntax to boot from a
 SCSI disk, you can calculate the parameters as follows:
-.Bl -tag -width xcc
-.      It Ar c
+.(tag xcc
+.It Ar c
 specifies the controller number
-.      It Ar u 
+.It Ar u
 the hexadecimal number obtained from evaluating
 the expression `(8 * TARGET) + LUN'
-.      It Ar p
+.It Ar p
 the partition number from which to boot (0=`a', 1=`b', etc).
-.El
+.tag)
 .Pp
-The monitor boot command will cause the NetBSD kernel contained in the
+The monitor boot command will cause the
+.Nx
+kernel contained in the
 miniroot image to be booted. 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 floppy
+.
+The
+.Nx
+install floppy works only on the sun4c and sun4m class.
+Making the install floppy is simple:
+.Pp
+Get two formatted floppy disks. If you have unformatted disks you can
+run the
+.Xr fdformat 8
+program that comes with
+.Nx
+as well as SunOS. Use the following command:
+.Dl # Ic "fdformat"
+.Pp
+Make sure that the `fdformat' command completes successfully before proceeding
+to with the next step; on
+.Nx
+, a string of all `V's, and on SunOS, a string of
+all `.'s.
+Alternatively, you can use almost any PC to format your floppy disks.
+.Pp
+Next, transfer the floppy images onto the floppy disks:
+.Dl # Ic "insert the first disk"
+.Dl # Ic "gunzip boot.fs.gz"
+.Dl # Ic "dd if=boot.fs of=/dev/rfd0a bs=36k"
+.Dl # Ic "eject floppy"
+Label this disk
+.Dq NetBSD bootfs .
+.Pp
+.Dl # Ic "insert the first disk"
+.Dl # Ic "dd if=instfs.tgz of=/dev/rfd0a bs=36k"
+.Dl # Ic "eject floppy"
+Label this disk
+.Dq NetBSD instfs .
+.Pp
+You can also accomplish this task on a Windows system by using the
+.Nm rawrite.exe
+command provided with the NetBSD/i386 install tools.
+.Pp
+Insert the disk labeled
+.Dq NetBSD bootfs
+into the floppy drive of the target system.
+From the OpenBOOT prompt, the following should boot the system from the floppy.
+.Dl ok Ic "boot fd(,,1)                 # Version 1 OpenBOOT ROMs
+.Dl ok Ic "boot /fd                     # or
+.Dl ok Ic "boot floppy                  # Version 2 OpenBOOT ROMs
+.Pp
+After the initial probe messages you'll be asked to insert the disk labeled
+.Dq NetBSD instfs
+into the drive. After the installation tools from the second disk have
+been loaded, you will 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 floppy.
-.
-The NetBSD install floppy works only on the sun4c and sun4m class
-machines.  From the OpenBOOT prompt, the following should boot the
-floppy.
-.Dl ok Ic "boot fd(,,1)                 # for version 1 OpenBOOT ROMs
-.Dl ok Ic "boot /fd                     # either of these for version
-.Dl ok Ic "boot floppy                  # 2 OpenBOOT ROMs
-.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 diskless setup.
+.Ss2 Installing NetBSD by using a diskless setup
 .
 First, you must setup a diskless client configuration on a server. If
-you are using a NetBSD system as the boot-server, have a look at the
+you are using a
+.Nx
+system as the boot-server, have a look at the
 .Xr diskless 8
 manual page for guidelines on how to proceed with this.
 If the server runs another operating system, you'll have to consult
@@ -132,7 +188,9 @@
 can find it (remember, many TFTP daemons run in a chroot'ed environment).
 You can find the boot program in
 .Pa /usr/mdec/boot.net
-in the NetBSD/sparc distribution.
+in the
+.Nx*M
+distribution.
 .(Note
 The only difference between
 .Pa /usr/mdec/boot.net No and Pa /usr/mdec/boot
@@ -163,33 +221,73 @@
 files you want
 to install into the root directory for your client on the server.
 .Pp
-Next, unpack `base.tar.gz', `etc.tar.gz', and 'kern.tgz' on the server in
+.ie 0 \{\
+.\" section commented out because netbsd.ram.gz is no longer self-contained
+Next you must select whether to use the easier 'sysinst' or more flexible
+script based install.
+.
+.Ss2 Diskless sysinst installation
+.
+Follow this section and skip the next if you wish to use the easier 'sysinst'
+installation method.
+.Pp
+Copy the installation/bootfs/netbsd.ram.gz image into the exported
+root directory for your machine, then boot your workstation from the
+server by entering the appropriate `boot' command at the monitor prompt.
+Depending on the PROM version in your machine, this command takes one of
+the following forms:
+.Dl "\*> b le()netbsd.ram.gz             # for sun4 monitors
+.Dl "ok boot le()netbsd.ram.gz           # for version 1 OpenBOOT ROMs
+.Dl "ok boot net netbsd.ram.gz           # for version 2 OpenBOOT ROMs
+.Pp
+This will boot the
+.Nx
+kernel in single-user mode.
+.(Note
+The latter two examples assume you operate the OpenBOOT ROM in
+"new command mode". If your machine comes up and gives you a `\*>' prompt
+instead of `ok', type:
+.Dl "\*>n                                  # enter native OpenBOOT mode
+.Dl "ok setenv sunmon-compat? false      # make it permanent
+.Dl "ok
+.Note)
+.
+.\}
+.Ss2 Diskless script installation
+.
+.ie 0 \{\
+Follow this section and skip the previous if you wish to use the more
+flexible 'miniroot' script installation method.
+.Pp
+.\}
+Unpack `base.tar.gz', `etc.tar.gz', and 'kern.tgz' on the server in
 the root directory for your machine. If you elect to use a separately
 NFS-mounted filesystem for `/usr' with your diskless setup, make sure the
 "./usr" base files in base.tar.gz end up in the correct location. One way
 to do this is to temporarily use a loopback mount on the server, re-routing
 .Ar root Ns Pa /usr
-to your server's exported NetBSD
+to your server's exported
+.Nx
 .Pa /usr
 directory. Also put 'install.*' and 'upgrade.sh' from the
 .Pa installation/netboot/
 directory into the root directory.
 .Pp
 A few configuration files need to be edited:
-.Bl -tag -width indent
-.      It Ar root Ns Pa /etc/hosts
+.(tag indent
+.It Ar root Ns Pa /etc/hosts
 Add the IP addresses of both server and client.
 
-.      It Ar root Ns Pa /etc/myname
+.It Ar root Ns Pa /etc/myname
 This files contains the client's hostname; use the same
 name as in \*<root\*>/etc/hosts.
 
-.      It Ar root Ns Pa /etc/fstab
+.It Ar root Ns Pa /etc/fstab
 Enter the entries for the remotely mounted filesystems.
 For example:
 .Dl server:/export/root/client       /     nfs  rw 0 0
 .Dl server:/export/exec/sun4.netbsd  /usr  nfs  rw 0 0
-.El
+.tag)
 .Pp
 Now you must populate the `/dev' directory for your client. If your server
 runs SunOS 4.x, you can simply change your working directory to
@@ -199,9 +297,20 @@
 .Pp
 On SunOS 5.x systems, MAKEDEV can also be used, but there'll be error
 messages about unknown user and groups. These errors are inconsequential
-for the purpose of installing NetBSD. However, you may want to correct them
+for the purpose of installing
+.Nx .
+However, you may want to correct them
 if you plan to use the diskless setup regularly. In that case, you may re-run
-MAKEDEV on your NetBSD machine once it has booted.
+MAKEDEV on your
+.Nx
+machine once it has booted.
+.Pp
+If you to use the server setup for installation purposes only, then you
+may create a considerably smaller client filesystem by unpacking
+`instfs.tgz' (found in the `installation/bootfs' distribution directory)
+into your client's NFS root directory instead of using `base.tar.gz'
+and `etc.tar.gz'. You still need 'kern.tgz' to extract a kernel,
+since `instfs.tgz' does not contain one.
 .Pp
 Boot your workstation from the server by entering the appropriate `boot'
 command at the monitor prompt. Depending on the PROM version in your machine,
@@ -210,7 +319,9 @@
 .Dl "ok boot le()netbsd -s           # for version 1 OpenBOOT ROMs
 .Dl "ok boot net netbsd -s           # for version 2 OpenBOOT ROMs
 .Pp
-This will boot the NetBSD kernel in single-user mode.