/[gentoo]/xml/htdocs/doc/en/handbook/hb-install-tools.xml
Gentoo

Contents of /xml/htdocs/doc/en/handbook/hb-install-tools.xml

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.52 - (hide annotations) (download) (as text)
Mon Oct 24 18:50:50 2011 UTC (2 years, 11 months ago) by swift
Branch: MAIN
Changes since 1.51: +2 -2 lines
File MIME type: application/xml
Fix typo, thanks to Chema Alonso (nimiux@gentoo.org)

1 swift 1.14 <?xml version='1.0' encoding='UTF-8'?>
2     <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
3    
4 swift 1.4 <!-- The content of this document is licensed under the CC-BY-SA license -->
5 neysx 1.39 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
6 swift 1.4
7 swift 1.52 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-tools.xml,v 1.51 2011/10/23 10:32:38 swift Exp $ -->
8 swift 1.6
9 swift 1.2 <sections>
10 swift 1.27
11 neysx 1.43 <abstract>
12 nightmorph 1.46 In this chapter we help you choose and install some important tools.
13 neysx 1.43 </abstract>
14    
15 swift 1.51 <version>10</version>
16     <date>2011-10-23</date>
17 swift 1.27
18 swift 1.1 <section>
19     <title>System Logger</title>
20     <body>
21    
22     <p>
23 neysx 1.37 Some tools are missing from the <e>stage3</e> archive because several packages
24     provide the same functionality. It is now up to you to choose which ones you
25     want to install.
26 swift 1.1 </p>
27    
28 swift 1.3 <p>
29     The first tool you need to decide on has to provide logging facilities for your
30     system. Unix and Linux have an excellent history of logging capabilities -- if
31     you want you can log everything that happens on your system in logfiles. This
32     happens through the <e>system logger</e>.
33     </p>
34    
35     <p>
36     Gentoo offers several system loggers to choose from. There are <c>sysklogd</c>,
37 swift 1.18 which is the traditional set of system logging daemons, <c>syslog-ng</c>, an
38     advanced system logger, and <c>metalog</c> which is a highly-configurable
39     system logger. Others might be available through Portage as well - our number of
40     available packages increases on a daily basis.
41 swift 1.3 </p>
42    
43     <p>
44 swift 1.28 If you plan on using <c>sysklogd</c> or <c>syslog-ng</c> you might want to
45     install <c>logrotate</c> afterwards as those system loggers don't provide any
46     rotation mechanism for the log files.
47     </p>
48    
49 swift 1.3 <p>
50     To install the system logger of your choice, <c>emerge</c> it and have it added
51     to the default runlevel using <c>rc-update</c>. The following example installs
52 swift 1.31 <c>syslog-ng</c>. Of course substitute with your system logger:
53 swift 1.3 </p>
54    
55     <pre caption="Installing a system logger">
56 swift 1.31 # <i>emerge syslog-ng</i>
57     # <i>rc-update add syslog-ng default</i>
58 swift 1.3 </pre>
59    
60 swift 1.1 </body>
61 swift 1.2 </section>
62     <section>
63 swift 1.3 <title>Optional: Cron Daemon</title>
64 swift 1.1 <body>
65    
66     <p>
67 swift 1.3 Next is the cron daemon. Although it is optional and not required for your
68     system, it is wise to install one. But what is a cron daemon? A cron daemon
69     executes scheduled commands. It is very handy if you need to execute some
70     command regularly (for instance daily, weekly or monthly).
71     </p>
72    
73     <p>
74     Gentoo offers three possible cron daemons: <c>dcron</c>, <c>fcron</c> and
75 swift 1.13 <c>vixie-cron</c>. Installing one of them is similar to installing a system
76 swift 1.16 logger. However, <c>dcron</c> and <c>fcron</c> require an extra configuration
77 swift 1.13 command, namely <c>crontab /etc/crontab</c>. If you don't know what to choose,
78     use <c>vixie-cron</c>.
79 swift 1.1 </p>
80    
81 swift 1.19 <p>
82     We only provide <c>vixie-cron</c> for networkless installations. If you want
83     another cron daemon you can wait and install it later on.
84     </p>
85    
86 swift 1.3 <pre caption="Installing a cron daemon">
87 swift 1.17 # <i>emerge vixie-cron</i>
88 seemant 1.10 # <i>rc-update add vixie-cron default</i>
89 swift 1.17 <comment>(Only if you have chosen dcron or fcron)</comment> # <i>crontab /etc/crontab</i>
90 swift 1.3 </pre>
91    
92 swift 1.1 </body>
93 swift 1.2 </section>
94     <section>
95 swift 1.25 <title>Optional: File Indexing</title>
96     <body>
97    
98     <p>
99     If you want to index your system's files so you are able to quickly
100     locate them using the <c>locate</c> tool, you need to install
101 nightmorph 1.49 <c>sys-apps/mlocate</c>.
102 swift 1.25 </p>
103    
104 nightmorph 1.49 <pre caption="Installing mlocate">
105     # <i>emerge mlocate</i>
106 swift 1.25 </pre>
107    
108     </body>
109     </section>
110     <section>
111 swift 1.51 <title>Optional: Remote Access</title>
112     <body>
113    
114     <p>
115     If you need to access your system remotely after installation, don't forget to
116     add <c>sshd</c> to the default runlevel:
117     </p>
118    
119     <pre caption="Adding sshd to the default runlevel">
120     # <i>rc-update add sshd default</i>
121     </pre>
122    
123     <p>
124     If you need serial console access (which is possible in case of remote servers),
125     you'll need to uncomment the serial console section in
126     <path>/etc/inittab</path>.
127     </p>
128    
129     <pre caption="Editing /etc/inittab">
130     # <i>nano -w /etc/inittab</i>
131     </pre>
132    
133     <p>
134     The following excerpt shows the uncommented section:
135     </p>
136    
137 swift 1.52 <pre caption="Uncommenting serial consoles in inittab">
138 swift 1.51 <comment># SERIAL CONSOLES</comment>
139     s0:12345:respawn:/sbin/agetty 9600 ttyS0 vt100
140     s1:12345:respawn:/sbin/agetty 9600 ttyS1 vt100
141     </pre>
142    
143     </body>
144     </section>
145     <section>
146 swift 1.3 <title>File System Tools</title>
147 nightmorph 1.44 <subsection>
148 swift 1.1 <body>
149    
150     <p>
151 swift 1.3 Depending on what file systems you are using, you need to install the necessary
152     file system utilities (for checking the filesystem integrity, creating
153 jkt 1.48 additional file systems etc.). Please note that tools for managing ext2/ext3
154     filesystems (<c>e2fsprogs</c>) are already installed as a part of the system.
155 swift 1.3 </p>
156    
157     <p>
158     The following table lists the tools you need to install if you use a certain
159     file system:
160     </p>
161    
162     <table>
163     <tr>
164     <th>File System</th>
165     <th>Tool</th>
166     <th>Install Command</th>
167     </tr>
168     <tr>
169     <ti>XFS</ti>
170     <ti>xfsprogs</ti>
171 swift 1.17 <ti><c>emerge xfsprogs</c></ti>
172 swift 1.3 </tr>
173     <tr>
174     <ti>ReiserFS</ti>
175     <ti>reiserfsprogs</ti>
176 swift 1.17 <ti><c>emerge reiserfsprogs</c></ti>
177 swift 1.3 </tr>
178     <tr>
179     <ti>JFS</ti>
180     <ti>jfsutils</ti>
181 swift 1.17 <ti><c>emerge jfsutils</c></ti>
182 swift 1.3 </tr>
183     </table>
184    
185 nightmorph 1.44 </body>
186     </subsection>
187     <subsection test="contains('PPC PPC64', func:keyval('arch'))">
188     <title>Optional: RAID utilities for IBM hardware</title>
189     <body>
190    
191     <p>
192     If you are using SCSI RAID on a POWER5-based system, you should consider
193     installing the <c>iprutils</c> which will allow you to work with the RAID disk
194     array, get status on the disks in the arrays, and update microcode among other
195     functions.
196     </p>
197    
198     <pre caption="Installing iprutils">
199     # <i>emerge iprutils</i>
200     </pre>
201    
202     </body>
203     </subsection>
204     </section>
205     <section id="networking-tools">
206     <title>Networking Tools</title>
207     <subsection>
208     <body>
209    
210 neysx 1.36 <p>
211 nightmorph 1.46 If you don't require any additional networking-related tools (such as ppp or a
212     dhcp client) continue with <uri link="?part=1&amp;chap=10">Configuring the
213 swift 1.26 Bootloader</uri>.
214 swift 1.1 </p>
215    
216     </body>
217 nightmorph 1.44 </subsection>
218 swift 1.26 <subsection>
219     <title>Optional: Installing a DHCP Client</title>
220     <body>
221    
222     <p>
223     If you require Gentoo to automatically obtain an IP address for your network
224 neysx 1.41 interface(s), you need to install <c>dhcpcd</c> (or any other DHCP client --
225     see <uri link="?part=4&amp;chap=3">Modular Networking</uri> for a list of
226     available DHCP clients). If you don't do this now, you might not be able to
227 nightmorph 1.42 connect to the internet after the installation.
228 swift 1.26 </p>
229    
230     <pre caption="Installing dhcpcd">
231     # <i>emerge dhcpcd</i>
232     </pre>
233    
234     </body>
235     </subsection>
236     <subsection>
237     <title>Optional: Installing a PPPoE Client</title>
238 swift 1.1 <body>
239    
240     <p>
241 nightmorph 1.46 If you need <c>ppp</c> to connect to the net, you need to install it.
242 swift 1.3 </p>
243    
244 nightmorph 1.46 <pre caption="Installing ppp">
245     # <i>emerge ppp</i>
246 swift 1.3 </pre>
247    
248     <p>
249 cam 1.23 Now continue with <uri link="?part=1&amp;chap=10">Configuring the
250     Bootloader</uri>.
251 swift 1.1 </p>
252    
253     </body>
254 swift 1.26 </subsection>
255 swift 1.1 </section>
256 swift 1.2 </sections>

  ViewVC Help
Powered by ViewVC 1.1.20