Gentoo Archives: gentoo-doc-cvs

From: Shyam Mani <fox2mike@×××××××××××.org>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] cvs commit: hb-install-gtkfe.xml
Date: Wed, 15 Feb 2006 18:36:18
Message-Id: 200602151836.k1FIa38t029478@robin.gentoo.org
1 fox2mike 06/02/15 18:36:02
2
3 Modified: xml/htdocs/doc/en/handbook/draft/2006.0
4 hb-install-x86-medium.xml
5 Added: xml/htdocs/doc/en/handbook/draft/2006.0 hb-install-gtkfe.xml
6 Log:
7 Yay, new file for Graphical Installer
8
9 Revision Changes Path
10 1.6 +6 -27 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-x86-medium.xml
11
12 file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-x86-medium.xml?rev=1.6&content-type=text/x-cvsweb-markup&cvsroot=gentoo
13 plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-x86-medium.xml?rev=1.6&content-type=text/plain&cvsroot=gentoo
14 diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-x86-medium.xml.diff?r1=1.5&r2=1.6&cvsroot=gentoo
15
16 Index: hb-install-x86-medium.xml
17 ===================================================================
18 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-x86-medium.xml,v
19 retrieving revision 1.5
20 retrieving revision 1.6
21 diff -u -r1.5 -r1.6
22 --- hb-install-x86-medium.xml 12 Feb 2006 20:56:43 -0000 1.5
23 +++ hb-install-x86-medium.xml 15 Feb 2006 18:36:01 -0000 1.6
24 @@ -4,7 +4,7 @@
25 <!-- The content of this document is licensed under the CC-BY-SA license -->
26 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
27
28 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-x86-medium.xml,v 1.5 2006/02/12 20:56:43 nightmorph Exp $ -->
29 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-x86-medium.xml,v 1.6 2006/02/15 18:36:01 fox2mike Exp $ -->
30
31 <sections>
32
33 @@ -573,35 +573,14 @@
34 </pre>
35
36 <p>
37 -You can go back to your original terminal by pressing <c>Alt-F1</c>.
38 +You can go back to your original window by pressing <c>Alt-F7</c>.
39 </p>
40
41 -</body>
42 -</subsection>
43 -<subsection>
44 -<title>Optional: Starting the SSH Daemon</title>
45 -<body>
46 -
47 -<p>
48 -If you want to allow other users to access your computer during the
49 -Gentoo installation (perhaps because those users are going to help you
50 -install Gentoo, or even do it for you), you need to create a user
51 -account for them and perhaps even provide them with your root password
52 -(<e>only</e> do that <e>if</e> you <b>fully trust</b> that user). Starting the
53 -SSH daemon requires root access.
54 -</p>
55 -
56 -<p>
57 -To fire up the SSH daemon, execute the following command:
58 -</p>
59 -
60 -<pre caption="Starting the SSH daemon">
61 -# <i>/etc/init.d/sshd start</i>
62 -</pre>
63 -
64 <p>
65 -To be able to use sshd, you first need to set up your networking. Continue with
66 -the chapter on <uri link="?part=1&amp;chap=3">Configuring your Network</uri>.
67 +You can now choose to proceed by using the <uri link="?part=1&amp;chap=3">GTK+
68 +based installer</uri> (which needs X) or the <uri
69 +link="?part1&amp;chap=4">Dialog based installer</uri> that can be run on a
70 +console.
71 </p>
72
73 </body>
74
75
76
77 1.1 xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-gtkfe.xml
78
79 file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-gtkfe.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
80 plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-gtkfe.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
81
82 Index: hb-install-gtkfe.xml
83 ===================================================================
84 <?xml version='1.0' encoding='UTF-8'?>
85 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
86 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-gtkfe.xml,v 1.1 2006/02/15 18:36:01 fox2mike Exp $ -->
87
88 <!-- The content of this document is licensed under the CC-BY-SA license -->
89 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
90
91 <sections>
92
93 <version>1.0</version>
94 <date>2006-02-13</date>
95
96 <!-- Note:
97 Please re-examine wolf31o2's patches on bug 122289 and the existing
98 networkless handbook to ensure that any helpful information for THIS doc has
99 not been missed, for example, the tips on partition layout for mailserver,
100 etc.
101 -->
102
103 <section>
104 <title>Welcome</title>
105 <subsection>
106 <title>Before you begin</title>
107 <body>
108
109 <p>
110 Once the Gentoo Linux Installer (GLI) has finished loading, you will be
111 greeted by the welcome screen. It provides a friendly introduction to the
112 process of installing Gentoo on your computer. Remember to read each option
113 carefully. There is detailed help available for each step of installation;
114 just click <c>Help</c> in the lower left corner of the installer. We recommend that
115 you always read the help pages before making your choices. Note that at any
116 time during the installation process, you can save your configuration
117 progress in case you need to resume your installation at a later time.
118 </p>
119
120 </body>
121 </subsection>
122 </section>
123
124 <section>
125 <title>Pre-installation Configuration</title>
126 <subsection>
127 <title>Optional: Manual Network Configuration</title>
128 <body>
129
130 <p>
131 In the next section, you are required to configure your network. The Installer
132 should have already detected and set up your network for you, but if it didn't,
133 you can manually configure your network. On the <e>Misc.</e> tab, you can optionally
134 log the installation process by specifying a logfile location.
135 </p>
136
137 </body>
138 </subsection>
139 <subsection>
140 <title>Optional: Remote Installation</title>
141 <body>
142
143 <p>
144 If you wish to SSH in from another machine to perform the install remotely, you
145 can start <c>sshd</c> and specify a root password.
146 </p>
147
148 </body>
149 </subsection>
150 <subsection>
151 <title>Optional: Load Additional Kernel Modules</title>
152 <body>
153
154 <p>
155 If you need to load more kernel modules to support your hardware, enter their
156 names into the appropriate line, each separated by a space.
157 </p>
158
159 <warn>
160 Do not change the <e>Install mode</e> selection to anything besides
161 <b>Normal</b>. This feature is still experimental and changing it will leave you
162 with an unbootable system!
163 </warn>
164
165 </body>
166 </subsection>
167 </section>
168
169 <section>
170 <title>Partitioning</title>
171 <subsection>
172 <title>Preparing the disks</title>
173 <body>
174
175 <p>
176 In order to install Gentoo on your machine, you will need to prepare your
177 disks. The <e>Partitioning</e> screen will show you a list of detected disks and
178 allow you to specify the filesystems you would like to have on your
179 partitions. Clicking <c>Clear partitions</c> will erase all previous partitions on
180 your disk, so be careful with this option! It is also possible to resize
181 certain partition types.
182 </p>
183
184 <p>
185 If you choose to go with the <c>Recommended layout</c>, the installer will
186 create three partitions: 100MB for <path>/boot</path>, a <path>/swap</path>
187 partition up to 512MB in size, and the rest of the available space on the disk
188 is used for <path>/</path>, the root partition. If you have more than 4GB of
189 unpartitioned space, using the "Recommended layout" will automatically configure
190 your partitions without destroying any data on any existing partitions.
191 </p>
192
193 </body>
194 </subsection>
195 </section>
196
197 <section>
198 <title>Network Mounts</title>
199 <subsection>
200 <title>Optional: Define network mounts</title>
201 <body>
202
203 <p>
204 This screen lets you set up and use any existing network mounts during and after
205 installation. Click <c>New</c> to begin configuration. At this time, only NFS is
206 supported.
207 </p>
208
209 </body>
210 </subsection>
211 </section>
212
213 <section>
214 <title>Stage Selection</title>
215 <subsection>
216 <title>Dynamic stage generation</title>
217 <body>
218
219 <p>
220 Since you are performing an installation <e>without</e> an internet
221 connection, you <b>must</b> check <e>GRP Install</e> as well as <e>Dynamic</e>
222 from the options present. Everything you need to build your system will
223 then be generated from the files on the LiveCD.
224 </p>
225
226 <warn>
227 Do <e>not</e> select options other than those specified above when you are
228 installing without an internet connection.
229 </warn>
230
231 </body>
232 </subsection>
233 </section>
234
235 <section>
236 <title>Portage Tree</title>
237 <subsection>
238 <title>Obtaining a Portage tree</title>
239 <body>
240
241 <p>
242 You must choose <e>Snapshot</e> on this screen. The installer will automatically
243 install a Portage tree from the LiveCD once you select <e>Snapshot</e>; you do not
244 need to specify a snapshot URI.
245 </p>
246
247 </body>
248 </subsection>
249 </section>
250
251 <section>
252 <title>make.conf</title>
253 <subsection>
254 <title>USE flags</title>
255 <body>
256
257 <p>
258 Since you are performing a GRP/networkless install, you will not be allowed
259 to select USE flags before installation. However, you are free to set your own
260 USE flags in <path>/etc/make.conf</path> after you have rebooted into your
261 finished system.
262 </p>
263
264 </body>
265 </subsection>
266 <subsection>
267 <title>CFLAGS</title>
268 <body>
269
270 <p>
271 You should, however, select your processor type in the <e>CFLAGS</e> section along
272 with any custom optimizations you may want, such as <c>-O2</c> and
273 <c>-pipe</c>.
274 </p>
275
276 </body>
277 </subsection>
278 <subsection>
279 <title>Other</title>
280 <body>
281
282 <p>
283 Any other options you wish to set for future use should be selected now. <e>Use
284 unstable (~arch)</e> will allow you to use packages from the unstable branch of
285 the Portage tree. <e>Build binary packages</e> creates ready-to-install binary
286 tarballs of all packages you compile on your system. <e>DistCC</e> allows you to
287 share the burden of compiling with another computer via your network
288 connection.<e>ccache</e> saves compiled code for later use, and thus can greatly
289 speed up compilation time if you re-install the same package.
290 </p>
291
292 <p>
293 You will not be allowed to change your <e>CHOST</e>, as this can seriously damage
294 your installation. In <e>MAKEOPTS</e> you define how many parallel compilations
295 should occur when you install a package. A good choice is the number of CPUs
296 in your system plus one, but this guideline isn't always perfect. On a
297 uniprocessor system, <c>-j2</c> might be used.
298 </p>
299
300 </body>
301 </subsection>
302 </section>
303
304 <section>
305 <title>Kernel Sources</title>
306 <subsection>
307 <title>Using the LiveCD kernel</title>
308 <body>
309
310 <p>
311 You must use the kernel present on the LiveCD for the GRP/networkless install.
312 This is merely a <c>gentoo-sources</c> kernel compiled by <c>genkernel</c>,
313 Gentoo's automated kernel compilation utility and will give you a kernel that
314 automatically detects and configures your hardware upon boot.
315 </p>
316
317 <p>
318 If you want to have a nifty background image during system boot, select the
319 <e>Enable bootsplash</e> option.
320 </p>
321
322 </body>
323 </subsection>
324 </section>
325
326 <section>
327 <title>Bootloader</title>
328 <subsection>
329 <title>Making your choice</title>
330 <body>
331
332 <p>
333 This screen allows to you choose your bootloader and, optionally, specify
334 additional kernel parameters that will be used at bootup.
335 </p>
336
337 <p>
338 You may specify which disk to boot from by choosing the appropriate option
339 from <e>Boot Drive</e>. In Linux, the first IDE disk in your system is called
340 <c>hda</c>, the second IDE disk is <c>hdb</c>, and so on. If you have SATA or
341 SCSI disks, they will be called <c>sda</c>, <c>sdb</c>, etc. Please make the
342 correct selection for your system.
343 </p>
344 <!-- more bootloader inclusions needed about vga, etc. just don't include pure
345 CLI stuff, but only what can go on the extra kernel params line -->
346 <p>
347 If you need to pass any additional options to the kernel, such as video and/or
348 VGA statements, simply add them to the "Extra kernel parameters" section.
349 </p>
350
351 <p>
352 If you jumpered your harddrive because the BIOS can't handle large harddrives
353 you'll need to append <c>hdx=stroke</c> or for instance, if you have SCSI
354 devices, you should add <c>doscsi</c> as kernel option.
355 </p>
356
357 <!-- do we need to cover all the stuff about lilo/grub and kernel parameter
358 lines and/or block devices here? -->
359
360 </body>
361 </subsection>
362 </section>
363
364 <section>
365 <title>Timezone</title>
366 <subsection>
367 <title>Choose your timezone</title>
368 <body>
369
370 <p>
371 Study the map and select the region closest to your actual location. Later,
372 you will be to select if you want your clock to be set to UTC or local time.
373 </p>
374
375 </body>
376 </subsection>
377 </section>
378
379 <section>
380 <title>Networking</title>
381 <subsection>
382 <title>Device information</title>
383 <body>
384
385 <p>
386 On this screen, you will be able to configure the various network interface
387 devices on your computer. Read the available options carefully.
388 </p>
389
390 <p>
391 On the <e>Hostname/Proxy Information/Other</e> tab, you will need to choose a
392 hostname for your machine. You may also specify proxy server and DNS settings
393 if needed.
394 </p>
395
396 </body>
397 </subsection>
398 </section>
399
400 <section>
401 <title>Daemons</title>
402 <subsection>
403 <title>Cron daemon</title>
404 <body>
405
406 <p>
407 Cron daemons are helpful programs that run tasks at scheduled times. While you
408 do not <e>need</e> to install one, they can be quite useful.
409 </p>
410
411 </body>
412 </subsection>
413 <subsection>
414 <title>System logger</title>
415 <body>
416
417 <p>
418 A system logger is a necessity for any Linux operating system. Make your
419 selection from the available choices.
420 </p>
421
422 </body>
423 </subsection>
424 </section>
425
426 <section>
427 <title>Extra Packages</title>
428 <subsection>
429 <title>Optional: installing extra packages</title>
430 <body>
431
432 <p>
433 The LiveCD contains a number of available pre-built packages. If you wish to
434 install any of them, check the appropriate box.
435 </p>
436
437 <impo>
438 As you are installing Gentoo without an internet connection, you cannot add
439 any extra packages other than those shown in the installer.
440 </impo>
441
442 </body>
443 </subsection>
444 </section>
445
446 <section>
447 <title>Startup Services</title>
448 <subsection>
449 <body>
450
451 <p>
452 This screen allows you to choose various services to load at system boot.
453 Study the available options and their descriptions carefully, and then select
454 your desired services. For example, if you have chosen to install
455 <c>xorg-x11</c> and wamt to boot straight into a graphical desktop, then you
456 would select "xdm" from the list.
457 </p>
458
459 </body>
460 </subsection>
461 </section>
462
463 <section>
464 <title>Other Settings</title>
465 <subsection>
466 <title>Miscellaneous options</title>
467 <body>
468
469 <p>
470 Now you will be able to change various settings, including keyboard layout,
471 graphical display manager, the default editor, and whether to set your
472 hardware clock to UTC or local time.
473 </p>
474
475 </body>
476 </subsection>
477 </section>
478
479 <section>
480 <title>Users</title>
481 <subsection>
482 <title>Adding users and groups</title>
483 <body>
484
485 <p>
486 First set the root password for the system administrator (the <e>root</e>
487 user).
488 </p>
489
490 <p>
491 We <e>strongly</e> recommend that you create a regular user for daily work.
492 Working as root all the time is <e>dangerous</e> and should be avoided! Create
493 your users, add them to the appropriate groups, and set their passwords. You
494 can optionally change their home directories, select their login shell, and
495 set helpful comments.
496 </p>
497
498 </body>
499 </subsection>
500 </section>
501
502 <section>
503 <title>Review</title>
504 <subsection>
505 <title>Finishing up</title>
506 <body>
507
508 <p>
509 Please take the time to double-check each step of the installation process,
510 ensuring that your system is properly configured. When you have finished
511 reviewing, you may save your progress and exit, or click <c>Install</c> to begin
512 automatically installing Gentoo.
513 </p>
514
515 <p>
516 You are free to browse around on the LiveCD while the installation proceeds.
517 The installer window will alert you when it has finished. At that point, can
518 close the window by clicking the <c>x</c> in the top right corner. When you are
519 ready, you may log out and reboot. Make sure you remove the LiveCD during the
520 reboot.
521 </p>
522
523 <p>
524 Congratulations, your system is now fully equipped! Continue with <uri
525 link="?part=1&amp;chap=5">Where to go from here?</uri> to learn more about
526 Gentoo.
527 </p>
528
529 </body>
530 </subsection>
531 </section>
532 </sections>
533
534
535
536 --
537 gentoo-doc-cvs@g.o mailing list