/[gentoo]/xml/htdocs/doc/en/gentoo-x86-quickinstall-system.xml
Gentoo

Contents of /xml/htdocs/doc/en/gentoo-x86-quickinstall-system.xml

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.4 - (show annotations) (download) (as text)
Tue Aug 23 15:12:17 2011 UTC (3 years, 3 months ago) by swift
Branch: MAIN
Changes since 1.3: +5 -4 lines
File MIME type: application/xml
Fix bug #376691 - Inform users about metadata and initramfs relation. Also mention domdadm in case of genkernel initramfs usage. Thanks to Andre Kloth for reporting

1 <?xml version='1.0' encoding="UTF-8"?>
2 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall-system.xml,v 1.3 2011/08/12 19:09:10 swift Exp $ -->
3 <!DOCTYPE included SYSTEM "/dtd/guide.dtd">
4
5 <included>
6
7 <version>4</version>
8 <date>2011-08-23</date>
9
10 <section>
11 <title>Configure the system</title>
12
13 <body test="func:keyval('raid+lvm')='no'">
14
15 <p>
16 Edit your <path>/etc/fstab</path> and replace <c>BOOT</c>, <c>ROOT</c> and
17 <c>SWAP</c> with the actual partition names. Don't forget to check that the
18 file systems match your installation.
19 </p>
20
21 <pre caption="Example fstab">
22 livecd linux # <i>cd /etc</i>
23 livecd etc # <i>nano -w fstab</i>
24 /dev/<i>sda1</i> /boot ext2 noauto,noatime 1 2
25 /dev/<i>sda3</i> / ext3 noatime 0 1
26 /dev/<i>sda2</i> none swap sw 0 0
27 </pre>
28
29 </body>
30 <body test="func:keyval('raid+lvm')='yes'">
31
32 <p>
33 Edit your <path>/etc/fstab</path> and replace <c>BOOT</c>, <c>ROOT</c> and
34 <c>SWAP</c> with the actual partition names and add your logical volumes. Don't
35 forget to check that the file systems match your installation.
36 </p>
37
38 <pre caption="Example fstab">
39 livecd linux # <i>cd /etc</i>
40 livecd etc # <i>nano -w fstab</i>
41 /dev/<i>md1</i> /boot ext2 noauto,noatime 1 2
42 /dev/<i>md3</i> / ext3 noatime 0 1
43 /dev/<i>sda2</i> none swap sw,pri=1 0 0
44 /dev/<i>sdb2</i> none swap sw,pri=1 0 0
45 /dev/vg/usr /usr ext3 noatime 1 2
46 /dev/vg/portage /usr/portage ext2 noatime 1 2
47 /dev/vg/distfiles /usr/portage/distfiles ext2 noatime 1 2
48 /dev/vg/home /home ext3 noatime 1 2
49 /dev/vg/opt /opt ext3 noatime 1 2
50 /dev/vg/tmp /tmp ext2 noatime 1 2
51 /dev/vg/var /var ext3 noatime 1 2
52 /dev/vg/vartmp /var/tmp ext2 noatime 1 2
53 </pre>
54
55 </body>
56 <body>
57
58 <p>
59 Configure your network in <path>/etc/conf.d/net</path>. Add the <c>net.eth0</c>
60 init script to the default run level. If you have multiple NICs, symlink them
61 to the <c>net.eth0</c> init script and add them to the default run level as
62 well. Either edit <path>/etc/conf.d/net</path> with <c>nano</c> or use the
63 following commands:
64 </p>
65
66 <pre caption="Configure networking">
67 livecd etc # <i>cd init.d</i>
68 livecd init.d # <i>ln -s net.lo net.eth0</i>
69 livecd init.d # <i>cd ../conf.d</i>
70 livecd conf.d # <i>echo 'config_eth0="192.168.1.10 netmask 255.255.255.0 brd 192.168.1.255"' >> net</i>
71 livecd conf.d # <i>echo 'routes_eth0="default via 192.168.1.1"' >> net</i>
72 livecd conf.d # <i>rc-update add net.eth0 default</i>
73 <comment>(If you compiled your network card driver as a module, add it to /etc/conf.d/modules</comment>
74 livecd conf.d # <i>echo 'modules="r8169"' >> /etc/conf.d/modules</i>
75 <comment>(If you want to reconnect via ssh after you have rebooted your new box)</comment>
76 livecd conf.d # <i>rc-update add sshd default</i>
77 </pre>
78
79 <note>
80 Emerge <c>pcmciautils</c> if you need support for PCMCIA cards.
81 </note>
82
83 <p>
84 Set the root password using <c>passwd</c>.
85 </p>
86
87 <pre caption="Set the root password">
88 livecd conf.d # <i>passwd</i>
89 New UNIX password: <comment>type_the_password</comment>
90 Retype new UNIX password: <comment>type_the_password_again</comment>
91 passwd: password updated successfully
92 </pre>
93
94 <p>
95 Edit <path>/etc/timezone</path> to define the time zone you used
96 previously.
97 </p>
98
99 <pre caption="Edit /etc/timezone">
100 Europe/Brussels
101 </pre>
102
103 <p>
104 Check the system configuration in <path>/etc/rc.conf</path> and
105 <path>/etc/conf.d/keymaps</path> and edit any of those files if required.
106 </p>
107
108 <pre caption="Optional: edit some config files">
109 livecd conf.d # <i>nano -w /etc/rc.conf</i>
110 livecd conf.d # <i>nano -w /etc/conf.d/keymaps</i>
111 </pre>
112
113 </body>
114 </section>
115 <section>
116 <title>Installing System Tools</title>
117
118 <body test="func:keyval('raid+lvm')='yes'">
119
120 <p>
121 Install RAID and LVM2 utilities.
122 </p>
123
124 <pre caption="Install RAID &amp; LVM2 tools">
125 livecd conf.d # <i>emerge mdadm lvm2</i>
126 </pre>
127
128 </body>
129 <body>
130
131 <p>
132 Install a system logger like <c>syslog-ng</c> and a cron daemon like
133 <c>vixie-cron</c>, and add them to the default run level.
134 </p>
135
136 <note>
137 Cron daemons depend on an MTA. <c>mail-mta/ssmtp</c> will be pulled in as a
138 dependency. If you want to use a more advanced MTA, you might want to install
139 it now. If you are in a hurry, let ssmtp be installed and remove it later when
140 you install the MTA of your choice.
141 </note>
142
143 <pre caption="Install a syslogger and a cron daemon">
144 livecd conf.d # <i>time emerge syslog-ng vixie-cron</i>
145
146 real 1m54.099s
147 user 1m2.630s
148 sys 0m34.620s
149 livecd conf.d # <i>rc-update add syslog-ng default</i>
150 livecd conf.d # <i>rc-update add vixie-cron default</i>
151 </pre>
152
153 <p>
154 Install the necessary file system tools (<c>xfsprogs</c>, <c>reiserfsprogs</c>
155 or <c>jfsutils</c>) and networking tools (<c>dhcpcd</c> or <c>ppp</c>) if you
156 need any.
157 </p>
158
159 <pre caption="Install extra tools if required">
160 livecd conf.d # <i>emerge xfsprogs</i> <comment>(If you use the XFS file system)</comment>
161 livecd conf.d # <i>emerge jfsutils</i> <comment>(If you use the JFS file system)</comment>
162 livecd conf.d # <i>emerge reiserfsprogs</i> <comment>(If you use the Reiser file system)</comment>
163 livecd conf.d # <i>emerge dhcpcd</i> <comment>(If you need a DHCP client)</comment>
164 livecd conf.d # <i>emerge ppp</i> <comment>(If you need PPPoE ADSL connectivity)</comment>
165 </pre>
166
167 </body>
168 </section>
169
170 <section id="grub">
171 <title>Configuring the Bootloader</title>
172
173 <body>
174 <p>
175 Emerge <c>grub</c> and configure it. Do not forget to update the necessary boot
176 parameters if you are using an initramfs.
177 </p>
178
179 <pre caption="Emerge grub and edit its configuration file">
180 livecd conf.d # <i>time emerge grub</i>
181
182 real 1m4.634s
183 user 0m39.460s
184 sys 0m15.280s
185 livecd conf.d # <i>nano -w /boot/grub/grub.conf</i>
186 </pre>
187
188 <pre caption="Example grub.conf">
189 default 0
190 timeout 10
191
192 title Gentoo
193 root (hd0,0)
194 kernel /boot/kernel root=<keyval id="root"/>
195 </pre>
196
197 <pre caption="Install grub" test="not(contains(func:keyval('root'),'md'))">
198 livecd conf.d # <i>grub</i>
199 Probing devices to guess BIOS drives. This may take a long time.
200
201 grub> <i>root (hd0,0)</i>
202 Filesystem type is ext2fs, partition type 0xfd
203
204 grub> <i>setup (hd0)</i>
205 Checking if "/boot/grub/stage1" exists... yes
206 Checking if "/boot/grub/stage2" exists... yes
207 Checking if "/boot/grub/e2fs_stage1_5" exists... yes
208 Running "embed /boot/grub/e2fs_stage1_5 (hd0)"... 16 sectors are embedded.
209 succeeded
210 Running "install /boot/grub/stage1 (hd0) (hd0)1+16 p (hd0,0)/boot/grub/stage2 /boot/
211 grub/menu.lst"... succeeded
212 Done.
213
214 grub> <i>quit</i>
215 </pre>
216
217 <pre caption="Install grub on both disks" test="contains(func:keyval('root'),'md')">
218 livecd conf.d # <i>grub</i>
219 Probing devices to guess BIOS drives. This may take a long time.
220
221 grub> <i>root (hd0,0)</i>
222 Filesystem type is ext2fs, partition type 0xfd
223
224 grub> <i>setup (hd0)</i>
225 Checking if "/boot/grub/stage1" exists... yes
226 Checking if "/boot/grub/stage2" exists... yes
227 Checking if "/boot/grub/e2fs_stage1_5" exists... yes
228 Running "embed /boot/grub/e2fs_stage1_5 (hd0)"... 16 sectors are embedded.
229 succeeded
230 Running "install /boot/grub/stage1 (hd0) (hd0)1+16 p (hd0,0)/boot/grub/stage2 /boot/
231 grub/menu.lst"... succeeded
232 Done.
233
234 grub> <i>root (hd1,0)</i>
235 Filesystem type is ext2fs, partition type 0xfd
236
237 grub> <i>setup (hd1)</i>
238
239 grub> <i>quit</i>
240 </pre>
241
242 </body>
243 </section>
244 </included>

  ViewVC Help
Powered by ViewVC 1.1.20