| 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 & 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> |