[src/trunk]: src/distrib/notes Some changes to the sun2 distrib docs to refle...

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

details:   https://anonhg.NetBSD.org/src/rev/895b3f10a93a
branches:  trunk
changeset: 526687:895b3f10a93a
user:      fredette <fredette%NetBSD.org@localhost>
date:      Wed May 08 16:32:54 2002 +0000

description:
Some changes to the sun2 distrib docs to reflect reality.

diffstat:

 distrib/notes/common/contents |  13 +++++++------
 distrib/notes/sun2/hardware   |  14 +++++++-------
 distrib/notes/sun2/install    |  35 +++++++++++++++++++++++++----------
 distrib/notes/sun2/xfer       |  34 ++++++++++++++++++++++++----------
 4 files changed, 63 insertions(+), 33 deletions(-)

diffs (261 lines):

diff -r 40b820ef5477 -r 895b3f10a93a distrib/notes/common/contents
--- a/distrib/notes/common/contents     Wed May 08 15:49:07 2002 +0000
+++ b/distrib/notes/common/contents     Wed May 08 16:32:54 2002 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: contents,v 1.50 2002/05/06 11:33:20 takemura Exp $
+.\"    $NetBSD: contents,v 1.51 2002/05/08 16:32:54 fredette Exp $
 .\"
 .\" Copyright (c) 1999-2001 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -210,7 +210,7 @@
 .              It Pa netboot/
 Two programs needed to boot \*M kernels over the network.
 .              It Pa tapeimage/
-Tape boot programs, and a RAMDISK kernel.
+Tape boot program, and two shell scripts used to prepare tapes.
 .\}
 .
 .if r_sun3 \{\
@@ -338,7 +338,7 @@
 .if r_pmax .Em 19.0 MB gzipped, 61.2 MB uncompressed
 .if r_sparc .Em 17.5 MB gzipped, 43.7 MB uncompressed
 .if r_sparc64 .Em 18.2 MB gzipped, 50.7 MB uncompressed
-.if r_sun2 .Em 50.5 MB gzipped, 112.8 MB uncompressed
+.if r_sun2 .Em 51.9 MB gzipped, 116.0 MB uncompressed
 .if r_sun3 .Em 14.5 MB gzipped, 38.1 MB uncompressed
 .if r_vax .Em 15.5 MB gzipped, 36.0 MB uncompressed
 .if r_x68k .Em 12.5 MB gzipped, 34.0 MB uncompressed
@@ -371,7 +371,7 @@
 .if r_pmax .Em 13.4 MB gzipped, 57.2 MB uncompressed
 .if r_sparc .Em 14.1 MB gzipped, 51.9 MB uncompressed
 .if r_sparc64 .Em 16.2 MB gzipped, 68 MB uncompressed
-.if r_sun2 .Em 12.6 MB gzipped, 44.4 MB uncompressed
+.if r_sun2 .Em 12.5 MB gzipped, 45.1 MB uncompressed
 .if r_sun3 .Em 9.5 MB gzipped, 32.5 MB uncompressed
 .if r_vax .Em 11.9 MB gzipped, 37.9 MB uncompressed
 .if r_x68k .Em 9.4 MB gzipped, 31.8 MB uncompressed
@@ -403,7 +403,7 @@
 .if r_sh3 .Em ? MB gzipped, ? MB uncompressed
 .if r_sparc .Em 3.0 MB gzipped, 7.2 MB uncompressed
 .if r_sparc64 .Em 2.9 MB gzipped, 7.2 MB uncompressed
-.if r_sun2 .Em 5.5 MB gzipped, 12.3 MB uncompressed
+.if r_sun2 .Em 5.4 MB gzipped, 12.2 MB uncompressed
 .if r_vax .Em 2.9 MB gzipped, 7.1 MB uncompressed
 .
 .It Sy kern-GENERIC
@@ -430,6 +430,7 @@
 .if r_pmax .Em 1.1 MB gzipped, 2.7 MB uncompressed
 .if r_sparc .Em 1.2 MB gzipped, 2.8 MB uncompressed
 .if r_sparc64 .Em 2.0 MB gzipped, 4.9 MB uncompressed
+.if r_sun2 .Em 0.4 MB gzipped, 0.9 MB uncompressed
 .if r_vax .Em 0.7 MB gzipped, 1.4 MB uncompressed
 .if r_x68k .Em 0.9 MB gzipped, 2.1 MB uncompressed
 .
@@ -1138,7 +1139,7 @@
 .if r_sun2 \{\
 .Pp
 There is a collection of Sun2 kernels in the
-.Pa \*M/binary/kernels
+.Pa \*M/binary/kernel
 subdirectory of the
 .Nx \*V
 distribution.  The one named
diff -r 40b820ef5477 -r 895b3f10a93a distrib/notes/sun2/hardware
--- a/distrib/notes/sun2/hardware       Wed May 08 15:49:07 2002 +0000
+++ b/distrib/notes/sun2/hardware       Wed May 08 16:32:54 2002 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: hardware,v 1.1 2001/12/17 21:39:52 fredette Exp $
+.\"    $NetBSD: hardware,v 1.2 2002/05/08 16:32:55 fredette Exp $
 .
 .Nx*M
 \*V runs on Multibus Sun2 machines, including:
@@ -6,18 +6,18 @@
 .It 2/120 Ta 2/170 Ta 2/100U
 .El
 .Pp
-The minimal configuration requires 4 MB of RAM and about 80 MB of disk
+The minimal configuration requires 4 MB of RAM and about 130 MB of disk
 space.  To install the entire system requires much more disk space
 (approx. 100 MB additional space is necessary for full sources).
 To compile the system, more RAM is recommended.  Good
 performance requires 7 MB of RAM.
 .Pp
 Here is a table of recommended HD partition sizes for a full install:
-.Bl -column -offset indent Partition Suggested 100xMBxx Needed 100xMB
-.It Partition Ta Suggested Ta +\ X     Ta Needed  Ta +\ X
-.It /\ (root) Ta "20 MB"   Ta "20 MB"  Ta "15 MB" Ta "15 MB"
-.It /usr      Ta "175 MB"  Ta "205 MB" Ta "75 MB" Ta "105 MB"
-.It /var      Ta "20 MB"   Ta "20 MB"  Ta "5 MB"  Ta "5 MB"
+.Bl -column -offset indent Partition Suggested Needed 
+.It Partition Ta Suggested Ta Needed 
+.It /\ (root) Ta "20 MB"   Ta "15 MB"
+.It /usr      Ta "210 MB"  Ta "110 MB"
+.It /var      Ta "20 MB"   Ta "5 MB"
 .It swap      Ta Em 2*RAM \&...
 .El
 .(item -offset indent
diff -r 40b820ef5477 -r 895b3f10a93a distrib/notes/sun2/install
--- a/distrib/notes/sun2/install        Wed May 08 15:49:07 2002 +0000
+++ b/distrib/notes/sun2/install        Wed May 08 16:32:54 2002 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: install,v 1.2 2002/03/21 23:41:32 fredette Exp $
+.\"    $NetBSD: install,v 1.3 2002/05/08 16:32:55 fredette Exp $
 .\"
 .\" Copyright (c) 1999, 2000 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -61,7 +61,7 @@
 .Nx*M
 \*V boot tape as described in the section
 entitled
-.Sx "Preparing a boot tape"
+.Sx "Creating boot/install tapes"
 and boot the tape. At the PROM
 monitor prompt, use one of the commands:
 .Pp
@@ -158,10 +158,10 @@
 .Pp
 .Dl ssh\*> Ic "mount -o rdonly,-r=1024 192.233.20.195:/server/path /mnt"
 .Pp
-The procedure is simpler if you have space for an expanded
+The procedure is simpler and much faster if you have space for an expanded
 (not compressed) copy of the miniroot image. In that case:
 .Pp
-.Dl ssh\*> Ic "dd if=/mnt/miniroot of=/dev/rsd0b bs=8k"
+.Dl ssh\*> Ic "dd if=/mnt/miniroot.fs of=/dev/rsd0b bs=8k"
 .Pp
 Otherwise, you will need to use
 .Ic zcat
@@ -179,13 +179,24 @@
 The result looks like this:
 .Pp
 .Dl ssh\*> Ic "run -bg dd if=/dev/pipe of=/dev/rsd0b obs=8k"
-.Dl ssh\*> Ic "run -o /dev/pipe zcat /mnt/install/miniroot.gz"
+.Dl ssh\*> Ic "run -o /dev/pipe zcat /mnt/install/miniroot.fs.gz"
 .Pp
 To load the miniroot using rsh to the server, you would use a
 pair of commands similar to the above. Here is another example:
 .Pp
 .Dl ssh\*> Ic "run -b dd if=/dev/pipe of=/dev/rsd0b obs=8k"
-.Dl ssh\*> Ic "run -o /dev/pipe rsh 192.233.20.195 zcat miniroot.gz"
+.Dl ssh\*> Ic "run -o /dev/pipe rsh 192.233.20.195 zcat miniroot.fs.gz"
+.Pp
+Note that decompression on a sun2 is
+.Em extremely
+slow, be prepared to wait.  For this reason, expanding the miniroot
+image on the NFS server is highly recommended.
+.Pp
+Once the miniroot has been copied using one of the above methods,
+you reboot from that just installed miniroot. See the section
+entitled
+.Sx Booting the miniroot
+for details.
 .
 .Ss2 Installing from SunOS
 .
@@ -194,7 +205,7 @@
 onto a machine already running
 .Tn SunOS ,
 you
-will need the miniroot image (miniroot.gz) and some means to
+will need the miniroot image (miniroot.fs.gz) and some means to
 decompress it.
 .Pp
 First, boot
@@ -219,17 +230,21 @@
 .Pa /dev/rsd0b )
 with the command
 .Pp
-.Dl Ic "gzip -dc miniroot.gz | dd of=/dev/rsd0b obs=32k"
+.Dl Ic "gzip -dc miniroot.fs.gz | dd of=/dev/rsd0b obs=32k"
 .Pp
 or if you have already decompressed the miniroot
 .Pp
-.Dl Ic "dd if=miniroot.gz of=/dev/rsd0b obs=32k"
+.Dl Ic "dd if=miniroot.fs of=/dev/rsd0b obs=32k"
 .Pp
-Finally, reboot the machine and instruct the ROM to boot from
+Finally, reboot the machine and instruct the PROM to boot from
 the swap device as described in the next section.
 .
 .Ss2 Booting the Miniroot
 .
+If the machine is not already at the PROM monitor, run the
+.Pa halt
+command.
+.Pp
 If the miniroot was installed on partition
 .Sq Li b
 of the disk with
diff -r 40b820ef5477 -r 895b3f10a93a distrib/notes/sun2/xfer
--- a/distrib/notes/sun2/xfer   Wed May 08 15:49:07 2002 +0000
+++ b/distrib/notes/sun2/xfer   Wed May 08 16:32:54 2002 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: xfer,v 1.1 2001/12/17 21:39:52 fredette Exp $
+.\"    $NetBSD: xfer,v 1.2 2002/05/08 16:32:56 fredette Exp $
 .
 Installation is supported from several media types, including:
 .(bullet -compact -offset indent
@@ -84,8 +84,8 @@
 .Pp
 When instructed to boot over the network, your \*M expects to be
 able to download first and second stage bootstrap programs via
-.Tn ND .
-The
+.Tn ND ,
+the Network Disk protocol.  The
 .Xr ndbootd 8
 program will attempt to serve a second-stage bootstrap file using 
 a name derived from the machine's recently acquired IP
@@ -112,14 +112,22 @@
 be located in a place where the
 .Xr ndbootd 8
 daemon can find it.
-The netboot program
-may be found in the install directory of this distribution.
+The
+.Pa netboot
+program may be found in the
+.Pa installation/netboot
+directory of this distribution.
 .Pp
 The netboot program will query a bootparamd server to find the
 NFS server address and path name for its root, and then load a
 kernel from that location. The server should have a copy of the
-netbsd-rd kernel in the root area for your client (no other files
-are needed in the client root) and
+.Pa netbsd.RAMDISK
+kernel in the root area for your client, hard-linked
+under the names
+.Pa netbsd
+and
+.Pa vmunix 
+(no other files are needed in the client root) and
 .Pa /etc/bootparams
 on the server
 should have an entry for your client and its root directory.
@@ -130,7 +138,9 @@
 .Nx
 on several clients, it may be useful
 to know that you can use a single NFS root for all the clients as long
-as they only use the netbsd-rd kernel. There will be no conflict
+as they only use the 
+.Pa netbsd.RAMDISK
+kernel. There will be no conflict
 between clients because the RAM-disk kernel will not use the NFS root.
 No swap file is needed; the RAM-disk kernel does not use that either.
 .
@@ -151,8 +161,12 @@
 This method requires that you boot from another device (i.e. tape
 or network, as described above). You may need to make a boot tape
 on another machine using the files in
-.Pa .../install
-(which you get via FTP). Once you have booted netbsd-rd (the RAM-disk kernel)
+.Pa installation/tapeimage
+and
+.Pa binary/kernel
+(which you get via FTP). Once you have booted 
+.Pa netbsd.RAMDISK 
+(the RAM-disk kernel)
 and loaded the miniroot, you can load any of the distribution sets
 over the net using FTP. The
 .Ic install