Gentoo Archives: gentoo-doc-cvs

From: Josh Saddler <nightmorph@×××××××××××.org>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] cvs commit: hb-install-gli-dialog.xml
Date: Sun, 25 Jun 2006 14:04:57
Message-Id: 20060625140433.7D39A646F9@smtp.gentoo.org
1 nightmorph 06/06/25 14:04:33
2
3 Added: hb-install-gli-dialog.xml
4 Log:
5 Initial 2006.1 networkless gli dialogue (ncurses installer) handbook, updatedfor the upcoming release
6
7 Revision Changes Path
8 1.1 xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-gli-dialog.xml
9
10 file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-gli-dialog.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
11 plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-gli-dialog.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
12
13 Index: hb-install-gli-dialog.xml
14 ===================================================================
15 <?xml version='1.0' encoding='UTF-8'?>
16 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
17 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-gli-dialog.xml,v 1.1 2006/06/25 14:04:32 nightmorph Exp $ -->
18
19 <!-- The content of this document is licensed under the CC-BY-SA license -->
20 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
21
22 <sections>
23
24 <version>1.0</version>
25 <date>2006-06-25</date>
26
27 <section>
28 <title>Welcome</title>
29 <subsection>
30 <title>Before you begin</title>
31 <body>
32
33 <p>
34 After you boot the Gentoo Linux Installer LiveCD, it will attempt to load a
35 graphical desktop. If it is unable to do so, it will instead display a command
36 line prompt. To launch the installer, simply type:
37 </p>
38
39 <pre caption="Start the installer">
40 # <i>installer</i>
41 </pre>
42
43 <p>
44 Once the installer has finished loading, you will be greeted by the welcome
45 screen. It provides a friendly introduction to the process of installing
46 Gentoo on your computer. Remember to read each option carefully. There is
47 detailed help available for each step of installation at the top of the screen.
48 We recommend that you always read the help provided before making your choices.
49 Note that at any time during the installation process, you can save your
50 configuration progress in case you need to resume your installation at a later
51 time. Use the <c>Tab</c> key (on your keyboard) to move around the menus within
52 a screen and the <c>Enter</c> key to confirm an action.
53 </p>
54
55 </body>
56 </subsection>
57 </section>
58
59 <section>
60 <title>Preinstallation Configuration</title>
61 <subsection>
62 <title>Optional: Manual Network Configuration</title>
63 <body>
64
65 <p>
66 Even though you will be installing without a connection to the internet, you
67 can manually set up connections to your local area network (LAN), in case you
68 want to install Gentoo from another machine on your LAN.
69 </p>
70
71 <p>
72 If you wish to enable SSH access to the machine (for remote installation), you
73 can start <c>sshd</c> and specify a root password.
74 </p>
75
76 </body>
77 </subsection>
78 <subsection>
79 <title>Optional: Load Additional Kernel Modules</title>
80 <body>
81
82 <p>
83 If you need to load more kernel modules to support your hardware, enter their
84 names, each separated by a space.
85 </p>
86
87 </body>
88 </subsection>
89 </section>
90
91 <section>
92 <title>Partitioning</title>
93 <subsection>
94 <title>Preparing the disks</title>
95 <body>
96
97 <p>
98 In order to install Gentoo on your machine, you will need to prepare your
99 disks. The <c>Partitioning</c> screen will show you a list of detected disks and
100 allow you to specify the filesystems you would like to have on your
101 partitions. Selecting <c>Clear partitions</c> will erase all previous partitions on
102 your disk, so be careful with this option! It is also possible to resize
103 certain partition types.
104 </p>
105
106 <p>
107 If you choose to go with the <c>Recommended layout</c>, the installer will
108 create three partitions: 100MB for <path>/boot</path>, a <path>/swap</path>
109 partition up to 512MB in size, and the rest of the available space on the disk
110 is used for <path>/</path>, the root partition. If you have more than 4GB of
111 unpartitioned space, using the "Recommended layout" will automatically configure
112 your partitions without destroying any data on any existing partitions.
113 </p>
114
115 </body>
116 </subsection>
117 </section>
118
119 <section>
120 <title>Network Mounts</title>
121 <subsection>
122 <title>Optional: Define network mounts</title>
123 <body>
124
125 <p>
126 This screen lets you set up and use any existing network mounts during and
127 after installation. At this time, only NFS is supported.
128 </p>
129
130 </body>
131 </subsection>
132 </section>
133
134 <section>
135 <title>Stage Selection</title>
136 <subsection>
137 <title>Dynamic stage generation</title>
138 <body>
139
140 <p>
141 Since you are performing an installation <e>without</e> an internet connection,
142 you <e>must</e> select <c>3+GRP</c> from the stage options present. Then, on the next
143 screen, select <c>Create from CD</c>. Everything you need to build your system will
144 then be generated from the files on the LiveCD.
145 </p>
146
147 <warn>
148 Do <e>not</e> select any options other than those specified above when you are
149 installing without an internet connection.
150 </warn>
151
152 </body>
153 </subsection>
154 </section>
155
156 <section>
157 <title>Portage Tree</title>
158 <subsection>
159 <title>Obtaining a Portage tree</title>
160 <body>
161
162 <p>
163 You must choose <c>Snapshot</c> on this screen. The installer will automatically
164 install a Portage tree from the LiveCD once you select Snapshot; you do not
165 need to specify a snapshot URI.
166 </p>
167
168 </body>
169 </subsection>
170 </section>
171
172 <section>
173 <title>make.conf</title>
174 <subsection>
175 <title>USE flags</title>
176 <body>
177
178 <p>
179 Since you are performing a GRP/networkless install, you will not be allowed to
180 select USE flags before installation. However, you are free to set your own USE
181 flags in <path>/etc/make.conf</path> after you have rebooted into your finished
182 system.
183 </p>
184
185 <p>
186 Next, select <c>Stable</c> and proceed to the next screen.
187 </p>
188
189 </body>
190 </subsection>
191 <subsection>
192 <title>CFLAGS</title>
193 <body>
194
195 <p>
196 Select your processor type in the CFLAGS section along with any custom
197 optimizations you may want, such as <c>-O2</c> and <c>-pipe</c>.
198 </p>
199
200 </body>
201 </subsection>
202 <subsection>
203 <title>Features</title>
204 <body>
205
206 <p>
207 Any other options you wish to set for future use should be selected now. Read
208 through the available FEATURES and make your choices.
209 </p>
210
211 </body>
212 </subsection>
213 </section>
214
215 <section>
216 <title>Kernel Sources</title>
217 <subsection>
218 <title>Using the LiveCD kernel</title>
219 <body>
220
221 <p>
222 You must use the kernel present on the LiveCD for the GRP/networkless
223 install. This is merely a <c>gentoo-sources</c> kernel compiled by
224 <c>genkernel</c>, Gentoo's automated compilation utility, and will give you a
225 kernel that automatically detects and configures your hardware upon boot.
226 </p>
227
228 <p>
229 Select <c>LiveCD kernel</c> and continue to the next screen.
230 </p>
231
232 </body>
233 </subsection>
234 </section>
235
236 <section>
237 <title>Bootloader</title>
238 <subsection>
239 <title>Making your choice</title>
240 <body>
241
242 <p>
243 This screen allows to you choose your bootloader. Next, select your boot device
244 and (optionally) specify any additional boot options.
245 </p>
246
247 </body>
248 </subsection>
249 </section>
250
251 <section>
252 <title>Timezone</title>
253 <subsection>
254 <title>Choose your timezone</title>
255 <body>
256
257 <p>
258 Study the list and select the region closest to your actual location.
259 </p>
260
261 </body>
262 </subsection>
263 </section>
264
265 <section>
266 <title>Networking</title>
267 <subsection>
268 <title>Add network device</title>
269 <body>
270
271 <p>
272 On this screen, you will be able to configure the various network interface
273 devices detected on your computer. Read the available options carefully.
274 </p>
275
276 <p>
277 The next screen gives you a choice between DHCP and manual IP address
278 configuration. Once your network interface is properly configured, you will
279 need to create a hostname for your system. Optionally, you may specify a
280 domainname and any DNS server information needed.
281 </p>
282
283 </body>
284 </subsection>
285 </section>
286
287 <section>
288 <title>Extra Packages</title>
289 <subsection>
290 <title>Optional: installing extra packages</title>
291 <body>
292
293 <p>
294 The LiveCD contains a number of available pre-built packages. If you wish to
295 install any of them, check the appropriate box.
296 </p>
297
298 <impo>
299 As you are installing Gentoo without an internet connection, you cannot add any
300 extra packages other than those marked <c>(GRP)</c>.
301 </impo>
302
303 </body>
304 </subsection>
305 </section>
306
307 <section>
308 <title>Startup Services</title>
309 <subsection>
310 <body>
311
312 <p>
313 This screen allows you to choose various services to load at system boot. Study
314 the available options and their descriptions carefully, and then select your
315 desired services. For example, if you have chosen to install <c>xorg-x11</c>
316 and want to boot straight into a graphical desktop, then you would select
317 "xdm" from the list.
318 </p>
319
320 </body>
321 </subsection>
322 </section>
323
324 <section>
325 <title>Other Settings</title>
326 <subsection>
327 <title>Miscellaneous options</title>
328 <body>
329
330 <p>
331 Now you will be able to change various settings, including keyboard layout,
332 graphical display manager, the default editor, and whether to set your hardware
333 clock to UTC or local time.
334 </p>
335
336 </body>
337 </subsection>
338 </section>
339
340 <section>
341 <title>Users</title>
342 <subsection>
343 <title>Adding users and groups</title>
344 <body>
345
346 <p>
347 First set the root password for the system administrator (the <e>root</e>
348 user).
349 </p>
350
351 <p>
352 We <e>strongly</e> recommend that you create a regular user for daily work.
353 Working as root all the time is <e>dangerous</e> and should be avoided! Create
354 your users, set their passwords, and add them to the appropriate groups. You
355 can optionally change their home directories, select their login shell, and set
356 helpful comments.
357 </p>
358
359 </body>
360 </subsection>
361 </section>
362
363 <section>
364 <title>Review</title>
365 <subsection>
366 <title>Finishing up</title>
367 <body>
368
369 <p>
370 Please take the time to double-check each step of the installation process,
371 ensuring that your system is properly configured. When you have finished
372 reviewing, you may save your progress and exit, or select <c>Install</c> to
373 begin automatically installing Gentoo.
374 </p>
375
376 <p>
377 The installer will alert you when it has finished. It will then return you to
378 the command prompt. All you need to do to reboot is type:
379 </p>
380
381 <pre caption="Rebooting">
382 # <i>shutdown -r now</i>
383 </pre>
384
385 <p>
386 Congratulations, your system is now fully equipped! Continue with <uri
387 link="?part=1&amp;chap=5">Where to go from here?</uri> to learn more about
388 Gentoo.
389 </p>
390
391 </body>
392 </subsection>
393 </section>
394 </sections>
395
396 <!--
397 Steps of the dialog:
398 (pre): type installer at the prompt to begin the dialog
399 1. Partitioning
400 (note: we absolutely must include partitioning info here; gli-dialog refers
401 users to the partitioning info in the gentoo handbook! note that the gtkfe
402 installer already has this partition info in its graphical help screens)
403
404 2. Network mounts
405 3. Stage Selection
406 4. kernel sources
407 5. bootloader
408 6. timezone
409 7. network interface selection/configuration (inc. dhcp/static-manual)
410 8. hostname/domainname/dns
411 9. Optional: install additional packages
412 10. set root password
413 11. add user, set passwords/groups
414 12. review
415 (post) finishes, drops to prompt: shutdown -r now
416 -->
417
418
419
420 --
421 gentoo-doc-cvs@g.o mailing list