~qbalazs/installation-guide/lp1030336

« back to all changes in this revision

Viewing changes to da/boot-new/boot-new.xml

  • Committer: joeyh
  • Date: 2005-10-07 19:51:38 UTC
  • Revision ID: vcs-imports@canonical.com-20051007195138-c3d57b2617a79a4f
move manual to top-level directory, split out of debian-installer package

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<!-- retain these comments for translator revision tracking -->
 
2
<!-- original version: 21672 untranslated -->
 
3
 
 
4
<chapter id="boot-new">
 
5
 <title>Booting Into Your New Debian System</title>
 
6
 
 
7
 <sect1 id="base-boot"><title>The Moment of Truth</title>
 
8
<para>
 
9
 
 
10
Your system's first boot on its own power is what electrical engineers
 
11
call the <quote>smoke test</quote>.
 
12
 
 
13
</para><para>
 
14
 
 
15
If you are booting directly into Debian, and the system doesn't start
 
16
up, either use your original installation boot media, or insert the
 
17
custom boot floppy if you have one, and reset your system.  This way,
 
18
you will probably need to add some boot arguments like
 
19
<userinput>root=<replaceable>root</replaceable></userinput>, where
 
20
<replaceable>root</replaceable> is your root partition, such as
 
21
<filename>/dev/sda1</filename>.
 
22
 
 
23
</para>
 
24
 
 
25
  <sect2 arch="m68k"><title>BVME 6000 Booting</title>
 
26
<para>
 
27
 
 
28
If you have just performed a diskless install on a BVM or Motorola
 
29
VMEbus machine: once the system has loaded the
 
30
<command>tftplilo</command> program from the TFTP server, from the
 
31
<prompt>LILO Boot:</prompt> prompt enter one of:
 
32
 
 
33
<itemizedlist>
 
34
<listitem><para>
 
35
 
 
36
<userinput>b6000</userinput> followed by &enterkey;
 
37
to boot a BVME 4000/6000
 
38
 
 
39
</para></listitem><listitem><para>
 
40
 
 
41
<userinput>b162</userinput> followed by &enterkey;
 
42
to boot an MVME162
 
43
 
 
44
</para></listitem><listitem><para>
 
45
 
 
46
<userinput>b167</userinput> followed by &enterkey;
 
47
to boot an MVME166/167
 
48
 
 
49
</para></listitem>
 
50
</itemizedlist>
 
51
 
 
52
</para>
 
53
 
 
54
   </sect2>
 
55
 
 
56
  <sect2 arch="m68k"><title>Macintosh Booting</title>
 
57
 
 
58
<para>
 
59
 
 
60
Go to the directory containing the installation files and start up the
 
61
<command>Penguin</command> booter, holding down the
 
62
<keycap>command</keycap> key.  Go to the
 
63
<userinput>Settings</userinput> dialogue (<keycombo>
 
64
<keycap>command</keycap> <keycap>T</keycap> </keycombo>), and locate
 
65
the kernel options line which should look like
 
66
<userinput>root=/dev/ram video=font:VGA8x16</userinput> or similar.
 
67
 
 
68
</para><para>
 
69
 
 
70
You need to change the entry to
 
71
<userinput>root=/dev/<replaceable>yyyy</replaceable></userinput>.
 
72
Replace the <replaceable>yyyy</replaceable> with the Linux name of the
 
73
partition onto which you installed the system
 
74
(e.g. <filename>/dev/sda1</filename>); you wrote this down earlier.
 
75
The <userinput>video=font:VGA8x8</userinput> is recommended especially
 
76
for users with tiny screens. The kernel would pick a prettier (6x11)
 
77
font but the console driver for this font can hang the machine, so
 
78
using 8x16 or 8x8 is safer at this stage.  You can change this at any
 
79
time.
 
80
 
 
81
</para><para>
 
82
 
 
83
If you don't want to start GNU/Linux immediately each time you start,
 
84
uncheck the <userinput>Auto Boot</userinput> option. Save your
 
85
settings in the <filename>Prefs</filename> file using the
 
86
<userinput>Save Settings As Default</userinput> option.
 
87
 
 
88
</para><para>
 
89
 
 
90
Now select <userinput>Boot Now</userinput> (<keycombo>
 
91
<keycap>command</keycap> <keycap>B</keycap> </keycombo>) to start your
 
92
freshly installed GNU/Linux instead of the RAMdisk installer system.
 
93
 
 
94
</para><para>
 
95
 
 
96
Debian should boot, and you should see the same messages as
 
97
when you first booted the installation system, followed by some new
 
98
messages. 
 
99
 
 
100
</para>
 
101
   </sect2>
 
102
 
 
103
 
 
104
  <sect2 arch="powerpc"><title>OldWorld PowerMacs</title>
 
105
<para>
 
106
 
 
107
If the machine fails to boot after completing the installation, and
 
108
stops with a <prompt>boot:</prompt> prompt, try typing
 
109
<userinput>Linux</userinput> followed by &enterkey;. (The default boot
 
110
configuration in <filename>quik.conf</filename> is labeled Linux). The
 
111
labels defined in <filename>quik.conf</filename> will be displayed if
 
112
you press the <keycap>Tab</keycap> key at the <prompt>boot:</prompt>
 
113
prompt. You can also try booting back into the installer, and editing
 
114
the <filename>/target/etc/quik.conf</filename> placed there by the
 
115
<guimenuitem>Install <command>Quik</command> on a Hard
 
116
Disk</guimenuitem> step. Clues for dealing with
 
117
<command>quik</command> are available at <ulink
 
118
url="&url-powerpc-quik-faq;"></ulink>.
 
119
 
 
120
</para><para>
 
121
 
 
122
To boot back into MacOS without resetting the nvram, type
 
123
<userinput>bye</userinput> at the OpenFirmware prompt (assuming MacOS
 
124
has not been removed from the machine). To obtain an OpenFirmware
 
125
prompt, hold down the <keycombo> <keycap>command</keycap>
 
126
<keycap>option</keycap> <keycap>o</keycap> <keycap>f</keycap>
 
127
</keycombo> keys while cold booting the machine. If you need to reset
 
128
the OpenFirmware nvram changes to the MacOS default in order to boot
 
129
back to MacOS, hold down the <keycombo> <keycap>command</keycap>
 
130
<keycap>option</keycap> <keycap>p</keycap> <keycap>r</keycap>
 
131
</keycombo> keys while cold booting the machine.
 
132
 
 
133
</para><para>
 
134
 
 
135
If you use <command>BootX</command> to boot into the installed system,
 
136
just select your desired kernel in the <filename>Linux
 
137
Kernels</filename> folder, un-choose the ramdisk option, and add
 
138
a root device corresponding to your installation;
 
139
e.g. <userinput>/dev/hda8</userinput>.
 
140
 
 
141
</para>
 
142
   </sect2>
 
143
 
 
144
 
 
145
  <sect2 arch="powerpc"><title>NewWorld PowerMacs</title>
 
146
<para>
 
147
 
 
148
On G4 machines and iBooks, you can hold down the
 
149
<keycap>option</keycap> key and get a graphical screen with a button
 
150
for each bootable OS, &debian; will be a button with a small penguin
 
151
icon.
 
152
 
 
153
</para><para>
 
154
 
 
155
If you kept MacOS and at some point it changes the OpenFirmware
 
156
<envar>boot-device</envar> variable you should reset OpenFirmware to
 
157
its default configuration.  To do this hold down the <keycombo>
 
158
<keycap>command</keycap> <keycap>option</keycap> <keycap>p</keycap>
 
159
<keycap>r</keycap> </keycombo> keys while cold booting the machine.
 
160
 
 
161
</para><para>
 
162
 
 
163
The labels defined in <filename>yaboot.conf</filename> will be
 
164
displayed if you press the <keycap>Tab</keycap> key at the
 
165
<prompt>boot:</prompt> prompt.
 
166
 
 
167
</para><para>
 
168
 
 
169
Resetting OpenFirmware on G3 or G4 hardware will cause it to boot
 
170
&debian; by default (if you correctly partitioned and placed the
 
171
Apple_Bootstrap partition first).  If you have &debian; on a SCSI disk
 
172
and MacOS on an IDE disk this may not work and you will have to enter
 
173
OpenFirmware and set the <envar>boot-device</envar> variable,
 
174
<command>ybin</command> normally does this automatically.
 
175
 
 
176
</para><para>
 
177
 
 
178
After you boot &debian; for the first time you can add any additional
 
179
options you desire (such as dual boot options) to
 
180
<filename>/etc/yaboot.conf</filename> and run <command>ybin</command>
 
181
to update your boot partition with the changed configuration.  Please
 
182
read the <ulink url="&url-powerpc-yaboot-faq;">yaboot HOWTO</ulink>
 
183
for more information.
 
184
 
 
185
</para>
 
186
   </sect2>
 
187
 </sect1>
 
188
 
 
189
 <sect1 id="base-config">
 
190
 <title>Debian Post-Boot (Base) Configuration</title>
 
191
 
 
192
<para>
 
193
 
 
194
After booting, you will be prompted to complete the configuration of
 
195
your basic system, and then to select what additional packages you
 
196
wish to install.  The application which guides you through this
 
197
process is called <classname>base-config</classname>. Its concept is
 
198
very similar to the &d-i; from the first stage.  Indeed,
 
199
<classname>base-config</classname> consists of a number of specialized
 
200
components, where each component handles one configuration task,
 
201
contains <quote>hidden menu in the background</quote> and also uses
 
202
the same navigation system.
 
203
 
 
204
</para><para>
 
205
 
 
206
If you wish to re-run the <classname>base-config</classname> at any
 
207
point after installation is complete, as root run
 
208
<userinput>base-config</userinput>.
 
209
 
 
210
</para>
 
211
 
 
212
&module-bc-timezone.xml;
 
213
&module-bc-shadow.xml;
 
214
&module-bc-ppp.xml;
 
215
&module-bc-apt.xml;
 
216
&module-bc-packages.xml;
 
217
&module-bc-install.xml;
 
218
&module-bc-mta.xml;
 
219
 
 
220
 </sect1>
 
221
 
 
222
 <sect1 id="login">
 
223
 <title>Log In</title>
 
224
 
 
225
<para>
 
226
 
 
227
After you've installed packages, you'll be presented with the login
 
228
prompt.  Log in using the personal login and password you
 
229
selected. Your system is now ready to use.
 
230
 
 
231
</para><para>
 
232
 
 
233
If you are a new user, you may want to explore the documentation which
 
234
is already installed on your system as you start to use it. There are
 
235
currently several documentation systems, work is proceeding on
 
236
integrating the different types of documentation. Here are a few
 
237
starting points.
 
238
 
 
239
</para><para>
 
240
 
 
241
Documentation accompanying programs you have installed is in
 
242
<filename>/usr/share/doc/</filename>, under a subdirectory named after
 
243
the program.  For example, the APT User's Guide for using
 
244
<command>apt</command> to install other programs on your system, is
 
245
located in
 
246
<filename>/usr/share/doc/apt/guide.html/index.html</filename>.
 
247
 
 
248
</para><para>
 
249
 
 
250
 
 
251
In addition, there are some special folders within the
 
252
<filename>/usr/share/doc/</filename> hierarchy. Linux HOWTOs are
 
253
installed in <emphasis>.gz</emphasis> format, in
 
254
<filename>/usr/share/doc/HOWTO/en-txt/</filename> and
 
255
<filename>/usr/share/doc/HOWTO/en-txt/mini/</filename>. The
 
256
<filename>/usr/share/doc/HTML/index.html</filename> contains
 
257
browse-able indexes of documentation installed by
 
258
<command>dhelp</command>.
 
259
 
 
260
</para><para>
 
261
 
 
262
One easy way to view these documents is to <userinput>cd
 
263
/usr/share/doc/</userinput>, and type <userinput>lynx</userinput>
 
264
followed by a space and a dot (the dot stands for the current
 
265
directory).
 
266
 
 
267
</para><para>
 
268
 
 
269
You can also type <userinput>info
 
270
<replaceable>command</replaceable></userinput> or <userinput>man
 
271
<replaceable>command</replaceable></userinput> to see documentation on
 
272
most commands available at the command prompt. Typing
 
273
<userinput>help</userinput> will display help on shell commands. And
 
274
typing a command followed by <userinput>--help</userinput> will
 
275
usually display a short summary of the command's usage. If a command's
 
276
results scroll past the top of the screen, type <userinput>|
 
277
more</userinput> after the command to cause the results to pause
 
278
before scrolling past the top of the screen. To see a list of all
 
279
commands available which begin with a certain letter, type the letter
 
280
and then two tabs.
 
281
 
 
282
</para><para>
 
283
 
 
284
For a more complete introduction to Debian and GNU/Linux, see
 
285
<filename>/usr/share/doc/debian-guide/html/noframes/index.html</filename>.
 
286
 
 
287
</para>
 
288
 
 
289
 </sect1>
 
290
</chapter>