Some changes to the sun2 distrib docs to reflect reality.

2002-05-08 16:32:54 +00:00 · 2002-05-08 16:32:54 +00:00 · 73addee855
parent 3c33c0f57e
commit 73addee855
4 changed files with 63 additions and 33 deletions
--- a/distrib/notes/common/contents
+++ b/distrib/notes/common/contents
@ -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 @@ Server boot-file image for diskless machines.
 .		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 @@ everything described below.
 .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 @@ system call and library manual pages.
 .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 @@ This set includes the games and their manual pages.
 .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 @@ install this distribution set.
 .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 @@ versions of
 .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
--- a/distrib/notes/sun2/hardware
+++ b/distrib/notes/sun2/hardware
@ -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
--- a/distrib/notes/sun2/install
+++ b/distrib/notes/sun2/install
@ -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 @@ Create the
 .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 @@ Now mount the NFS file system containing the miniroot image:
 .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 @@ and then run the other program in the foreground with its output to
 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 @@ To install
 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 @@ Now copy the miniroot image onto your swap device (here
 .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
--- a/distrib/notes/sun2/xfer
+++ b/distrib/notes/sun2/xfer
@ -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 @@ on
 .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 @@ program, which should
 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 @@ If you will be installing
 .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 @@ work required to mount the CD-ROM and extract the files.
 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