en/boot-installer/powerpc.xml

<!-- retain these comments for translator revision tracking -->
<!-- $Id$ -->

  <sect2 arch="powerpc" id="boot-cd"><title>Booting from a CD-ROM</title>

&boot-installer-intro-cd.xml;

<para>

Currently, the only &arch-title; subarchitectures that support CD-ROM
booting are PReP (though not all systems) and New World PowerMacs.
On PowerMacs, hold the <keycap>c</keycap> key, or else the combination of
<keycap>Command</keycap>, <keycap>Option</keycap>,
<keycap>Shift</keycap>, and <keycap>Delete</keycap>
keys together while booting to boot from the CD-ROM.

</para><para>

OldWorld PowerMacs will not boot a Debian CD, because OldWorld
computers relied on a Mac OS ROM CD boot driver to be present on the CD,
and a free-software version of this driver is not available. All
OldWorld systems have floppy drives, so use the floppy drive to launch
the installer, and then point the installer to the CD for the needed
files.

</para><para>

If your system doesn't boot directly from CD-ROM, you can still use
the CD-ROM to install the system. On NewWorlds, you can also use an
OpenFirmware command to boot from the CD-ROM manually. Follow the
instructions in <xref linkend="boot-newworld"/> for booting from
the hard disk, except use the path to <command>yaboot</command> on the
CD at the OF prompt, such as

<informalexample><screen>
0 &gt; boot cd:,\install\yaboot
</screen></informalexample>

</para>
  </sect2>

  <sect2 arch="powerpc" id="install-drive">
  <title>Booting from Hard Disk</title>

&boot-installer-intro-hd.xml;

<!--
  <sect3><title>Booting CHRP from OpenFirmware</title>

<para>

  <emphasis>Not yet written.</emphasis>

</para>
   </sect3>
-->

   <sect3><title>Booting OldWorld PowerMacs from MacOS</title>
<para>

If you set up BootX in <xref linkend="files-oldworld"/>, you can
use it to boot into the installation system. Double click the
<guiicon>BootX</guiicon> application icon. Click on the
<guibutton>Options</guibutton> button and select <guilabel>Use
Specified RAM Disk</guilabel>. This will give you the
chance to select the <filename>ramdisk.image.gz</filename> file. You
may need to select the <guilabel>No Video Driver</guilabel> checkbox,
depending on your hardware. Then click the
<guibutton>Linux</guibutton> button to shut down MacOS and launch the
installer.

</para>
   </sect3>


  <sect3 id="boot-newworld">
  <title>Booting NewWorld Macs from OpenFirmware</title>
<para>

You will have already placed the <filename>vmlinux</filename>,
<filename>initrd.gz</filename>, <filename>yaboot</filename>, and
<filename>yaboot.conf</filename> files at the root level of your HFS
partition in <xref linkend="files-newworld"/>.
You will now have to boot into OpenFirmware (see <xref linkend="invoking-openfirmware"/>).
At the prompt, type

<informalexample><screen>
0 &gt; boot hd:<replaceable>x</replaceable>,yaboot
</screen></informalexample>

replacing <replaceable>x</replaceable> with the partition number of
the HFS partition where the
kernel and yaboot files were placed, followed by a &enterkey;. On some
machines, you may need to use <userinput>ide0:</userinput> instead of
<userinput>hd:</userinput>. In a few more seconds you will see a
yaboot prompt

<informalexample><screen>
boot:
</screen></informalexample>

At yaboot's <prompt>boot:</prompt> prompt, type either
<userinput>install</userinput> or <userinput>install video=ofonly</userinput>
followed by a &enterkey;.  The
<userinput>video=ofonly</userinput> argument is for maximum
compatibility; you can try it if <userinput>install</userinput>
doesn't work. The Debian installation program should start.

</para>
   </sect3>
  </sect2>

  <sect2 arch="powerpc" condition="bootable-usb" id="usb-boot">
  <title>Booting from USB memory stick</title>
<para>

Currently, NewWorld PowerMac systems are known to support USB booting.

</para>

<para>

Make sure you have prepared everything from <xref
linkend="boot-usb-files"/>. To boot a Macintosh system from a USB stick,
you will need to use the Open Firmware prompt, since Open Firmware does
not search USB storage devices by default.
<!-- TODO: although it could be made to; watch this space -->
See <xref linkend="invoking-openfirmware"/>.

</para><para>

You will need to work out where the USB storage device appears in the
device tree, since at the moment <command>ofpath</command> cannot work
that out automatically. Type <userinput>dev / ls</userinput> and
<userinput>devalias</userinput> at the Open Firmware prompt to get a
list of all known devices and device aliases. On the author's system
with various types of USB stick, paths such as
<filename>usb0/disk</filename>, <filename>usb0/hub/disk</filename>,
<filename>/pci@f2000000/usb@1b,1/disk@1</filename>, and
<filename>/pci@f2000000/usb@1b,1/hub@1/disk@1</filename> work.

</para><para>

Having worked out the device path, use a command like this to boot the
installer:

<informalexample><screen>
boot <replaceable>usb0/disk</replaceable>:<replaceable>2</replaceable>,\\:tbxi
</screen></informalexample>

The <replaceable>2</replaceable> matches the Apple_HFS or
Apple_Bootstrap partition onto which you copied the boot image earlier,
and the <userinput>,\\:tbxi</userinput> part instructs Open Firmware to
boot from the file with an HFS file type of "tbxi" (i.e.
<command>yaboot</command>) in the directory previously blessed with
<command>hattrib -b</command>.

</para><para>

The system should now boot up, and you should be presented with the
<prompt>boot:</prompt> prompt. Here you can enter optional boot
arguments, or just hit &enterkey;.

</para><warning><para>

This boot method is new, and may be difficult to get to work on some
NewWorld systems. If you have problems, please file an installation
report, as explained in <xref linkend="submit-bug"/>.

</para></warning>
  </sect2>

  <sect2 arch="powerpc" id="boot-tftp"><title>Booting with TFTP</title>

&boot-installer-intro-net.xml;

<para>

Currently, PReP and New World PowerMac systems support netbooting.

</para><para>

On machines with Open Firmware, such as NewWorld Power Macs, enter the
boot monitor (see <xref linkend="invoking-openfirmware"/>) and
use the command

<informalexample><screen>
0 &gt; boot enet:0
</screen></informalexample>

If this doesn't work, you might have to add the filename like this:

<informalexample><screen>
0 &gt; boot enet:0,yaboot
</screen></informalexample>

PReP and CHRP boxes
may have different ways of addressing the network.  On a PReP machine,
you should try

<informalexample><screen>
boot net:<replaceable>server_ipaddr</replaceable>,<replaceable>file</replaceable>,<replaceable>client_ipaddr</replaceable>
</screen></informalexample>

On some PReP systems (e.g. Motorola PowerStack machines) the command
<userinput>help boot</userinput> may give a description of syntax and
available options.

</para>
  </sect2>


  <sect2 arch="powerpc" condition="supports-floppy-boot">
  <title>Booting from Floppies</title>
<para>

Booting from floppies is supported for &arch-title;, although it is
generally only applicable for OldWorld systems. NewWorld systems are
not equipped with floppy drives, and attached USB floppy drives are
not supported for booting.

</para><para>

You will have already downloaded the floppy images you needed and
created floppies from the images in <xref linkend="create-floppy"/>.

</para><para>

To boot from the <filename>boot-floppy-hfs.img</filename> floppy,
place it in floppy drive after shutting the system down, and before
pressing the power-on button.

</para><note><para>
For those not familiar with Macintosh
floppy operations: a floppy placed in the machine prior to boot will
be the first priority for the system to boot from. A floppy without a
valid boot system will be ejected, and the machine will then check for
bootable hard disk partitions.

</para></note><para>

After booting, the <filename>root.bin</filename> floppy is
requested. Insert the root floppy and press &enterkey;. The installer
program is automatically launched after the root system has been
loaded into memory.

</para>
  </sect2>


  <sect2 arch="powerpc"><title>PowerPC Boot Parameters</title>
<para>

Many older Apple monitors used a 640x480 67Hz mode. If your video
appears skewed on an older Apple monitor, try appending the boot
argument <userinput>video=atyfb:vmode:6</userinput> , which will
select that mode for most Mach64 and Rage video hardware. For Rage 128
hardware, this changes to
<userinput>video=aty128fb:vmode:6</userinput> .

</para>
  </sect2>
1	<!-- retain these comments for translator revision tracking -->
2	<!-- $Id$ -->
3
4	<sect2 arch="powerpc" id="boot-cd"><title>Booting from a CD-ROM</title>
5
6	&boot-installer-intro-cd.xml;
7
8	<para>
9
10	Currently, the only &arch-title; subarchitectures that support CD-ROM
11	booting are PReP (though not all systems) and New World PowerMacs.
12	On PowerMacs, hold the <keycap>c</keycap> key, or else the combination of
13	<keycap>Command</keycap>, <keycap>Option</keycap>,
14	<keycap>Shift</keycap>, and <keycap>Delete</keycap>
15	keys together while booting to boot from the CD-ROM.
16
17	</para><para>
18
19	OldWorld PowerMacs will not boot a Debian CD, because OldWorld
20	computers relied on a Mac OS ROM CD boot driver to be present on the CD,
21	and a free-software version of this driver is not available. All
22	OldWorld systems have floppy drives, so use the floppy drive to launch
23	the installer, and then point the installer to the CD for the needed
24	files.
25
26	</para><para>
27
28	If your system doesn't boot directly from CD-ROM, you can still use
29	the CD-ROM to install the system. On NewWorlds, you can also use an
30	OpenFirmware command to boot from the CD-ROM manually. Follow the
31	instructions in <xref linkend="boot-newworld"/> for booting from
32	the hard disk, except use the path to <command>yaboot</command> on the
33	CD at the OF prompt, such as
34
35	<informalexample><screen>
36	0 > boot cd:,\install\yaboot
37	</screen></informalexample>
38
39	</para>
40	</sect2>
41
42	<sect2 arch="powerpc" id="install-drive">
43	<title>Booting from Hard Disk</title>
44
45	&boot-installer-intro-hd.xml;
46
47	<!--
48	<sect3><title>Booting CHRP from OpenFirmware</title>
49
50	<para>
51
52	<emphasis>Not yet written.</emphasis>
53
54	</para>
55	</sect3>
56	-->
57
58	<sect3><title>Booting OldWorld PowerMacs from MacOS</title>
59	<para>
60
61	If you set up BootX in <xref linkend="files-oldworld"/>, you can
62	use it to boot into the installation system. Double click the
63	<guiicon>BootX</guiicon> application icon. Click on the
64	<guibutton>Options</guibutton> button and select <guilabel>Use
65	Specified RAM Disk</guilabel>. This will give you the
66	chance to select the <filename>ramdisk.image.gz</filename> file. You
67	may need to select the <guilabel>No Video Driver</guilabel> checkbox,
68	depending on your hardware. Then click the
69	<guibutton>Linux</guibutton> button to shut down MacOS and launch the
70	installer.
71
72	</para>
73	</sect3>
74
75
76	<sect3 id="boot-newworld">
77	<title>Booting NewWorld Macs from OpenFirmware</title>
78	<para>
79
80	You will have already placed the <filename>vmlinux</filename>,
81	<filename>initrd.gz</filename>, <filename>yaboot</filename>, and
82	<filename>yaboot.conf</filename> files at the root level of your HFS
83	partition in <xref linkend="files-newworld"/>.
84	You will now have to boot into OpenFirmware (see <xref linkend="invoking-openfirmware"/>).
85	At the prompt, type
86
87	<informalexample><screen>
88	0 > boot hd:<replaceable>x</replaceable>,yaboot
89	</screen></informalexample>
90
91	replacing <replaceable>x</replaceable> with the partition number of
92	the HFS partition where the
93	kernel and yaboot files were placed, followed by a &enterkey;. On some
94	machines, you may need to use <userinput>ide0:</userinput> instead of
95	<userinput>hd:</userinput>. In a few more seconds you will see a
96	yaboot prompt
97
98	<informalexample><screen>
99	boot:
100	</screen></informalexample>
101
102	At yaboot's <prompt>boot:</prompt> prompt, type either
103	<userinput>install</userinput> or <userinput>install video=ofonly</userinput>
104	followed by a &enterkey;. The
105	<userinput>video=ofonly</userinput> argument is for maximum
106	compatibility; you can try it if <userinput>install</userinput>
107	doesn't work. The Debian installation program should start.
108
109	</para>
110	</sect3>
111	</sect2>
112
113	<sect2 arch="powerpc" condition="bootable-usb" id="usb-boot">
114	<title>Booting from USB memory stick</title>
115	<para>
116
117	Currently, NewWorld PowerMac systems are known to support USB booting.
118
119	</para>
120
121	<para>
122
123	Make sure you have prepared everything from <xref
124	linkend="boot-usb-files"/>. To boot a Macintosh system from a USB stick,
125	you will need to use the Open Firmware prompt, since Open Firmware does
126	not search USB storage devices by default.
127	<!-- TODO: although it could be made to; watch this space -->
128	See <xref linkend="invoking-openfirmware"/>.
129
130	</para><para>
131
132	You will need to work out where the USB storage device appears in the
133	device tree, since at the moment <command>ofpath</command> cannot work
134	that out automatically. Type <userinput>dev / ls</userinput> and
135	<userinput>devalias</userinput> at the Open Firmware prompt to get a
136	list of all known devices and device aliases. On the author's system
137	with various types of USB stick, paths such as
138	<filename>usb0/disk</filename>, <filename>usb0/hub/disk</filename>,
139	<filename>/pci@f2000000/usb@1b,1/disk@1</filename>, and
140	<filename>/pci@f2000000/usb@1b,1/hub@1/disk@1</filename> work.
141
142	</para><para>
143
144	Having worked out the device path, use a command like this to boot the
145	installer:
146
147	<informalexample><screen>
148	boot <replaceable>usb0/disk</replaceable>:<replaceable>2</replaceable>,\\:tbxi
149	</screen></informalexample>
150
151	The <replaceable>2</replaceable> matches the Apple_HFS or
152	Apple_Bootstrap partition onto which you copied the boot image earlier,
153	and the <userinput>,\\:tbxi</userinput> part instructs Open Firmware to
154	boot from the file with an HFS file type of "tbxi" (i.e.
155	<command>yaboot</command>) in the directory previously blessed with
156	<command>hattrib -b</command>.
157
158	</para><para>
159
160	The system should now boot up, and you should be presented with the
161	<prompt>boot:</prompt> prompt. Here you can enter optional boot
162	arguments, or just hit &enterkey;.
163
164	</para><warning><para>
165
166	This boot method is new, and may be difficult to get to work on some
167	NewWorld systems. If you have problems, please file an installation
168	report, as explained in <xref linkend="submit-bug"/>.
169
170	</para></warning>
171	</sect2>
172
173	<sect2 arch="powerpc" id="boot-tftp"><title>Booting with TFTP</title>
174
175	&boot-installer-intro-net.xml;
176
177	<para>
178
179	Currently, PReP and New World PowerMac systems support netbooting.
180
181	</para><para>
182
183	On machines with Open Firmware, such as NewWorld Power Macs, enter the
184	boot monitor (see <xref linkend="invoking-openfirmware"/>) and
185	use the command
186
187	<informalexample><screen>
188	0 > boot enet:0
189	</screen></informalexample>
190
191	If this doesn't work, you might have to add the filename like this:
192
193	<informalexample><screen>
194	0 > boot enet:0,yaboot
195	</screen></informalexample>
196
197	PReP and CHRP boxes
198	may have different ways of addressing the network. On a PReP machine,
199	you should try
200
201	<informalexample><screen>
202	boot net:<replaceable>server_ipaddr</replaceable>,<replaceable>file</replaceable>,<replaceable>client_ipaddr</replaceable>
203	</screen></informalexample>
204
205	On some PReP systems (e.g. Motorola PowerStack machines) the command
206	<userinput>help boot</userinput> may give a description of syntax and
207	available options.
208
209	</para>
210	</sect2>
211
212
213	<sect2 arch="powerpc" condition="supports-floppy-boot">
214	<title>Booting from Floppies</title>
215	<para>
216
217	Booting from floppies is supported for &arch-title;, although it is
218	generally only applicable for OldWorld systems. NewWorld systems are
219	not equipped with floppy drives, and attached USB floppy drives are
220	not supported for booting.
221
222	</para><para>
223
224	You will have already downloaded the floppy images you needed and
225	created floppies from the images in <xref linkend="create-floppy"/>.
226
227	</para><para>
228
229	To boot from the <filename>boot-floppy-hfs.img</filename> floppy,
230	place it in floppy drive after shutting the system down, and before
231	pressing the power-on button.
232
233	</para><note><para>
234	For those not familiar with Macintosh
235	floppy operations: a floppy placed in the machine prior to boot will
236	be the first priority for the system to boot from. A floppy without a
237	valid boot system will be ejected, and the machine will then check for
238	bootable hard disk partitions.
239
240	</para></note><para>
241
242	After booting, the <filename>root.bin</filename> floppy is
243	requested. Insert the root floppy and press &enterkey;. The installer
244	program is automatically launched after the root system has been
245	loaded into memory.
246
247	</para>
248	</sect2>
249
250
251	<sect2 arch="powerpc"><title>PowerPC Boot Parameters</title>
252	<para>
253
254	Many older Apple monitors used a 640x480 67Hz mode. If your video
255	appears skewed on an older Apple monitor, try appending the boot
256	argument <userinput>video=atyfb:vmode:6</userinput> , which will
257	select that mode for most Mach64 and Rage video hardware. For Rage 128
258	hardware, this changes to
259	<userinput>video=aty128fb:vmode:6</userinput> .
260
261	</para>
262	</sect2>