[src/trunk]: src/distrib/notes macppc/hardware:

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

details:   https://anonhg.NetBSD.org/src/rev/d2dc6296d248
branches:  trunk
changeset: 509835:d2dc6296d248
user:      mbw <mbw%NetBSD.org@localhost>
date:      Mon May 14 07:46:56 2001 +0000

description:
macppc/hardware:
define what "boot media" and "distribution media" mean

macppc/install:
corrected the text in example of booting system
corrected partition number to use in example of booting from HFS partition
added example of how to use MacOS X to print partition table using pdisk

macppc/prep:
actually drive setup 1.8.1 (ships with MacOS 9.0) works too
actually describe what netbsd.ram.gz is (installation kernel)

common/postinstall:
macppc uses vt100 for console, not vt220
describe how to mount root filesystem to edit /etc/rc.conf

diffstat:

 distrib/notes/common/postinstall |  11 +++++++++--
 distrib/notes/macppc/hardware    |  16 ++++++++++++++--
 distrib/notes/macppc/install     |  19 ++++++++++++++-----
 distrib/notes/macppc/prep        |  12 ++++++++----
 4 files changed, 45 insertions(+), 13 deletions(-)

diffs (169 lines):

diff -r 663d90c36c41 -r d2dc6296d248 distrib/notes/common/postinstall
--- a/distrib/notes/common/postinstall  Mon May 14 07:41:30 2001 +0000
+++ b/distrib/notes/common/postinstall  Mon May 14 07:46:56 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: postinstall,v 1.24 2001/05/13 23:25:37 mbw Exp $
+.\"    $NetBSD: postinstall,v 1.25 2001/05/14 07:46:56 mbw Exp $
 .\"
 .\" Copyright (c) 1999-2001 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -59,6 +59,10 @@
 .Ic hp300h
 for a local console, or whatever is appropriate for your serial console.
 .\}
+.el .ie r_macppc \{\
+.Ic vt100
+(or whatever is appropriate for your terminal type)
+.\}
 .el .ie r_pmax \{\
 the correct terminal type as discussed in the
 .Sx Once you've booted the diskimage
@@ -81,7 +85,9 @@
 At this point, you need to configure at least
 one file in the
 .Pa /etc
-directory. Change to the
+directory. You will need to mount your root filesystem read/write with:
+.Dl # Ic "/sbin/mount -u -w /"
+Change to the
 .Pa /etc
 directory and take a look at the
 .Pa /etc/rc.conf
@@ -109,6 +115,7 @@
 .Pp
 .Dl # Ic "mount /usr"
 .ie     r_hp300 .Dl # Ic "export TERM=hp300h"
+.el .ie r_macppc .Dl # Ic "export TERM=vt100"
 .el .ie r_pmax  .Dl # Ic "export TERM=termtype"
 .el .ie r_sparc .Dl # Ic "export TERM=sun"
 .el             .Dl # Ic "export TERM=vt220"
diff -r 663d90c36c41 -r d2dc6296d248 distrib/notes/macppc/hardware
--- a/distrib/notes/macppc/hardware     Mon May 14 07:41:30 2001 +0000
+++ b/distrib/notes/macppc/hardware     Mon May 14 07:46:56 2001 +0000
@@ -1,4 +1,4 @@
-.\"$NetBSD: hardware,v 1.10 2001/05/13 23:25:38 mbw Exp $
+.\"$NetBSD: hardware,v 1.11 2001/05/14 07:46:57 mbw Exp $
 .
 Currently,
 .Nx*M
@@ -404,7 +404,19 @@
 .Ss2 Supported boot devices and media
 .
 Each version of Open Firmware supports different devices and media that you
-may boot from.
+may boot from.  We define the terms
+.Dq bootable media
+as the media (hard drive, CD-R, ethernet) that will be used to bootstrap
+your \*M system into
+.Nx No Ns ,
+and
+.Dq distribution sets
+or
+.Dq distribution media
+as the media (hard drive, CD-R, ethernet) that contains the files that
+will be installed to generate a working 
+.Nx
+system onto your destination media.
 .Pp
 Go to the
 .Nx*M
diff -r 663d90c36c41 -r d2dc6296d248 distrib/notes/macppc/install
--- a/distrib/notes/macppc/install      Mon May 14 07:41:30 2001 +0000
+++ b/distrib/notes/macppc/install      Mon May 14 07:46:56 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: install,v 1.10 2001/05/13 23:25:38 mbw Exp $
+.\"    $NetBSD: install,v 1.11 2001/05/14 07:46:57 mbw Exp $
 .
 .Ss2 Booting the installer
 .
@@ -203,7 +203,11 @@
 You may find that your first HFS or HFS+ partition might be as high as
 partition 9.
 You may need to keep trying higher partition numbers until you find the one
-that has your bootloader.
+that has your bootloader.  If you're running 
+.Tn MacOS X
+you can run the following command to print out the partition table on your
+drive:
+.Dl % Ic "sudo pdisk /dev/disk0 -dump"
 .Pp
 If bootloader is on a different partition from the
 .Nx
@@ -216,7 +220,7 @@
 .Pp
 .Dl 0 > Ic "boot scsi/sd@0:9,ofwboot.xcf scsi/sd@0:9,boot.fs"
 .Dl 0 > Ic "boot ide0/disk@0:10,ofwboot.xcf ide0/disk@0:9,boot.fs"
-.Dl 0 > Ic "boot hd:8,ofwboot.xcf hd:8,boot.fs"
+.Dl 0 > Ic "boot hd:9,ofwboot.xcf hd:9,boot.fs"
 .bullet)
 .
 .Ss2 Example of a normal boot
@@ -262,7 +266,9 @@
  using 2483 buffers containing 9932 KB of memory
  [...]
  erase ^H, werase ^W, kill ^U, intr ^C, status ^T
- (I)nstall, (S)hell or (H)alt ? 
+ Terminal type? [vt100]
+ Erase is backspace.
+ (I)nstall, (S)hell or (H)alt ?
 .disp)
 .
 .Ss2 Common Problems and Error Messages
@@ -430,8 +436,10 @@
 .Dl 0 > Ic "setenv auto-boot? true"
 .Dl 0 > Ic "setenv boot-device scsi/sd@0:0"
 .Dl 0 > Ic "setenv boot-file netbsd"
+.Dl 0 > Ic "reset-all"
 .Pp
-replacing 
+The last command resets the system so that these settings are stored.
+Replace
 .Ic scsi/sd@0:0
 with the actual device you will be booting from.  If you find that your
 system tries booting before your hard drive has spun up, you may need to
@@ -448,4 +456,5 @@
 .Dl 0 > Ic "setenv boot-device ide0/disk@0:8,ofwboot.xcf"
 .Dl 0 > Ic "setenv boot-file ide0/disk@0:13,/netbsd"
 .Dl 0 > Ic "setenv boot-command boot"
+.Dl 0 > Ic "reset-all"
 .Pp
diff -r 663d90c36c41 -r d2dc6296d248 distrib/notes/macppc/prep
--- a/distrib/notes/macppc/prep Mon May 14 07:41:30 2001 +0000
+++ b/distrib/notes/macppc/prep Mon May 14 07:46:56 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: prep,v 1.13 2001/05/13 23:25:38 mbw Exp $
+.\"    $NetBSD: prep,v 1.14 2001/05/14 07:46:57 mbw Exp $
 .
 .Ss2 Prepare yourself
 .
@@ -1086,7 +1086,9 @@
 .Pp
 Place
 .Pa ofwboot.xcf
-and the installation kernel at the top level of the CD.
+and the installation kernel 
+.Pa netbsd.ram.gz
+at the top level of the CD.
 You may also place the
 .Nx \*V
 distribution sets on the disk.
@@ -1166,7 +1168,9 @@
 .Pp
 Place
 .Pa ofwboot.xcf
-and the installation kernel at the top level of the CD. Make sure that the
+and the installation kernel 
+.Pa netbsd.ram.gz
+at the top level of the CD. Make sure that the
 bootloader is present on the HFS partition, and the kernel is on the ISO
 partition. You may also place the
 .Nx \*V
@@ -1555,7 +1559,7 @@
 .Tn MacOS .
 You will need to use the 
 .Tn MacOS
-Drive Setup tool (versions 1.9.1 and later are
+Drive Setup tool (versions 1.8.1 and later are
 known to work) to partition the hard drive you will be using for
 .Nx .
 Drive Setup will erase the contents of your drive -- it does not preserve