/[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.50 - (hide annotations) (download) (as text)
Sat Sep 3 07:18:27 2011 UTC (2 years, 7 months ago) by swift
Branch: MAIN
Changes since 1.49: +1 -15 lines
File MIME type: application/xml
Bug #372427 - Remove EVMS from documentation as it is not supported anymore

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.50 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-tools.xml,v 1.49 2010/11/14 15:11:01 nightmorph 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 nightmorph 1.49 <version>9.2</version>
16     <date>2010-11-14</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.3 <title>File System Tools</title>
112 nightmorph 1.44 <subsection>
113 swift 1.1 <body>
114    
115     <p>
116 swift 1.3 Depending on what file systems you are using, you need to install the necessary
117     file system utilities (for checking the filesystem integrity, creating
118 jkt 1.48 additional file systems etc.). Please note that tools for managing ext2/ext3
119     filesystems (<c>e2fsprogs</c>) are already installed as a part of the system.
120 swift 1.3 </p>
121    
122     <p>
123     The following table lists the tools you need to install if you use a certain
124     file system:
125     </p>
126    
127     <table>
128     <tr>
129     <th>File System</th>
130     <th>Tool</th>
131     <th>Install Command</th>
132     </tr>
133     <tr>
134     <ti>XFS</ti>
135     <ti>xfsprogs</ti>
136 swift 1.17 <ti><c>emerge xfsprogs</c></ti>
137 swift 1.3 </tr>
138     <tr>
139     <ti>ReiserFS</ti>
140     <ti>reiserfsprogs</ti>
141 swift 1.17 <ti><c>emerge reiserfsprogs</c></ti>
142 swift 1.3 </tr>
143     <tr>
144     <ti>JFS</ti>
145     <ti>jfsutils</ti>
146 swift 1.17 <ti><c>emerge jfsutils</c></ti>
147 swift 1.3 </tr>
148     </table>
149    
150 nightmorph 1.44 </body>
151     </subsection>
152     <subsection test="contains('PPC PPC64', func:keyval('arch'))">
153     <title>Optional: RAID utilities for IBM hardware</title>
154     <body>
155    
156     <p>
157     If you are using SCSI RAID on a POWER5-based system, you should consider
158     installing the <c>iprutils</c> which will allow you to work with the RAID disk
159     array, get status on the disks in the arrays, and update microcode among other
160     functions.
161     </p>
162    
163     <pre caption="Installing iprutils">
164     # <i>emerge iprutils</i>
165     </pre>
166    
167     </body>
168     </subsection>
169     </section>
170     <section id="networking-tools">
171     <title>Networking Tools</title>
172     <subsection>
173     <body>
174    
175 neysx 1.36 <p>
176 nightmorph 1.46 If you don't require any additional networking-related tools (such as ppp or a
177     dhcp client) continue with <uri link="?part=1&amp;chap=10">Configuring the
178 swift 1.26 Bootloader</uri>.
179 swift 1.1 </p>
180    
181     </body>
182 nightmorph 1.44 </subsection>
183 swift 1.26 <subsection>
184     <title>Optional: Installing a DHCP Client</title>
185     <body>
186    
187     <p>
188     If you require Gentoo to automatically obtain an IP address for your network
189 neysx 1.41 interface(s), you need to install <c>dhcpcd</c> (or any other DHCP client --
190     see <uri link="?part=4&amp;chap=3">Modular Networking</uri> for a list of
191     available DHCP clients). If you don't do this now, you might not be able to
192 nightmorph 1.42 connect to the internet after the installation.
193 swift 1.26 </p>
194    
195     <pre caption="Installing dhcpcd">
196     # <i>emerge dhcpcd</i>
197     </pre>
198    
199     </body>
200     </subsection>
201     <subsection>
202     <title>Optional: Installing a PPPoE Client</title>
203 swift 1.1 <body>
204    
205     <p>
206 nightmorph 1.46 If you need <c>ppp</c> to connect to the net, you need to install it.
207 swift 1.3 </p>
208    
209 nightmorph 1.46 <pre caption="Installing ppp">
210     # <i>emerge ppp</i>
211 swift 1.3 </pre>
212    
213     <p>
214 cam 1.23 Now continue with <uri link="?part=1&amp;chap=10">Configuring the
215     Bootloader</uri>.
216 swift 1.1 </p>
217    
218     </body>
219 swift 1.26 </subsection>
220 swift 1.1 </section>
221 swift 1.2 </sections>

  ViewVC Help
Powered by ViewVC 1.1.20