1
<!-- retain these comments for translator revision tracking -->
2
<!-- original version: 28730 untranslated -->
4
<chapter id="boot-new">
5
<title>Booting Into Your New Debian System</title>
7
<sect1 id="base-boot"><title>The Moment of Truth</title>
10
Your system's first boot on its own power is what electrical engineers
11
call the <quote>smoke test</quote>.
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
<phrase condition="etch">
23
Alternatively, see <xref linkend="rescue"/> for instructions on using
24
the installer's built-in rescue mode.
29
<sect2 arch="m68k"><title>BVME 6000 Booting</title>
32
If you have just performed a diskless install on a BVM or Motorola
33
VMEbus machine: once the system has loaded the
34
<command>tftplilo</command> program from the TFTP server, from the
35
<prompt>LILO Boot:</prompt> prompt enter one of:
40
<userinput>b6000</userinput> followed by &enterkey;
41
to boot a BVME 4000/6000
43
</para></listitem><listitem><para>
45
<userinput>b162</userinput> followed by &enterkey;
48
</para></listitem><listitem><para>
50
<userinput>b167</userinput> followed by &enterkey;
51
to boot an MVME166/167
60
<sect2 arch="m68k"><title>Macintosh Booting</title>
64
Go to the directory containing the installation files and start up the
65
<command>Penguin</command> booter, holding down the
66
<keycap>command</keycap> key. Go to the
67
<userinput>Settings</userinput> dialogue (<keycombo>
68
<keycap>command</keycap> <keycap>T</keycap> </keycombo>), and locate
69
the kernel options line which should look like
70
<userinput>root=/dev/ram video=font:VGA8x16</userinput> or similar.
74
You need to change the entry to
75
<userinput>root=/dev/<replaceable>yyyy</replaceable></userinput>.
76
Replace the <replaceable>yyyy</replaceable> with the Linux name of the
77
partition onto which you installed the system
78
(e.g. <filename>/dev/sda1</filename>); you wrote this down earlier.
79
The <userinput>video=font:VGA8x8</userinput> is recommended especially
80
for users with tiny screens. The kernel would pick a prettier (6x11)
81
font but the console driver for this font can hang the machine, so
82
using 8x16 or 8x8 is safer at this stage. You can change this at any
87
If you don't want to start GNU/Linux immediately each time you start,
88
uncheck the <userinput>Auto Boot</userinput> option. Save your
89
settings in the <filename>Prefs</filename> file using the
90
<userinput>Save Settings As Default</userinput> option.
94
Now select <userinput>Boot Now</userinput> (<keycombo>
95
<keycap>command</keycap> <keycap>B</keycap> </keycombo>) to start your
96
freshly installed GNU/Linux instead of the RAMdisk installer system.
100
Debian should boot, and you should see the same messages as
101
when you first booted the installation system, followed by some new
108
<sect2 arch="powerpc"><title>OldWorld PowerMacs</title>
111
If the machine fails to boot after completing the installation, and
112
stops with a <prompt>boot:</prompt> prompt, try typing
113
<userinput>Linux</userinput> followed by &enterkey;. (The default boot
114
configuration in <filename>quik.conf</filename> is labeled Linux). The
115
labels defined in <filename>quik.conf</filename> will be displayed if
116
you press the <keycap>Tab</keycap> key at the <prompt>boot:</prompt>
117
prompt. You can also try booting back into the installer, and editing
118
the <filename>/target/etc/quik.conf</filename> placed there by the
119
<guimenuitem>Install Quik on a Hard Disk</guimenuitem> step. Clues
120
for dealing with <command>quik</command> are available at
121
<ulink url="&url-powerpc-quik-faq;"></ulink>.
125
To boot back into MacOS without resetting the nvram, type
126
<userinput>bye</userinput> at the OpenFirmware prompt (assuming MacOS
127
has not been removed from the machine). To obtain an OpenFirmware
128
prompt, hold down the <keycombo> <keycap>command</keycap>
129
<keycap>option</keycap> <keycap>o</keycap> <keycap>f</keycap>
130
</keycombo> keys while cold booting the machine. If you need to reset
131
the OpenFirmware nvram changes to the MacOS default in order to boot
132
back to MacOS, hold down the <keycombo> <keycap>command</keycap>
133
<keycap>option</keycap> <keycap>p</keycap> <keycap>r</keycap>
134
</keycombo> keys while cold booting the machine.
138
If you use <command>BootX</command> to boot into the installed system,
139
just select your desired kernel in the <filename>Linux
140
Kernels</filename> folder, un-choose the ramdisk option, and add
141
a root device corresponding to your installation;
142
e.g. <userinput>/dev/hda8</userinput>.
148
<sect2 arch="powerpc"><title>NewWorld PowerMacs</title>
151
On G4 machines and iBooks, you can hold down the
152
<keycap>option</keycap> key and get a graphical screen with a button
153
for each bootable OS, &debian; will be a button with a small penguin
158
If you kept MacOS and at some point it changes the OpenFirmware
159
<envar>boot-device</envar> variable you should reset OpenFirmware to
160
its default configuration. To do this hold down the <keycombo>
161
<keycap>command</keycap> <keycap>option</keycap> <keycap>p</keycap>
162
<keycap>r</keycap> </keycombo> keys while cold booting the machine.
166
The labels defined in <filename>yaboot.conf</filename> will be
167
displayed if you press the <keycap>Tab</keycap> key at the
168
<prompt>boot:</prompt> prompt.
172
Resetting OpenFirmware on G3 or G4 hardware will cause it to boot
173
&debian; by default (if you correctly partitioned and placed the
174
Apple_Bootstrap partition first). If you have &debian; on a SCSI disk
175
and MacOS on an IDE disk this may not work and you will have to enter
176
OpenFirmware and set the <envar>boot-device</envar> variable,
177
<command>ybin</command> normally does this automatically.
181
After you boot &debian; for the first time you can add any additional
182
options you desire (such as dual boot options) to
183
<filename>/etc/yaboot.conf</filename> and run <command>ybin</command>
184
to update your boot partition with the changed configuration. Please
185
read the <ulink url="&url-powerpc-yaboot-faq;">yaboot HOWTO</ulink>
186
for more information.
192
<sect1 id="base-config">
193
<title>Debian Post-Boot (Base) Configuration</title>
197
After booting, you will be prompted to complete the configuration of
198
your basic system, and then to select what additional packages you
199
wish to install. The application which guides you through this
200
process is called <classname>base-config</classname>. Its concept is
201
very similar to the &d-i; from the first stage. Indeed,
202
<classname>base-config</classname> consists of a number of specialized
203
components, where each component handles one configuration task,
204
contains <quote>hidden menu in the background</quote> and also uses
205
the same navigation system.
209
If you wish to re-run the <classname>base-config</classname> at any
210
point after installation is complete, as root run
211
<userinput>base-config</userinput>.
215
&module-bc-timezone.xml;
216
&module-bc-shadow.xml;
219
&module-bc-packages.xml;
220
&module-bc-install.xml;
226
<title>Log In</title>
230
After you've installed packages, you'll be presented with the login
231
prompt. Log in using the personal login and password you
232
selected. Your system is now ready to use.
236
If you are a new user, you may want to explore the documentation which
237
is already installed on your system as you start to use it. There are
238
currently several documentation systems, work is proceeding on
239
integrating the different types of documentation. Here are a few
244
Documentation accompanying programs you have installed is in
245
<filename>/usr/share/doc/</filename>, under a subdirectory named after
246
the program. For example, the APT User's Guide for using
247
<command>apt</command> to install other programs on your system, is
249
<filename>/usr/share/doc/apt/guide.html/index.html</filename>.
254
In addition, there are some special folders within the
255
<filename>/usr/share/doc/</filename> hierarchy. Linux HOWTOs are
256
installed in <emphasis>.gz</emphasis> format, in
257
<filename>/usr/share/doc/HOWTO/en-txt/</filename>. After installing
258
<command>dhelp</command> you will find a browse-able index of
259
documentation in <filename>/usr/share/doc/HTML/index.html</filename>.
263
One easy way to view these documents is to <userinput>cd
264
/usr/share/doc/</userinput>, and type <userinput>lynx</userinput>
265
followed by a space and a dot (the dot stands for the current
270
You can also type <userinput>info
271
<replaceable>command</replaceable></userinput> or <userinput>man
272
<replaceable>command</replaceable></userinput> to see documentation on
273
most commands available at the command prompt. Typing
274
<userinput>help</userinput> will display help on shell commands. And
275
typing a command followed by <userinput>--help</userinput> will
276
usually display a short summary of the command's usage. If a command's
277
results scroll past the top of the screen, type <userinput>|
278
more</userinput> after the command to cause the results to pause
279
before scrolling past the top of the screen. To see a list of all
280
commands available which begin with a certain letter, type the letter
285
For a more complete introduction to Debian and GNU/Linux, see
286
<filename>/usr/share/doc/debian-guide/html/noframes/index.html</filename>.