/[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.5 - (show annotations) (download) (as text)
Wed Sep 21 19:47:55 2011 UTC (2 years, 9 months ago) by swift
Branch: MAIN
Changes since 1.4: +7 -5 lines
File MIME type: application/xml
Write hostname too during installation, variable is important for certain services to start (like mysql). reported by Eric Lajoie through e-mail

1 <?xml version='1.0' encoding="UTF-8"?>
2 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall-system.xml,v 1.4 2011/08/23 15:12:17 swift Exp $ -->
3 <!DOCTYPE included SYSTEM "/dtd/guide.dtd">
4
5 <included>
6
7 <version>5</version>
8 <date>2011-09-21</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 </pre>
129
130 </body>
131 <body>
132
133 <p>
134 Install a system logger like <c>syslog-ng</c> and a cron daemon like
135 <c>vixie-cron</c>, and add them to the default run level.
136 </p>
137
138 <note>
139 Cron daemons depend on an MTA. <c>mail-mta/ssmtp</c> will be pulled in as a
140 dependency. If you want to use a more advanced MTA, you might want to install
141 it now. If you are in a hurry, let ssmtp be installed and remove it later when
142 you install the MTA of your choice.
143 </note>
144
145 <pre caption="Install a syslogger and a cron daemon">
146 livecd conf.d # <i>time emerge syslog-ng vixie-cron</i>
147
148 real 1m54.099s
149 user 1m2.630s
150 sys 0m34.620s
151 livecd conf.d # <i>rc-update add syslog-ng default</i>
152 livecd conf.d # <i>rc-update add vixie-cron default</i>
153 </pre>
154
155 <p>
156 Install the necessary file system tools (<c>xfsprogs</c>, <c>reiserfsprogs</c>
157 or <c>jfsutils</c>) and networking tools (<c>dhcpcd</c> or <c>ppp</c>) if you
158 need any.
159 </p>
160
161 <pre caption="Install extra tools if required">
162 livecd conf.d # <i>emerge xfsprogs</i> <comment>(If you use the XFS file system)</comment>
163 livecd conf.d # <i>emerge jfsutils</i> <comment>(If you use the JFS file system)</comment>
164 livecd conf.d # <i>emerge reiserfsprogs</i> <comment>(If you use the Reiser file system)</comment>
165 livecd conf.d # <i>emerge dhcpcd</i> <comment>(If you need a DHCP client)</comment>
166 livecd conf.d # <i>emerge ppp</i> <comment>(If you need PPPoE ADSL connectivity)</comment>
167 </pre>
168
169 </body>
170 </section>
171
172 <section id="grub">
173 <title>Configuring the Bootloader</title>
174
175 <body>
176 <p>
177 Emerge <c>grub</c> and configure it. Do not forget to update the necessary boot
178 parameters if you are using an initramfs.
179 </p>
180
181 <pre caption="Emerge grub and edit its configuration file">
182 livecd conf.d # <i>time emerge grub</i>
183
184 real 1m4.634s
185 user 0m39.460s
186 sys 0m15.280s
187 livecd conf.d # <i>nano -w /boot/grub/grub.conf</i>
188 </pre>
189
190 <pre caption="Example grub.conf">
191 default 0
192 timeout 10
193
194 title Gentoo
195 root (hd0,0)
196 kernel /boot/kernel root=<keyval id="root"/>
197 </pre>
198
199 <pre caption="Install grub" test="not(contains(func:keyval('root'),'md'))">
200 livecd conf.d # <i>grub</i>
201 Probing devices to guess BIOS drives. This may take a long time.
202
203 grub> <i>root (hd0,0)</i>
204 Filesystem type is ext2fs, partition type 0xfd
205
206 grub> <i>setup (hd0)</i>
207 Checking if "/boot/grub/stage1" exists... yes
208 Checking if "/boot/grub/stage2" exists... yes
209 Checking if "/boot/grub/e2fs_stage1_5" exists... yes
210 Running "embed /boot/grub/e2fs_stage1_5 (hd0)"... 16 sectors are embedded.
211 succeeded
212 Running "install /boot/grub/stage1 (hd0) (hd0)1+16 p (hd0,0)/boot/grub/stage2 /boot/
213 grub/menu.lst"... succeeded
214 Done.
215
216 grub> <i>quit</i>
217 </pre>
218
219 <pre caption="Install grub on both disks" test="contains(func:keyval('root'),'md')">
220 livecd conf.d # <i>grub</i>
221 Probing devices to guess BIOS drives. This may take a long time.
222
223 grub> <i>root (hd0,0)</i>
224 Filesystem type is ext2fs, partition type 0xfd
225
226 grub> <i>setup (hd0)</i>
227 Checking if "/boot/grub/stage1" exists... yes
228 Checking if "/boot/grub/stage2" exists... yes
229 Checking if "/boot/grub/e2fs_stage1_5" exists... yes
230 Running "embed /boot/grub/e2fs_stage1_5 (hd0)"... 16 sectors are embedded.
231 succeeded
232 Running "install /boot/grub/stage1 (hd0) (hd0)1+16 p (hd0,0)/boot/grub/stage2 /boot/
233 grub/menu.lst"... succeeded
234 Done.
235
236 grub> <i>root (hd1,0)</i>
237 Filesystem type is ext2fs, partition type 0xfd
238
239 grub> <i>setup (hd1)</i>
240
241 grub> <i>quit</i>
242 </pre>
243
244 </body>
245 </section>
246 </included>

  ViewVC Help
Powered by ViewVC 1.1.20