ralph's update for 3100 install, plus edits for same by kirk

[unix-history] / usr / src / share / doc / smm / 01.setup / 2.t

diff --git a/usr/src/share/doc/smm/01.setup/2.t b/usr/src/share/doc/smm/01.setup/2.t
index a872472..a665749 100644 (file)
--- a/usr/src/share/doc/smm/01.setup/2.t
+++ b/usr/src/share/doc/smm/01.setup/2.t
@@ -3,7 +3,7 @@
 .\"
 .\" %sccs.include.redist.roff%
 .\"
 .\"
 .\" %sccs.include.redist.roff%
 .\"

-.\"    @(#)2.t 6.4 (Berkeley) %G%
+.\"    @(#)2.t 6.8 (Berkeley) %G%

 .\"
 .ds lq ``
 .ds rq ''
 .\"
 .ds lq ``
 .ds rq ''


@@ -24,37 +24,51 @@ In either case, it is highly desirable to read and understand
 the remainder of this document before proceeding.
 .NH 2
 Bootstrapping from the tape
 the remainder of this document before proceeding.
 .NH 2
 Bootstrapping from the tape

-.PP
+.LP

 The set of files on the distribution tape are as follows:
 The set of files on the distribution tape are as follows:

-.DS
-1) dd (HP300 and DecStation) or dump (Sparc) image of the root filesystem
-2) tar image of the /var filesystem
-3) tar image of the /usr filesystem
-4) tar image of /usr/src/sys
-5) tar image of the rest of /usr/src
-6) (8mm tape only) tar image of /usr/src/X11R5
-.DE
-.PP
+.IP 1)
+dd (HP300 and DECstation) or dump (SPARC) image of the root filesystem
+.IP 2)
+tar image of the
+.Pn /var
+filesystem
+.IP 3)
+tar image of the
+.Pn /usr
+filesystem
+.IP 4)
+tar image of
+.Pn /usr/src/sys
+.IP 5)
+tar image of the rest of
+.Pn /usr/src
+.IP 6)
+(8mm tape only) tar image of
+.Pn /usr/src/X11R5
+.LP

 The tape bootstrap procedure used to create a
 working system involves the following major steps:
 .IP 1)
 Transfer a bootable root filesystem from the tape to a disk
 and get it booted and running.
 .IP 2)
 The tape bootstrap procedure used to create a
 working system involves the following major steps:
 .IP 1)
 Transfer a bootable root filesystem from the tape to a disk
 and get it booted and running.
 .IP 2)

-Build and restore the /var and /usr filesystems from tape
-with \fItar\fP\|(1).
+Build and restore the
+.Pn /var
+and
+.Pn /usr
+filesystems from tape with
+.Xr tar (1).

 .IP 3)
 Extract the system and utility source files as desired.
 .PP
 The following sections describe the above steps in detail.
 The details of the first step vary between architectures.
 .IP 3)
 Extract the system and utility source files as desired.
 .PP
 The following sections describe the above steps in detail.
 The details of the first step vary between architectures.

-The specific steps for the HP300, Sparc, and DecStation are
+The specific steps for the HP300, SPARC, and DECstation are

 given in the next three sections respectively.
 You should follow the instructions for your particular architecture.
 In all sections,
 commands you are expected to type are shown in italics, while that
 information printed by the system is shown emboldened.
 given in the next three sections respectively.
 You should follow the instructions for your particular architecture.
 In all sections,
 commands you are expected to type are shown in italics, while that
 information printed by the system is shown emboldened.

-.PP

 .NH 2
 Booting the HP300
 .NH 3
 .NH 2
 Booting the HP300
 .NH 3


@@ -119,7 +133,7 @@ configured for Domain/OS, EISA and VME bus adaptors, audio, the centronics
 port, 1/2" tape drives (7980), CD-ROM, and the PVRX/TVRX 3D graphics displays.
 .NH 3
 Standalone device file naming
 port, 1/2" tape drives (7980), CD-ROM, and the PVRX/TVRX 3D graphics displays.
 .NH 3
 Standalone device file naming

-.PP
+.LP

 The standalone system device name syntax on the HP300 is of the form:
 .DS
 xx(a,c,u,p)
 The standalone system device name syntax on the HP300 is of the form:
 .DS
 xx(a,c,u,p)


@@ -151,7 +165,7 @@ The \fIpartition\fP field is interpreted differently for tapes
 and disks: for disks it is a disk partition (in the range 0-7),
 and for tapes it is a file number offset on the tape.
 Thus, partition 2 of a SCSI disk drive at target 3 on SCSI bus 1
 and disks: for disks it is a disk partition (in the range 0-7),
 and for tapes it is a file number offset on the tape.
 Thus, partition 2 of a SCSI disk drive at target 3 on SCSI bus 1

-would be ``sd(1,0,3,2)''.
+would be ``sd(1,3,0,2)''.

 If you have only one of any type bus adaptor, you may omit the adaptor
 and controller numbers;
 e.g. ``sd(0,2)'' could be used instead of ``sd(0,0,0,2)''.
 If you have only one of any type bus adaptor, you may omit the adaptor
 and controller numbers;
 e.g. ``sd(0,2)'' could be used instead of ``sd(0,0,0,2)''.


@@ -170,7 +184,9 @@ Boot the UNIX system on the new disk.
 .IP 4)
 (Optional) Build a root filesystem optimized for your disk.
 .IP 5)
 .IP 4)
 (Optional) Build a root filesystem optimized for your disk.
 .IP 5)

-Label the disks with the \fIdisklabel\fP\|(8) program.
+Label the disks with the
+.Xr disklabel (8)
+program.

 .NH 4
 Step 1: formating a disk.
 .PP
 .NH 4
 Step 1: formating a disk.
 .PP


@@ -178,30 +194,39 @@ For your first system you will have to obtain a formatted disk
 of a type given in the ``supported hardware'' list above.
 Since most HP disk drives, with the exception of optical media,
 come pre-formatted there should be nothing to do.
 of a type given in the ``supported hardware'' list above.
 Since most HP disk drives, with the exception of optical media,
 come pre-formatted there should be nothing to do.

-If necessary, you can format a disk under HP-UX using
-the \fImediainit\fP\|(1m) program.
+If necessary, you can format a disk under HP-UX using the
+.Xr mediainit (1m)
+program.

 Once you have \*(4B up and running on one machine you can use
 Once you have \*(4B up and running on one machine you can use

-the \fIscsiformat\fP\|(8) program to format additional disks.
+the
+.Xr scsiformat (8)
+program to format additional disks.

 .NH 4
 Step 2: copying the root filesystem from tape to disk
 .PP
 There are two approaches to getting the root filesystem from tape to disk.
 .NH 4
 Step 2: copying the root filesystem from tape to disk
 .PP
 There are two approaches to getting the root filesystem from tape to disk.

-If you have an extra disk, the easiest approach is to use \fIdd\fP\|(1)
+If you have an extra disk, the easiest approach is to use
+.Xr dd (1)

 under HP-UX to copy the root filesystem image from the tape to the beginning
 under HP-UX to copy the root filesystem image from the tape to the beginning

-of the second disk. 
+of the second disk.

 For HPs, the root filesystem image is the first file on the tape.
 It includes a disklabel and bootblock along with the root filesystem.
 An example command to copy the image from tape to the beginning of a disk is:
 .DS
 For HPs, the root filesystem image is the first file on the tape.
 It includes a disklabel and bootblock along with the root filesystem.
 An example command to copy the image from tape to the beginning of a disk is:
 .DS

+.ft CW

 dd if=/dev/rmt/0m of=/dev/rdsk/1s0 bs=20b
 .DE
 The actual special file syntax may vary depending on unit numbers and
 the version of HP-UX that is running.
 dd if=/dev/rmt/0m of=/dev/rdsk/1s0 bs=20b
 .DE
 The actual special file syntax may vary depending on unit numbers and
 the version of HP-UX that is running.

-Consult the HP-UX \fImt\fP(7) and \fIdisk\fP(7) man pages for details.
+Consult the HP-UX
+.Xr mt (7)
+and
+.Xr disk (7)
+man pages for details.

 .PP
 If you have only a single machine with a single disk,
 you need to use the more difficult approach of booting a
 .PP
 If you have only a single machine with a single disk,
 you need to use the more difficult approach of booting a

-standalone copy program, and using that to copy the 
+standalone copy program, and using that to copy the

 root filesystem image from the tape to the disk.
 If your distribution is on 8mm tape and you have an 8mm drive attached
 to the target machine, you should be able to boot from the distribution
 root filesystem image from the tape to the disk.
 If your distribution is on 8mm tape and you have an 8mm drive attached
 to the target machine, you should be able to boot from the distribution


@@ -213,6 +238,7 @@ To do this, you need to extract the first file of the distribution tape
 drive and then create a bootable cartridge or DAT tape.
 For example:
 .DS
 drive and then create a bootable cartridge or DAT tape.
 For example:
 .DS

+.ft CW

 dd if=/dev/rst0 of=bootimage bs=20b
 rcp bootimage foo:/tmp/bootimage
 <login to foo>
 dd if=/dev/rst0 of=bootimage bs=20b
 rcp bootimage foo:/tmp/bootimage
 <login to foo>


@@ -272,7 +298,7 @@ Copyright (c) 1992 Hewlett-Packard Company
 Copyright (c) 1992 Motorola Inc.
 All rights reserved.
 
 Copyright (c) 1992 Motorola Inc.
 All rights reserved.
 

-4.4BSD UNIX #3: Tue Jul  6 14:02:20 PDT 1993
+4.4BSD UNIX #1: Thu Jul  8 11:41:34 PDT 1993

     mckusick@vangogh.CS.Berkeley.EDU:/usr/obj/sys/compile/GENERIC.hp300
 HP9000/433 (33MHz MC68040 CPU+MMU+FPU, 4k on-chip physical I/D caches)
 real mem = xxx
     mckusick@vangogh.CS.Berkeley.EDU:/usr/obj/sys/compile/GENERIC.hp300
 HP9000/433 (33MHz MC68040 CPU+MMU+FPU, 4k on-chip physical I/D caches)
 real mem = xxx


@@ -293,7 +319,7 @@ will be discussed later.
 .PP
 UNIX itself then runs for the first time and begins by printing out a banner
 identifying the release and
 .PP
 UNIX itself then runs for the first time and begins by printing out a banner
 identifying the release and

-version of the system that is in use and the date that it was compiled.  
+version of the system that is in use and the date that it was compiled. 

 .PP
 Next the
 .I mem
 .PP
 Next the
 .I mem


@@ -306,7 +332,7 @@ For example, if your machine has 16Mb bytes of memory, then
 .PP
 The messages that come out next show what devices were found on
 the current processor.  These messages are described in
 .PP
 The messages that come out next show what devices were found on
 the current processor.  These messages are described in

-\fIautoconf\fP\|(4).
+.Xr autoconf (4).

 The distributed system may not have
 found all the communications devices you have
 or all the mass storage peripherals you have, especially
 The distributed system may not have
 found all the communications devices you have
 or all the mass storage peripherals you have, especially


@@ -321,7 +347,7 @@ present in the configuration description
 is printed out at boot time as the system verifies that each device
 is present.
 .PP
 is printed out at boot time as the system verifies that each device
 is present.
 .PP

-The \*(lqroot device?\*(rq prompt was printed by the system 
+The \*(lqroot device?\*(rq prompt was printed by the system

 to ask you for the name of the root filesystem to use.
 This happens because the distribution system is a \fIgeneric\fP
 system, i.e., it can be bootstrapped on a cpu with its root device
 to ask you for the name of the root filesystem to use.
 This happens because the distribution system is a \fIgeneric\fP
 system, i.e., it can be bootstrapped on a cpu with its root device


@@ -338,12 +364,13 @@ WARNING: preposterous time in filesystem \-\- CHECK AND RESET THE DATE!
 \fB#\fP
 .DE
 .PP
 \fB#\fP
 .DE
 .PP

-The \*(lqerase ...\*(rq message is part of the /.profile
+The \*(lqerase ...\*(rq message is part of the
+.Pn /.profile

 that was executed by the root shell when it started.  This message
 is present to inform you as to what values the character erase,
 line erase, and interrupt characters have been set.
 .NH 4
 that was executed by the root shell when it started.  This message
 is present to inform you as to what values the character erase,
 line erase, and interrupt characters have been set.
 .NH 4

-Step 4: restoring the root filesystem
+Step 4: (optional) restoring the root filesystem

 .PP
 UNIX is now running,
 and the \fIUNIX Programmer's manual\fP applies.  The ``#'' is the prompt
 .PP
 UNIX is now running,
 and the \fIUNIX Programmer's manual\fP applies.  The ``#'' is the prompt


@@ -362,7 +389,7 @@ or peak performance is not an issue, you can skip this step and
 proceed directly to step 5.
 .PP
 Connect a second disk to your machine.
 proceed directly to step 5.
 .PP
 Connect a second disk to your machine.

-If you bootstraped using the two disk method, you can
+If you bootstrapped using the two disk method, you can

 overwrite your initial bootstrapping disk, as it will no longer
 be needed.
 .PP
 overwrite your initial bootstrapping disk, as it will no longer
 be needed.
 .PP


@@ -394,20 +421,24 @@ Step 5: placing labels on the disks
 .PP
 \*(4B uses disk labels in the first sector of each disk to contain
 information about the geometry of the drive and the partition layout.
 .PP
 \*(4B uses disk labels in the first sector of each disk to contain
 information about the geometry of the drive and the partition layout.

-This information is written with \fIdisklabel\fP\|(8).
+This information is written with
+.Xr disklabel (8).

 .PP
 For each disk that you wish to label, run the following command:
 .DS
 \fB#\|\fP\fIdisklabel  -rw  \*(Dk\fP\fB#\fP  \fBtype\fP  \fI"optional_pack_name"\fP
 .DE
 The \fB#\fP is the unit number; the \fBtype\fP is the HP300 disk device
 .PP
 For each disk that you wish to label, run the following command:
 .DS
 \fB#\|\fP\fIdisklabel  -rw  \*(Dk\fP\fB#\fP  \fBtype\fP  \fI"optional_pack_name"\fP
 .DE
 The \fB#\fP is the unit number; the \fBtype\fP is the HP300 disk device

-name as listed in section 2.2.1 or any other name listed in /etc/disktab.
+name as listed in section 2.2.1 or any other name listed in
+.Pn /etc/disktab .

 The optional information may contain any descriptive name for the
 contents of a disk, and may be up to 16 characters long.  This procedure
 The optional information may contain any descriptive name for the
 contents of a disk, and may be up to 16 characters long.  This procedure

-will place the label on the disk using the information found in /etc/disktab
+will place the label on the disk using the information found in
+.Pn /etc/disktab

 for the disk type named.
 If you have changed the disk partition sizes,
 for the disk type named.
 If you have changed the disk partition sizes,

-you may wish to add entries for the modified configuration in /etc/disktab
+you may wish to add entries for the modified configuration in
+.Pn /etc/disktab

 before labeling the affected disks.
 .PP
 You have now completed the HP300 specific part of the installation.
 before labeling the affected disks.
 .PP
 You have now completed the HP300 specific part of the installation.


@@ -417,6 +448,46 @@ described starting in section 2.5 below.
 Booting the SPARC
 .NH 3
 Supported hardware
 Booting the SPARC
 .NH 3
 Supported hardware

+.LP
+The hardware supported by \*(4B for the SPARC is as follows:
+.TS
+center box;
+lw(1i) lw(4i).
+CPUs   T{
+SPARCstation 1 series (1, 1+, SLC, IPC) and
+SPARCstation 2 series (2, IPX).
+T}
+_
+DISKs  T{
+SCSI.
+T}
+_
+TAPEs  T{
+none.
+T}
+_
+NETWORK        T{
+SPARCstation Lance (le).
+T}
+_
+GRAPHICS       T{
+bwtwo and cgthree.
+T}
+_
+INPUT  T{
+Keyboard and mouse.
+T}
+_
+MISC   T{
+Battery-backed real time clock,
+built-in serial devices,
+Sbus SCSI controller,
+and audio device.
+T}
+.TE
+.LP
+Major items not supported include the GX (cgnine) display,
+the floppy disk, and SCSI tapes.

 .NH 3
 Limitations
 .LP
 .NH 3
 Limitations
 .LP


@@ -454,7 +525,7 @@ The Procedure
 You must have a spare disk on which to place \*(4B.
 The steps involved in bootstrapping this tape are as follows:
 .IP 1)
 You must have a spare disk on which to place \*(4B.
 The steps involved in bootstrapping this tape are as follows:
 .IP 1)

-Bring up SunOS (preferably SunOS 4.1.x / Solaris 1.x, although
+Bring up SunOS (preferably SunOS 4.1.x or Solaris 1.x, although

 Solaris 2 may work \(em this is untested).
 .IP 2)
 Attach auxiliary SCSI disk(s).  Format and label using the
 Solaris 2 may work \(em this is untested).
 .IP 2)
 Attach auxiliary SCSI disk(s).  Format and label using the


@@ -469,8 +540,10 @@ want to build other filesystems at the same time.  (By default, the
 plan to switch OSes back and forth you may want to sacrifice the
 performance gain from the new filesystem format for compatibility.)
 You can build an old-format filesystem on \*(4B by giving the \-O
 plan to switch OSes back and forth you may want to sacrifice the
 performance gain from the new filesystem format for compatibility.)
 You can build an old-format filesystem on \*(4B by giving the \-O

-option to \fInewfs\fP\|(8).
-\fIFsck\fP\|(8) can convert old format filesystems to new format
+option to
+.Xr newfs (8).
+.Xr Fsck (8)
+can convert old format filesystems to new format

 filesystems, but not vice versa,
 so you may want to initially build old format filesystems so that they
 can be mounted under SunOS,
 filesystems, but not vice versa,
 so you may want to initially build old format filesystems so that they
 can be mounted under SunOS,


@@ -479,30 +552,40 @@ satisfied that \*(4B is running properly.
 In any case, YOU MUST BUILD AN OLD-STYLE ROOT FILE SYSTEM
 so that the SunOS boot program will work.
 .IP 4)
 In any case, YOU MUST BUILD AN OLD-STYLE ROOT FILE SYSTEM
 so that the SunOS boot program will work.
 .IP 4)

-Mount the new root, then copy the SunOS /boot into place and use the
-SunOS ``installboot'' program to enable disk-based booting:
+Mount the new root, then copy the SunOS
+.Pn /boot
+into place and use the SunOS ``installboot'' program
+to enable disk-based booting:

 .DS
 .DS

+.ft CW

 # mount /dev/sd3a /mnt
 # cp /boot /mnt/boot
 # umount /dev/sd3a
 # /usr/kvm/mdec/installboot installboot bootsd /dev/rsd3a
 .DE
 # mount /dev/sd3a /mnt
 # cp /boot /mnt/boot
 # umount /dev/sd3a
 # /usr/kvm/mdec/installboot installboot bootsd /dev/rsd3a
 .DE

-The SunOS /boot will load \*(4B kernels; there is no SPARCstation
-bootstrap code on the distribution.  Note that the SunOS /boot does
-not handle the new \*(4B filesystem format.
+The SunOS
+.Pn /boot
+will load \*(4B kernels; there is no SPARCstation
+bootstrap code on the distribution.  Note that the SunOS
+.Pn /boot
+does not handle the new \*(4B filesystem format.

 .IP 5)
 .IP 5)

-Mount the new root and restore /.
+Mount the new root and restore the root.

 .DS
 .DS

+.ft CW

 # mount /dev/sd3a /mnt
 # cd /mnt
 # rrestore xf tapehost:/dev/nrst0
 .DE
 # mount /dev/sd3a /mnt
 # cd /mnt
 # rrestore xf tapehost:/dev/nrst0
 .DE

-If you have chosen to use the SunOS newfs to build /usr, you may
-mount and restore it now and skip the next step.
+If you have chosen to use the SunOS newfs to build
+.Pn /usr ,
+you may mount and restore it now and skip the next step.

 .IP 6)
 .IP 6)

-Boot the supplied kernel.  Configure the network, build /usr, mount it,
-and restore it:
+Boot the supplied kernel.  Configure the network, build
+.Pn /usr ,
+mount it, and restore it:

 .DS
 .DS

+.ft CW

 # halt
 ok boot disk3 -s                       [for old proms] OR
 ok boot sd(0,3)vmunix -s               [for new proms]
 # halt
 ok boot disk3 -s                       [for old proms] OR
 ok boot sd(0,3)vmunix -s               [for new proms]


@@ -518,6 +601,7 @@ ok boot sd(0,3)vmunix -s            [for new proms]
 .IP 7)
 At this point you may wish to set up \*(4B to reboot automatically:
 .DS
 .IP 7)
 At this point you may wish to set up \*(4B to reboot automatically:
 .DS

+.ft CW

 # halt
 ok setenv boot-from sd(0,3)vmunix      [for old proms] OR
 ok setenv boot-device disk3            [for new proms]
 # halt
 ok setenv boot-from sd(0,3)vmunix      [for old proms] OR
 ok setenv boot-device disk3            [for new proms]


@@ -533,6 +617,7 @@ If you wish to run SunOS binaries that use SunOS shared libraries, you
 simply need to copy all of the dynamic linker files from an existing
 SunOS system:
 .DS
 simply need to copy all of the dynamic linker files from an existing
 SunOS system:
 .DS

+.ft CW

 # rcp sunos-host:/etc/ld.so.cache /etc/
 # rcp sunos-host:'/usr/lib/*.so*' /usr/lib/
 .DE
 # rcp sunos-host:/etc/ld.so.cache /etc/
 # rcp sunos-host:'/usr/lib/*.so*' /usr/lib/
 .DE


@@ -540,32 +625,163 @@ The SunOS compiler and linker should be able to produce SunOS binaries
 under \*(4B, but this has not been tested.  If you plan to try it you
 will need the appropriate .sa files as well.
 .NH 2
 under \*(4B, but this has not been tested.  If you plan to try it you
 will need the appropriate .sa files as well.
 .NH 2

-Booting the DecStation
+Booting the DECstation

 .NH 3
 Supported hardware
 .NH 3
 Supported hardware

+.LP
+The hardware supported by \*(4B for the DECstation is as follows:
+.TS
+center box;
+lw(1i) lw(4i).
+CPUs   T{
+R2000 based (3100) and
+R3000 based (5000/200, 5000/20, 5000/25, 5000/1xx).
+T}
+_
+DISKs  T{
+SCSI-I (tested RZ23, RZ55, RZ57, Maxtor 8760S).
+T}
+_
+TAPEs  T{
+SCSI-I (tested DEC TK50, Archive DAT, Emulex MT02).
+T}
+_
+RS232  T{
+Internal DEC dc7085 and AMD 8530 based interfaces.
+T}
+_
+NETWORK        T{
+TURBOchannel PMAD-AA and internal LANCE based interfaces.
+T}
+_
+GRAPHICS       T{
+Terminal emulation and raw frame buffer support for
+3100 (color & monochrome),
+TURBOchannel PMAG-AA, PMAG-BA, PMAG-DV.
+T}
+_
+INPUT  T{
+Standard DEC keyboard (LK201) and mouse.
+T}
+_
+MISC   T{
+Battery-backed real time clock,
+internal and TURBOchannel PMAZ-AA SCSI interfaces.
+T}
+.TE
+.LP
+Major items not supported include the 5000/240 (there is code but not
+compiled in or tested),
+R4000 based machines, FDDI and audio interfaces.
+Diskless machines are not supported but booting kernels and bootstrapping
+over the network is supported on the 5000 series.

 .NH 3
 The Procedure
 .PP
 .NH 3
 The Procedure
 .PP

-Steps to bootstrap a system.
-.IP 1)
-Load kernel and root filesystem into memory with one of the PROM commands.
-This is the only step that depends on what type of machine you are using.
-The 'cnfg' PROM command will display what devices are available
-(DEC 5000 only).
-The 'm' argument tells the kernel to look for a root filesystem in memory.
+The first file on the distribution tape is a tar file which contains
+four files.
+The first step requires a running UNIX (or ULTRIX) system that can
+be used to extract the tar archive from the first file on the tape.
+The command:

 .DS
 .DS

-DEC 3100:      boot -f tz(0,5,0) m     # 5 is the SCSI id of the TK50
-DEC 5000:      boot 5/tz6 m            # 6 is the SCSI id of the TK50
-DEC 5000:      boot 6/tftp/bootfile m  # requires bootp on host
+.ft CW
+tar xf /dev/rmt0

 .DE
 .DE

-.IP 2)
-Format the disk if needed. Most SCSI disks are already formatted.
+will extract the following four files:

 .DS
 .DS

-format
+A) root.image: \fIdd\fP image of the root filesystem
+B) vmunix.tape: \fIdd\fP image for creating boot tapes
+C) vmunix.net: file for booting over the network
+D) root.dump: dump image of the root filesystem

 .DE
 .DE

-.IP 3)
-Label disks and create filesystems.
+There are three basic ways a system can be bootstrapped corresponding to the
+first three files.
+You may want to read the section on bootstrapping the HP300
+since many of the steps are similar.
+A spare, formatted SCSI disk is also useful.
+.NH 4
+Procedure A: copy root filesystem to disk
+.PP
+This procedure is similar to the HP300.
+If you have an extra disk, the easiest approach is to use \fIdd\fP\|(1)
+under ULTRIX to copy the root filesystem image to the beginning
+of the spare disk. 
+The root filesystem image includes a disklabel and bootblock along with the
+root filesystem.
+An example command to copy the image to the beginning of a disk is:
+.DS
+.ft CW
+dd if=root.image of=/dev/rz1c bs=20b
+.DE
+The actual special file syntax will vary depending on unit numbers and
+the version of ULTRIX that is running.
+This system is now ready to boot.
+You will probably want to change the disk label
+to create reasonable partitions for your machine (see section 4.2).
+You can then proceed to section 2.5 to install the rest of the system.
+.NH 4
+Procedure B: bootstrap from tape
+.PP
+If you have only a single machine with a single disk,
+you need to use the more difficult approach of booting a
+kernel and mini-root from tape or the network, and using it to restore
+the root filesystem.
+.PP
+First, you will need to create a boot tape. This can be done using
+\fIdd\fP as in the following example.

 .DS
 .DS

+.ft CW
+dd if=vmunix.tape of=/dev/nrmt0 bs=1b
+dd if=root.dump of=/dev/nrmt0 bs=20b
+.DE
+The actual special file syntax for the tape drive will vary depending on
+unit numbers, tape device and the version of ULTRIX that is running.
+.PP
+The first file on the boot tape contains a boot header, kernel, and
+mini-root file system that the PROM can copy into memory.
+Installing from tape has only been tested
+on a 3100 and a 5000/200 using a TK50 tape drive. Here are two example
+PROM commands to boot from tape.
+.DS
+.ft CW
+DEC 3100:    boot \-f tz(0,5,0) m    # 5 is the SCSI id of the TK50
+DEC 5000:    boot 5/tz6 m           # 6 is the SCSI id of the TK50
+.DE
+The `m' argument tells the kernel to look for a root filesystem in memory.
+Next you should proceed to section 2.4.3 to build a disk-based root filesystem.
+.NH 4
+Procedure C: bootstrap over the network
+.PP
+You will need a host machine that is running the \fIbootp\fP server 
+with the vmunix.net file installed in the default directory defined by the
+configuration file for \fIbootp\fP.
+Here are two example PROM commands to boot across the net:
+.DS
+.ft CW
+DEC 3100:      boot \-f tftp()vmunix.net m
+DEC 5000:      boot 6/tftp/vmunix.net m
+.DE
+This command should load the kernel and mini-root into memory and
+run the same as the tape install (procedure B).
+The rest of the steps are the same except you will need to
+execute the following to start the networking:
+.DS
+.ft CW
+# mount -u /
+# echo 127.0.0.1 localhost >> /etc/hosts
+# echo <your.host.inet.number> myname.my.domain myname >> /etc/hosts
+# echo <friend.host.inet.number> myfriend.my.domain myfriend >> /etc/hosts
+# ifconfig le0 inet myname
+.DE
+Next you should proceed to section 2.4.3 to build a disk-based root filesystem.
+.NH 3
+Label disk and create the root filesystem.
+.LP
+There are five steps to create a disk-based root filesystem.
+.IP 1)
+Label the disk.
+.DS
+.ft CW

 # disklabel -W /dev/rrz?c              # This enables writing the label
 # disklabel -w -r -B /dev/rrz?c $DISKTYPE
 # newfs /dev/rrz?a
 # disklabel -W /dev/rrz?c              # This enables writing the label
 # disklabel -w -r -B /dev/rrz?c $DISKTYPE
 # newfs /dev/rrz?a


@@ -573,45 +789,72 @@ Label disks and create filesystems.
 # fsck /dev/rrz?a
 \&...
 .DE
 # fsck /dev/rrz?a
 \&...
 .DE

-Supported disk types are listed in /etc/disktab.
-Feel free to add to this list.
-.IP 4)
+Supported disk types are listed in
+.Pn /etc/disktab .
+.IP 3)

 Restore the root filesystem.
 .DS
 Restore the root filesystem.
 .DS

+.ft CW

 # mount \-u /
 # mount /dev/rz?a /a
 # cd /a
 # mount \-u /
 # mount /dev/rz?a /a
 # cd /a

+.DE
+.ti +0.4i
+If you are restoring locally (procedure B), run:
+.DS
+.ft CW

 # mt \-f /dev/nrmt0 rew
 # restore \-xsf 2 /dev/rmt0
 # mt \-f /dev/nrmt0 rew
 # restore \-xsf 2 /dev/rmt0

+.DE
+.ti +0.4i
+If you are restoring across the net (procedure c), run:
+.DS
+.ft CW
+# rrestore xf myfriend:/path/to/root.dump
+.DE
+.ti +0.4i
+When the restore finishes, clean up with:
+.DS
+.ft CW

 # cd /
 # sync
 # umount /a
 # fsck /dev/rz?a
 .DE
 # cd /
 # sync
 # umount /a
 # fsck /dev/rz?a
 .DE

-.IP 5)
-Initialize the PROM monitor to boot automatically.
+.IP 4)
+Reset the system and initialize the PROM monitor to boot automatically.

 .DS
 .DS

-# halt \-q
-
-DEC 3100:      setenv bootpath boot -f rz(0,?,0)vmunix
+.ft CW
+DEC 3100:      setenv bootpath boot \-f rz(0,?,0)vmunix

 DEC 5000:      setenv bootpath 5/rz?/vmunix -a
 .DE
 DEC 5000:      setenv bootpath 5/rz?/vmunix -a
 .DE

-.IP 6)
-After booting UNIX, you will need to create /dev/mouse in order to
-run X windows. type `link /dev/xx /dev/mouse' where xx is one of the
-following:
+.IP 5)
+After booting UNIX, you will need to create
+.Pn /dev/mouse
+to run X windows as in the following example.
+.DS
+.ft CW
+rm /dev/mouse
+ln /dev/xx /dev/mouse
+.DE
+The 'xx' should be one of the following:

 .DS
 pm0    raw interface to PMAX graphics devices
 cfb0   raw interface to turbochannel PMAG-BA color frame buffer
 xcfb0  raw interface to maxine graphics devices
 mfb0   raw interface to mono graphics devices
 .DE
 .DS
 pm0    raw interface to PMAX graphics devices
 cfb0   raw interface to turbochannel PMAG-BA color frame buffer
 xcfb0  raw interface to maxine graphics devices
 mfb0   raw interface to mono graphics devices
 .DE

+You can then proceed to section 2.5 to install the rest of the system.

 .NH 2
 Installing the rest of the system
 .PP
 .NH 2
 Installing the rest of the system
 .PP

-All architectures now have a root filesystem up and running and now
+All architectures now have a root filesystem up and running and

 proceed from this point to extract the rest of the data from the tape.
 proceed from this point to extract the rest of the data from the tape.

-At a minimum you need to set up the /var and /usr filesystems.
+At a minimum you need to set up the
+.Pn /var
+and
+.Pn /usr
+filesystems.

 You may also want to extract some or all the program sources.
 You might wish to review the disk configuration information in section
 4.2 before continuing; the partitions used below are those most appropriate
 You may also want to extract some or all the program sources.
 You might wish to review the disk configuration information in section
 4.2 before continuing; the partitions used below are those most appropriate


@@ -646,11 +889,16 @@ is the partition)
 (this takes about 15-20 minutes)
 .TE
 .DE
 (this takes about 15-20 minutes)
 .TE
 .DE

-If no disk label has been installed on the disk, the \fInewfs\fP
+If no disk label has been installed on the disk, the
+.Xr newfs

 command will require a third argument to specify the disk type,
 command will require a third argument to specify the disk type,

-using one of the names in /etc/disktab.
-If the tape had been rewound or positioned incorrectly before the \fItar\fP,
-to extract /var it may be repositioned by the following commands.
+using one of the names in
+.Pn /etc/disktab .
+If the tape had been rewound or positioned incorrectly before the
+.Xr tar ,
+to extract
+.Pn /var
+it may be repositioned by the following commands.

 .DS
 \fB#\fP \fImt -t /dev/nr\*(Mt0 rew\fP
 \fB#\fP \fImt -t /dev/nr\*(Mt0 fsf 3\fP
 .DS
 \fB#\fP \fImt -t /dev/nr\*(Mt0 rew\fP
 \fB#\fP \fImt -t /dev/nr\*(Mt0 fsf 3\fP


@@ -674,12 +922,14 @@ lw(2i) l.
 .TE
 .DE
 .PP
 .TE
 .DE
 .PP

-You can check the consistency of the /usr filesystem by doing
+You can check the consistency of the
+.Pn /usr
+filesystem by doing

 .DS
 \fB#\fP \fIfsck /dev/r\*(Dk#c\fP
 .DE
 The output from
 .DS
 \fB#\fP \fIfsck /dev/r\*(Dk#c\fP
 .DE
 The output from

-.I fsck
+.Xr fsck

 should look something like:
 .DS
 .B
 should look something like:
 .DS
 .B


@@ -695,12 +945,15 @@ should look something like:
 .DE
 .PP
 If there are inconsistencies in the filesystem, you may be prompted
 .DE
 .PP
 If there are inconsistencies in the filesystem, you may be prompted

-to apply corrective action; see the \fIfsck\fP(8) or \fIFsck \(en The UNIX
-File System Check Program\fP (SMM:3) for more details.
+to apply corrective action; see the
+.Xr fsck (8)
+or \fIFsck \(en The UNIX File System Check Program\fP (SMM:3) for more details.

 .PP
 .PP

-To use the /usr filesystem, you should now remount it with:
+To use the
+.Pn /usr
+filesystem, you should now remount it with:

 .DS
 .DS

-\fB#\fP \fI/etc/mount /dev/\*(Dk#c /usr\fP
+\fB#\fP \fI/sbin/mount /dev/\*(Dk#c /usr\fP

 .DE
 .PP
 If you are using 6250bpi tapes, the second reel of the
 .DE
 .PP
 If you are using 6250bpi tapes, the second reel of the


@@ -718,8 +971,10 @@ point on the 8mm tape.
 If you received a distribution on 8mm tape,
 there is one additional tape file on the distribution tape
 which has not been installed to this point; it contains the
 If you received a distribution on 8mm tape,
 there is one additional tape file on the distribution tape
 which has not been installed to this point; it contains the

-sources for X11R5 in \fItar\fP\|(1) format.  As distributed,
-X11R5 should be placed in /usr/src/X11R5.
+sources for X11R5 in
+.Xr tar (1)
+format.  As distributed, X11R5 should be placed in
+.Pn /usr/src/X11R5 .

 .DS
 \fB#\fP \fImkdir /usr/src/X11R5\fP
 \fB#\fP \fIchmod 755 /usr/src/X11R5\fP
 .DS
 \fB#\fP \fImkdir /usr/src/X11R5\fP
 \fB#\fP \fIchmod 755 /usr/src/X11R5\fP


@@ -732,11 +987,14 @@ Additional conversion information
 .PP
 After setting up the new \*(4B filesystems, you may restore the user
 files that were saved on tape before beginning the conversion.
 .PP
 After setting up the new \*(4B filesystems, you may restore the user
 files that were saved on tape before beginning the conversion.

-Note that the \*(4B \fIrestore\fP program does its work on a mounted
-filesystem using normal system operations.  This means that filesystem
-dumps may be restored even if the characteristics of the filesystem changed.
-To restore a dump tape for, say, the /a filesystem
-something like the following would be used:
+Note that the \*(4B
+.Xr restore
+program does its work on a mounted filesystem using normal system operations.
+This means that filesystem dumps may be restored even
+if the characteristics of the filesystem changed.
+To restore a dump tape for, say, the
+.Pn /a
+filesystem something like the following would be used:

 .DS
 \fB#\fP \fImkdir /a\fP
 \fB#\fP \fInewfs \*(Dk#c\fI
 .DS
 \fB#\fP \fImkdir /a\fP
 \fB#\fP \fInewfs \*(Dk#c\fI


@@ -745,7 +1003,11 @@ something like the following would be used:
 \fB#\fP \fIrestore x\fP
 .DE
 .PP
 \fB#\fP \fIrestore x\fP
 .DE
 .PP

-If \fItar\fP images were written instead of doing a dump, you should
+If
+.Xr tar
+images were written instead of doing a dump, you should

 be sure to use its `\-p' option when reading the files back.  No matter
 how you restore a filesystem, be sure to unmount it and and check its
 be sure to use its `\-p' option when reading the files back.  No matter
 how you restore a filesystem, be sure to unmount it and and check its

-integrity with \fIfsck\fP(8) when the job is complete.
+integrity with
+.Xr fsck (8)
+when the job is complete.