/[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 - (hide annotations) (download) (as text)
Tue Aug 23 15:12:17 2011 UTC (3 years, 1 month 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 neysx 1.1 <?xml version='1.0' encoding="UTF-8"?>
2 swift 1.4 <!-- $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 neysx 1.1 <!DOCTYPE included SYSTEM "/dtd/guide.dtd">
4    
5     <included>
6    
7 swift 1.4 <version>4</version>
8     <date>2011-08-23</date>
9 neysx 1.1
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 swift 1.3 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 neysx 1.1 livecd conf.d # <i>rc-update add net.eth0 default</i>
73 swift 1.3 <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 neysx 1.1 <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 swift 1.3 Edit <path>/etc/timezone</path> to define the time zone you used
96 neysx 1.1 previously.
97     </p>
98    
99 swift 1.3 <pre caption="Edit /etc/timezone">
100     Europe/Brussels
101 neysx 1.1 </pre>
102    
103     <p>
104 swift 1.3 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 neysx 1.1 </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 swift 1.4 Emerge <c>grub</c> and configure it. Do not forget to update the necessary boot
176     parameters if you are using an initramfs.
177 neysx 1.1 </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 nightmorph 1.2 title Gentoo
193 neysx 1.1 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