[src/netbsd-2-0]: src/distrib/notes/sparc64 Pull up revisions 1.21-1.23 (requ...

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

details:   https://anonhg.NetBSD.org/src/rev/f24935cc46f3
branches:  netbsd-2-0
changeset: 561398:f24935cc46f3
user:      he <he%NetBSD.org@localhost>
date:      Tue Jun 15 22:59:35 2004 +0000

description:
Pull up revisions 1.21-1.23 (requested by mbw in ticket #482):
  Major overhaul of sparc64 install notes.  Reflects currently
  supported hardware installation methods along with additional
  info.  Also expand PCI card compat descriptions and list
  known working cards.  Correct 0680 card as SiS.  Use MI
  sysinst documentation.  sparc64 has OpenFirmware, not
  OpenBoot PROM.  Redo suggested partitioning info with more
  reasonable sizes.

diffstat:

 distrib/notes/sparc64/install |  834 +++++++++++++----------------------------
 1 files changed, 259 insertions(+), 575 deletions(-)

diffs (truncated from 930 to 300 lines):

diff -r d2c93955d3fe -r f24935cc46f3 distrib/notes/sparc64/install
--- a/distrib/notes/sparc64/install     Tue Jun 15 22:59:11 2004 +0000
+++ b/distrib/notes/sparc64/install     Tue Jun 15 22:59:35 2004 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: install,v 1.19.2.1 2004/05/13 20:24:34 jdc Exp $
+.\"    $NetBSD: install,v 1.19.2.2 2004/06/15 22:59:35 he Exp $
 .\"
 .\" Copyright (c) 1999-2002 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -50,10 +50,13 @@
 operating system (see the section
 .Sx Installing NetBSD by using a diskless setup
 below).
-If you have problems with these, it
-is possible to install NetBSD from Solaris (see the section `Installing
+.Pp
+If you have problems with these or you are installing 
 .Nx
-using Solaris' below).
+onto the same disk as 
+.Tn Solaris ,
+see the section below on
+.Sx "Manual Installation of NetBSD using Solaris"
 .
 .Ss2 Installing NetBSD from CDROM
 .
@@ -62,27 +65,19 @@
 .Ic sysinst
 is the least painful way to install
 .Nx .
-Simply insert the CDROM in the drive, power up the computer, and
-when you get to the
-.Pp
-.Dl ok
-.Pp
-prompt type:
-.Pp
-.Dl ok Ic "boot cdrom"
+Simply insert the CD-ROM in the drive, power up the computer, and type:
+.(disp
+.No ok Ic "boot cdrom"
+.disp)
 .Pp
-If the machine starts booting automatically, hit the
-.Ic L1
-or
-.Ic Stop
-key and the
-.Ic A
-key on the keyboard or send a break if your console is serial port
-to terminate the boot process.
-.Pp
+This Open Firmware boot command will cause the
 .Nx
-should then boot and you will have the opportunity to use
-.Ic sysinst .
+kernel contained in the CD-ROM 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 sysinst installation program"
+below.
 .
 .Ss2 Installing NetBSD by using the NetBSD miniroot
 .
@@ -94,604 +89,300 @@
 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 OpenBoot PROM command.
+be booted using the appropriate OpenFirmware 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.
 .Pp
-Loading the miniroot onto your raw partition is simple.
+Loading the miniroot onto your raw partition is simple using the
+.Xr dd 1
+command.  Just remember to first uncompress the miniroot image and boot 
+your OS with the
+.Li -s
+flag so that it runs 
+.Dq "single-user"
+and does not attempt to start swapping.
+.(disp
+.No ok Ic "boot -s"
+.disp)
+.Pp
 On
 .Tn Solaris
 you use a command like:
-.Pp
-.Dl # Ic "dd if=miniroot.fs of=/dev/rdsk/c0t0d0s1 bs=4k conv=sync"
-.Pp
+.(disp
+.No # Ic "gunzip miniroot.fs.gz"
+.No # Ic "dd if=miniroot.fs of=/dev/rdsk/c0t0d0s1 bs=4k conv=sync"
+.disp)
 On
 .Nx
 the command is:
-.Pp
-.Dl # Ic "dd if=miniroot.fs of=/dev/rsd0b bs=4k conv=sync"
-.Pp
-(Here,
+.(disp
+.No # Ic "gunzip miniroot.fs.gz"
+.No # Ic "dd if=miniroot.fs of=/dev/rsd0b bs=4k conv=sync"
+.disp)
+Replace
 .Li /dev/rdsk/c0t0d0s1
 or
 .Li /dev/rsd0b
-is assumed to be your swap partition.)
-There's a potential problem here if
-.Pa /dev/rdsk/c0t0d0s1
-is actually in use as a swap
-partition by your currently running system.
-If you don't have another disk or partition to spare,
-you can usually get away with running this
-command anyway after first booting into single-user mode to ensure a
-quiet system.
+with your swap partition.
 .Pp
 After transferring the miniroot to disk, bring the system down by:
-.Pp
-.Dl # Ic halt
-.Pp
-Then boot the miniroot by typing the appropriate command at the OpenBoot PROM:
-.Pp
-.Dl ok Ic "boot disk:b netbsd"
-.Pp
+.(disp
+.No # Ic halt
+.disp)
+Then boot the miniroot by typing the appropriate command at the 
+OpenFirmware prompt:
+.(disp
+.No ok Ic "boot disk:b netbsd"
+.disp)
 If you've loaded the miniroot onto some other disk than
 .Li sd0
-adapt
-the boot specifier accordingly, e.g.:
-.Pp
-.Dl ok Ic "boot disk1:b netbsd"
-.Pp
-The monitor boot command will cause the
+use the correct 
+.Pa devalias ,
+such as
+.(disp
+.No ok Ic "boot disk1:b netbsd"
+.disp)
+This Open Firmware 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 sysinst
+.Sx "Running the sysinst installation program"
 below.
 .
-.Ss2 Installing NetBSD by using a diskless setup
+.Ss2 Installing NetBSD by using a NetBSD kernel on a Solaris partition
 .
-First, you must setup a diskless client configuration on a server.
-If 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
-documentation that came with it.
-(On
-.Tn SunOS
-systems,
-.Xr add_client 8
-is a good start.)
-.Pp
-Your UltraSPARC expects to be able to download a second stage bootstrap
-program via TFTP after having acquired its IP address through RevARP when
-instructed to boot
-.Sq "over the net" .
-It will look for a filename composed of the machine's IP address in
-hexadecimal.
-For example, a machine which has been assigned IP address
-130.115.144.11, will make an TFTP request for
-.Pa 8273900B .
-Normally, this file is a symbolic link to an appropriate second-stage
-boot program, which should be located in a place where the TFTP daemon
-can find it (remember, many TFTP daemons run in a chroot'ed environment).
-You can find the boot program in
-.Pa /usr/mdec/ofwboot.net
-in the
-.Nx*M
-distribution.
-.(Note
-The
-.Pa /usr/mdec/ofwboot
-does not know about netbooting.
-.Note)
-.Pp
-After the boot program has been loaded into memory and given control by
-the OpenBoot PROM, it starts locating the machine's remote root directory
-through the BOOTPARAM protocol.
-First a BOOTPARAM WHOAMI request is broadcast on the local net.
-The answer to this request (if it comes in) contains
-the client's name.
-This name is used in next step, a BOOTPARAM GETFILE
-request \(em sent to the server that responded to the WHOAMI request \(em
-requesting the name and address of the machine that will serve the client's
-root directory, as well as the path of the client's root on that server.
-.Pp
-Finally, this information (if it comes in) is used to issue a REMOTE MOUNT
-request to the client's root file system server, asking for an NFS file
-handle corresponding to the root file system.
-If successful, the boot program starts reading from the remote root
-file system in search of the kernel which is then read into memory.
-.Pp
-As noted above in the section
-.Sx Preparing your System for NetBSD Installation
-you have several options when choosing a location to store the installation
-filesets.
-However, the easiest way is to put the
-.Pa *.tgz
-files you want
-to install into the root directory for your client on the server.
-.Pp
-From here there are two methods of netboot install.
-The first is much simpler and is intended for clients with local disk
-that will be used for installation.
-The second is intended for clients that will use a network boot normally.
-.Pp
-If you are going to be installing onto local disk, place the
-.Pa netbsd-INSTALL.gz
-file, located in the
-.Pa binary/kernel
-directory, into the root directory for your machine.
-The
-.Pa netbsd-INSTALL.gz
-file contains a kernel with an embedded ramdisk that has the basic
-installer file system that is part of the normal miniroot.
-Now you need to boot your workstation
-from the server by entering the following command at the monitor prompt:
-.Pp
-.Dl "ok boot net netbsd-INSTALL.gz"
-.Pp
-And then follow the install instructions.
-.Pp
-If you are going to be installing to NFS, be sure to read the section
-about preparing your system for installation.
-If you have access to another
+This procedure is very straightforward.  You will be putting the
 .Nx
-machine, the
-.Xr diskless 8
-manual page contains information about diskless booting.
-Unpack the
-.Pa base.tgz
-and
-.Pa etc.tgz
-sets on the server in the root
-directory for your machine.
-If you elect to use a separately NFS-mounted file system for
-.Pa /usr
-with your diskless setup, make sure the
-.Pa ./usr
-base
-files in
-.Pa base.tgz
-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
+installation kernel (kernel with a RAM disk installer) on your
+.Tn Solaris
+partition and telling Open Firmware to boot the
 .Nx
-.Pa /usr
-directory.
-.Pp
-A few configuration files need to be edited:
-.(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
-This files contains the client's hostname; use the same
-name as in \*<root\*>/etc/hosts.
-.It Ar root Ns Pa /etc/fstab
-Enter the entries for the remotely mounted file systems.
-For example:
-.Pp
-.Dl server:/export/root/client        /     nfs  rw 0 0
-.Dl server:/export/exec/sun4u.netbsd  /usr  nfs  rw 0 0
-.tag)