/[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.7 - (show annotations) (download) (as text)
Sat Mar 31 13:27:30 2012 UTC (2 years ago) by swift
Branch: MAIN
Changes since 1.6: +4 -3 lines
File MIME type: application/xml
Updates regarding bug #407959 - Update on initramfs needs when using a separate /usr or other requirements

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

  ViewVC Help
Powered by ViewVC 1.1.20