Subject: Please proofread: revised install docs for OF 1.1.22 (Apple
To: None <firstname.lastname@example.org>
From: Michael Wolfson <email@example.com>
Date: 10/25/2000 22:57:23
Since I don't have access to an OF 1.1.22 machine, I need y'all to give me
some feedback on this.
In particular, I need to know answers to the following questions:
How do you enter OF? Command-Option-O-F on an ADB keyboard? When do you
have to hold it down (does the system "chime" like other PowerMacs, or just
Can you netboot using your internal ethernet (I ask since OF 1.0.5 can't)?
This is a bit sketchy, since I'm given to understand that the NetBSD kernel
has troubles with the internal ethernet.
Does the "Apple PCI Ethernet Card" have OF drivers? Can you netboot from
it? What's its OF device name?
Run the following command in OF:
dev enet .properties
Does the local-mac-address variable match with what AIX says is your MAC
address (arp -a)? Which MAC address does your system use when netbooting?
Can you boot from a hybrid ISO/HFS CD-ROM (again, OF 1.0.5 can't)?
Do your OF settings get cleared when you boot into AIX (they do when OF
1.0.5 is booted into MacOS)?
Can you give me some examples of the OF device you use to boot from CD-ROM?
What are the default values of real-base and load-base in OF 1.1.22?
Do you need to set real-base to F00000 to load a > 3 MB kernel?
Do you need to set load-base to load ofwboot.xcf?
Do changing either of these two values mess up AIX?
What is the AIX command to write the floppy image to a disk?
Can you share partitions with AIX on a drive, and what tool do you use to
partition your drive?
Can OF 1.1.22 load ofwboot.xcf from an AIX filesystem?
Is there no screen device in OF 1.1.22 (i.e. why must you use serial console)?
Just to double-check: "Port 2" is "ttya", right?
And just to confirm: OF 1.1.22 can boot from the following media: ethernet,
MS-DOS, `partition zero', and ISO. Right?
Bootable media in Open Firmware 1.1.22
Users have reported that the NetBSD kernel does not work well with the
on-board MACE-based ethernet (the one that requires an Apple AAUI don-
gle). If your system does not have the Apple PCI Ethernet Card, you may
need to purchase and install another ethernet card in your Apple Network
1. Discussion of what's available
There are four methods of opening a file in OF 1.1.22: from an MS-
DOS filesystem, over ethernet, from an ISO 9660 (CD-ROM) filesystem,
or from `partition zero'. In all cases except `partition zero',
your system must open the `ofwboot.xcf' bootloader to load the ker-
nel. The `partition zero' method loads a primary bootloader called
`bootxx' which then loads an `ofwboot' bootloader, which then loads
the kernel. The `ofwboot' bootloader is functionally identical to
We can almost immediately discount use of the MS-DOS filesystem, as
neither the ofwboot.xcf bootloader or the kernel can read files di-
rectly from it.
As for ethernet, you can run your entire system diskless or netboot
only the files necessary to boot (i.e. the bootloader and the in-
stallation kernel), but you must have root access on another UNIX
machine on your subnet.
If you do not have access to a DHCP server running NFS, then you
must load ofwboot[.xcf] either from an ISO 9660 (CD-ROM) disk or
from `partition zero'.
Once ofwboot[.xcf] has loaded, it can open a kernel from only three
sources: over ethernet (NFS), from a NetBSD filesystem (FFS), or
from a CD-ROM filesystem (ISO 9660).
The boot floppy image provided with the distribution sets has a
`partition zero' bootloader and a NetBSD filesystem with an instal-
When you are first installing NetBSD you will not have any NetBSD
filesystems on your machine, unless you use the boot floppy. This
leaves one option: ISO 9660.
If you will be running your system diskless (i.e. entirely over NFS,
not using any local hard drives), then you do not need to run the
installer although you may still do so.
You must run the installer to place NetBSD on a hard drive on your
2. The three common installation techniques (and one not)
o Create the boot floppy. Use some tool to write the boot floppy
image to a floppy disk, and boot from that. The primary boot-
loader (in `partition zero') will load `ofwboot' which will load
the installation kernel. Alternatively, you may
o Create an ISO 9660 CD-ROM. Place ofwboot.xcf and the installa-
tion kernel at the top level of the CD. You may, while you're
at it, also place the NetBSD 1.5_FOO distribution sets on the
disk. You will have OF load ofwboot.xcf from the disk, and it
will then load the installation kernel. If you do not have ac-
cess to a CD-R burner, then you must
o Boot over the ethernet. You will need to set up the DHCP daemon
in BOOTP compatable mode, the TFTP daemon, and the NFS daemons
on your netboot server. You will tell OF to boot over ethernet,
and it will send a BOOTP request, which will tell OF what your
system's IP address is, and where its bootloader can be down-
loaded via TFTP. Once OF has downloaded the bootloader via
TFTP, it will then load the installation kernel via an NFS con-
o If all else fails, write the floppy disk image If0 0If1 1If2
2If3 You will need to find a spare bootable drive (i.e. SCSI or
IDE). You'll use some tool to write the floppy disk image to
your spare drive, and boot from that drive. The floppy image
has a `partition zero' bootloader which ultimately loads the in-
Open Firmware 1.1.22 System Preparation
1. Getting to the OF prompt
You need to hold down a special key combination when your system
boots. After the chime starts, but before it stops, hold down the
`Command', `Option', `o', and `f' keys (the `Command' key looks like
a four-leaf clover or an open apple, and the `Option' key may look
like a two-way switch with four straight line segments).
Your Apple Network Server has defaulted to using a serial console.
You must hook up a serial console (38400 bps, 8 bits, no parity, 1
stop bit, no handshaking) to `Port 2' (which is the `ttya' device in
Now, you should see the OF command prompt:
2. Setting OF up to boot NetBSD
You must set some OF variables before NetBSD can boot.
0 > setenv load-base 600000
0 > setenv real-base F00000
0 > reset-all
The last command reboots your machine so that the real-base setting
If you will be netbooting your system, you can look up your MAC ad-
0 > dev enet .properties
local-mac-address CCCCCCCC CCCC