/[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.10 - (hide annotations) (download) (as text)
Thu Aug 15 18:39:36 2013 UTC (16 months, 1 week ago) by swift
Branch: MAIN
CVS Tags: HEAD
Changes since 1.9: +4 -4 lines
File MIME type: application/xml
Fix bug #481204 - Make need for initramfs with separate /usr more prominent

1 neysx 1.1 <?xml version='1.0' encoding="UTF-8"?>
2 swift 1.10 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall-system.xml,v 1.9 2013/05/02 17:46:14 swift Exp $ -->
3 neysx 1.1 <!DOCTYPE included SYSTEM "/dtd/guide.dtd">
4    
5     <included>
6    
7 swift 1.10 <version>10</version>
8     <date>2013-08-15</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 swift 1.8 to the <c>net.lo</c> init script and add them to the default run level as
62 swift 1.5 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 neysx 1.1 </p>
66    
67     <pre caption="Configure networking">
68 swift 1.3 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 swift 1.5 livecd conf.d # <i>echo 'hostname="myhostname"' > hostname</i>
74 neysx 1.1 livecd conf.d # <i>rc-update add net.eth0 default</i>
75 swift 1.3 <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 neysx 1.1 <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 swift 1.9 Edit <path>/etc/conf.d/hwclock</path> to set clock options.
98 neysx 1.1 </p>
99    
100 swift 1.9 <pre caption="Edit /etc/conf.d/hwclock">
101     livecd # <i>nano -w /etc/conf.d/hwclock</i>
102 neysx 1.1 </pre>
103    
104     <p>
105 swift 1.3 Check the system configuration in <path>/etc/rc.conf</path> and
106     <path>/etc/conf.d/keymaps</path> and edit any of those files if required.
107 neysx 1.1 </p>
108    
109     <pre caption="Optional: edit some config files">
110     livecd conf.d # <i>nano -w /etc/rc.conf</i>
111     livecd conf.d # <i>nano -w /etc/conf.d/keymaps</i>
112     </pre>
113    
114     </body>
115     </section>
116     <section>
117     <title>Installing System Tools</title>
118    
119     <body test="func:keyval('raid+lvm')='yes'">
120    
121     <p>
122     Install RAID and LVM2 utilities.
123     </p>
124    
125     <pre caption="Install RAID &amp; LVM2 tools">
126     livecd conf.d # <i>emerge mdadm lvm2</i>
127 swift 1.6 livecd conf.d # <i>rc-update add mdraid boot</i>
128     livecd conf.d # <i>rc-update add lvm boot</i>
129 neysx 1.1 </pre>
130    
131     </body>
132     <body>
133    
134     <p>
135     Install a system logger like <c>syslog-ng</c> and a cron daemon like
136     <c>vixie-cron</c>, and add them to the default run level.
137     </p>
138    
139     <note>
140     Cron daemons depend on an MTA. <c>mail-mta/ssmtp</c> will be pulled in as a
141     dependency. If you want to use a more advanced MTA, you might want to install
142     it now. If you are in a hurry, let ssmtp be installed and remove it later when
143     you install the MTA of your choice.
144     </note>
145    
146     <pre caption="Install a syslogger and a cron daemon">
147     livecd conf.d # <i>time emerge syslog-ng vixie-cron</i>
148    
149     real 1m54.099s
150     user 1m2.630s
151     sys 0m34.620s
152     livecd conf.d # <i>rc-update add syslog-ng default</i>
153     livecd conf.d # <i>rc-update add vixie-cron default</i>
154     </pre>
155    
156     <p>
157     Install the necessary file system tools (<c>xfsprogs</c>, <c>reiserfsprogs</c>
158     or <c>jfsutils</c>) and networking tools (<c>dhcpcd</c> or <c>ppp</c>) if you
159     need any.
160     </p>
161    
162     <pre caption="Install extra tools if required">
163     livecd conf.d # <i>emerge xfsprogs</i> <comment>(If you use the XFS file system)</comment>
164     livecd conf.d # <i>emerge jfsutils</i> <comment>(If you use the JFS file system)</comment>
165     livecd conf.d # <i>emerge reiserfsprogs</i> <comment>(If you use the Reiser file system)</comment>
166     livecd conf.d # <i>emerge dhcpcd</i> <comment>(If you need a DHCP client)</comment>
167     livecd conf.d # <i>emerge ppp</i> <comment>(If you need PPPoE ADSL connectivity)</comment>
168     </pre>
169    
170     </body>
171     </section>
172    
173     <section id="grub">
174     <title>Configuring the Bootloader</title>
175    
176     <body>
177     <p>
178 swift 1.4 Emerge <c>grub</c> and configure it. Do not forget to update the necessary boot
179     parameters if you are using an initramfs.
180 neysx 1.1 </p>
181    
182     <pre caption="Emerge grub and edit its configuration file">
183     livecd conf.d # <i>time emerge grub</i>
184    
185     real 1m4.634s
186     user 0m39.460s
187     sys 0m15.280s
188     livecd conf.d # <i>nano -w /boot/grub/grub.conf</i>
189     </pre>
190    
191     <pre caption="Example grub.conf">
192     default 0
193     timeout 10
194    
195 nightmorph 1.2 title Gentoo
196 neysx 1.1 root (hd0,0)
197     kernel /boot/kernel root=<keyval id="root"/>
198 swift 1.10 initrd /boot/initramfs <comment># Only when initramfs is needed like with separate /usr partition</comment>
199 neysx 1.1 </pre>
200    
201     <pre caption="Install grub" test="not(contains(func:keyval('root'),'md'))">
202     livecd conf.d # <i>grub</i>
203     Probing devices to guess BIOS drives. This may take a long time.
204    
205     grub> <i>root (hd0,0)</i>
206     Filesystem type is ext2fs, partition type 0xfd
207    
208     grub> <i>setup (hd0)</i>
209     Checking if "/boot/grub/stage1" exists... yes
210     Checking if "/boot/grub/stage2" exists... yes
211     Checking if "/boot/grub/e2fs_stage1_5" exists... yes
212     Running "embed /boot/grub/e2fs_stage1_5 (hd0)"... 16 sectors are embedded.
213     succeeded
214     Running "install /boot/grub/stage1 (hd0) (hd0)1+16 p (hd0,0)/boot/grub/stage2 /boot/
215     grub/menu.lst"... succeeded
216     Done.
217    
218     grub> <i>quit</i>
219     </pre>
220    
221     <pre caption="Install grub on both disks" test="contains(func:keyval('root'),'md')">
222     livecd conf.d # <i>grub</i>
223     Probing devices to guess BIOS drives. This may take a long time.
224    
225     grub> <i>root (hd0,0)</i>
226     Filesystem type is ext2fs, partition type 0xfd
227    
228     grub> <i>setup (hd0)</i>
229     Checking if "/boot/grub/stage1" exists... yes
230     Checking if "/boot/grub/stage2" exists... yes
231     Checking if "/boot/grub/e2fs_stage1_5" exists... yes
232     Running "embed /boot/grub/e2fs_stage1_5 (hd0)"... 16 sectors are embedded.
233     succeeded
234     Running "install /boot/grub/stage1 (hd0) (hd0)1+16 p (hd0,0)/boot/grub/stage2 /boot/
235     grub/menu.lst"... succeeded
236     Done.
237    
238     grub> <i>root (hd1,0)</i>
239     Filesystem type is ext2fs, partition type 0xfd
240    
241     grub> <i>setup (hd1)</i>
242    
243     grub> <i>quit</i>
244     </pre>
245    
246     </body>
247     </section>
248     </included>

  ViewVC Help
Powered by ViewVC 1.1.20