source: general/sysutils/sysstat.xml@ 1552ac8

10.0 10.1 11.0 7.10 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus nosym perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 1552ac8 was 1552ac8, checked in by DJ Lucas <dj@…>, 5 years ago

[Systemd merge] - gpm, sysstat, udisks, udisks2, upower to finish Chapter 12

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@17457 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 10.7 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY sysstat-download-http "http://perso.wanadoo.fr/sebastien.godard/sysstat-&sysstat-version;.tar.xz">
8 <!ENTITY sysstat-download-ftp " ">
9 <!ENTITY sysstat-md5sum "b92ea90a60eda2b16e2667e6237402b1">
10 <!ENTITY sysstat-size "332 KB">
11 <!ENTITY sysstat-buildsize "8.5 MB">
12 <!ENTITY sysstat-time "0.1 SBU">
13]>
14
15<sect1 id="sysstat" xreflabel="Sysstat-&sysstat-version;">
16 <?dbhtml filename="sysstat.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Sysstat-&sysstat-version;</title>
24
25 <indexterm zone="sysstat">
26 <primary sortas="a-Sysstat">Sysstat</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Sysstat</title>
31
32 <para>The <application>Sysstat</application> package contains utilities
33 to monitor system performance and usage activity.
34 <application>Sysstat</application> contains the <command>sar</command>
35 utility, common to many commercial Unixes, and tools you can schedule via
36 cron to collect and historize performance and activity data.</para>
37
38 &lfs79_checked;&gcc6_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>Download (HTTP): <ulink url="&sysstat-download-http;"/></para>
44 </listitem>
45 <listitem>
46 <para>Download (FTP): <ulink url="&sysstat-download-ftp;"/></para>
47 </listitem>
48 <listitem>
49 <para>Download MD5 sum: &sysstat-md5sum;</para>
50 </listitem>
51 <listitem>
52 <para>Download size: &sysstat-size;</para>
53 </listitem>
54 <listitem>
55 <para>Estimated disk space required: &sysstat-buildsize;</para>
56 </listitem>
57 <listitem>
58 <para>Estimated build time: &sysstat-time;</para>
59 </listitem>
60 </itemizedlist>
61
62 <bridgehead renderas="sect3">Sysstat Dependencies</bridgehead>
63
64 <para>There are no build-time requirements for this package; however,
65 it is designed to be controlled by a cron daemon such as
66 <xref linkend="fcron"/>.</para>
67
68 <para condition="html" role="usernotes">User Notes:
69 <ulink url="&blfs-wiki;/sysstat"/></para>
70
71 </sect2>
72
73 <sect2 role="installation">
74 <title>Installation of Sysstat</title>
75
76 <para>Install <application>Sysstat</application> by running the
77 following commands:</para>
78
79<screen><userinput>sa_lib_dir=/usr/lib/sa \
80sa_dir=/var/log/sa \
81conf_dir=/etc/sysconfig \
82./configure --prefix=/usr \
83 --disable-file-attr &amp;&amp;
84make</userinput></screen>
85
86 <para>This package does not come with a test suite.</para>
87
88 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
89
90<screen role="root"><userinput>make install</userinput></screen>
91
92 <para revision="systemd">
93 Install the systemd unit by running the following command as the
94 <systemitem class="username">root</systemitem> user:
95 </para>
96
97<screen role="root" revision="systemd"><userinput>install -v -m644 sysstat.service /lib/systemd/system/sysstat.service</userinput></screen>
98
99 </sect2>
100
101 <sect2 role="commands">
102 <title>Command Explanations</title>
103
104 <para><envar>sa_lib_dir</envar>: This environment variable specifies the
105 location of the package-specific library directory.</para>
106
107 <para><envar>sa_dir</envar>: This environment variable specifies the
108 location of the directory containing the data files.</para>
109
110 <para><envar>conf_dir</envar>: This environment variable specifies the
111 location of the system configuration directory.</para>
112
113 <para><parameter>--disable-file-attr</parameter>: Do not set attributes on
114 files being installed. This parameter causes the installation to ignore the
115 man group variable resulting in the man files having
116 <systemitem class="username">root</systemitem>:
117 <systemitem class="groupname">root</systemitem> ownership.</para>
118
119 <note><para>Run <command>./configure --help</command> to see other influential
120 environment variables you can pass to <command>configure</command>. You may
121 want to use the <envar>history</envar> and <envar>compressafter</envar>
122 variables to customize the amount of data files kept on the system.</para></note>
123
124 </sect2>
125
126 <sect2 role="configuration">
127 <title>Configuring Sysstat</title>
128
129 <sect3 id="sysstat-config">
130 <title>Config Files</title>
131
132 <para>
133 <filename>/etc/sysconfig/sysstat</filename> and
134 <filename>/etc/sysconfig/sysstat.ioconf</filename>
135 </para>
136
137 <indexterm zone="sysstat sysstat-config">
138 <primary sortas="e-etc-sysconfig-sysstat">/etc/sysconfig/sysstat</primary>
139 </indexterm>
140 <indexterm zone="sysstat sysstat-config">
141 <primary sortas="e-etc-sysconfig-sysstat.ioconf">/etc/sysconfig/sysstat.ioconf</primary>
142 </indexterm>
143
144 </sect3>
145
146 <sect3>
147 <title>Cron Information</title>
148
149 <para>To begin gathering <application>Sysstat</application> history
150 information, you must add to, or create a privileged user's crontab. The
151 history data location is
152 <filename class="directory">/var/log/sa</filename>. The user running
153 <application>Sysstat</application> utilities via cron must have write
154 access to this location.</para>
155
156 <para>Below is an example of what to install in the crontab. Adjust the
157 parameters to suit your needs. Use <command>man sa1</command> and
158 <command>man sa2</command> for information about the commands.</para>
159
160<screen><literal># 8am-7pm activity reports every 10 minutes during weekdays
1610 8-18 * * 1-5 /usr/lib/sa/sa1 600 6 &amp;
162
163# 7pm-8am activity reports every hour during weekdays
1640 19-7 * * 1-5 /usr/lib/sa/sa1 &amp;
165
166# Activity reports every hour on Saturday and Sunday
1670 * * * 0,6 /usr/lib/sa/sa1 &amp;
168
169# Daily summary prepared at 19:05
1705 19 * * * /usr/lib/sa/sa2 -A &amp;</literal></screen>
171
172 <para>Ensure you submit the revised crontab to the cron daemon.</para>
173
174 </sect3>
175
176 <sect3 id="sysstat-init">
177 <title>System Startup Information</title>
178
179 <indexterm zone="sysstat sysstat-init">
180 <primary sortas="f-sysstat">sysstat</primary>
181 </indexterm>
182
183 <para revision="sysv">At system startup, a LINUX RESTART message must be
184 inserted in the daily data file to reinitialize the kernel counters. This
185 can be automated by installing the
186 <filename>/etc/rc.d/init.d/sysstat</filename> init script included in the
187 <xref linkend="bootscripts"/> package using the following command as the
188 <systemitem class="username">root</systemitem> user:</para>
189
190<screen role="root" revision="sysv"><userinput>make install-sysstat</userinput></screen>
191
192 <para revision="systemd">At system startup, a LINUX RESTART message must
193 be inserted in the daily data file to reinitialize the kernel counters.
194 This can be automated by enabling the previously installed systemd unit
195 by running the following command as the
196 <systemitem class="username">root</systemitem> user:</para>
197
198<screen role="root" revision="systemd"><userinput>systemctl enable sysstat</userinput></screen>
199
200 </sect3>
201
202 </sect2>
203
204 <sect2 role="content">
205 <title>Contents</title>
206
207 <segmentedlist>
208 <segtitle>Installed Programs</segtitle>
209 <segtitle>Installed Libraries</segtitle>
210 <segtitle>Installed Directories</segtitle>
211
212 <seglistitem>
213 <seg>cifsiostat, iostat, mpstat, pidstat, sadf, sar, and tapestat</seg>
214 <seg>None</seg>
215 <seg>/usr/lib/sa,
216 /usr/share/doc/sysstat-&sysstat-version; and
217 /var/log/sa
218 </seg>
219 </seglistitem>
220 </segmentedlist>
221
222 <variablelist>
223 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
224 <?dbfo list-presentation="list"?>
225 <?dbhtml list-presentation="table"?>
226
227 <varlistentry id="cifsiostat">
228 <term><command>cifsiostat</command></term>
229 <listitem>
230 <para>displays statistics about read and write operations on CIFS
231 filesystems.</para>
232 <indexterm zone="sysstat cifsiostat">
233 <primary sortas="b-cifsiostat">cifsiostat</primary>
234 </indexterm>
235 </listitem>
236 </varlistentry>
237
238 <varlistentry id="iostat">
239 <term><command>iostat</command></term>
240 <listitem>
241 <para>reports CPU statistics and input/output
242 statistics for devices and partitions.</para>
243 <indexterm zone="sysstat iostat">
244 <primary sortas="b-iostat">iostat</primary>
245 </indexterm>
246 </listitem>
247 </varlistentry>
248
249 <varlistentry id="mpstat">
250 <term><command>mpstat</command></term>
251 <listitem>
252 <para>writes activities for each available processor.</para>
253 <indexterm zone="sysstat mpstat">
254 <primary sortas="b-mpstat">mpstat</primary>
255 </indexterm>
256 </listitem>
257 </varlistentry>
258
259 <varlistentry id="pidstat">
260 <term><command>pidstat</command></term>
261 <listitem>
262 <para>is used for monitoring individual tasks currently being managed
263 by the Linux kernel.</para>
264 <indexterm zone="sysstat pidstat">
265 <primary sortas="b-pidstat">pidstat</primary>
266 </indexterm>
267 </listitem>
268 </varlistentry>
269
270 <varlistentry id="sadf">
271 <term><command>sadf</command></term>
272 <listitem>
273 <para>is used for displaying the contents of data files created by
274 the <command>sar</command> command. But unlike
275 <command>sar</command>, <command>sadf</command> can write its data
276 in many different formats.</para>
277 <indexterm zone="sysstat sadf">
278 <primary sortas="b-sadf">sadf</primary>
279 </indexterm>
280 </listitem>
281 </varlistentry>
282
283 <varlistentry id="sar">
284 <term><command>sar</command></term>
285 <listitem>
286 <para>is used for displaying the contents of elected cumulative activity
287 counters in the operating system.</para>
288 <indexterm zone="sysstat sar">
289 <primary sortas="b-sar">sar</primary>
290 </indexterm>
291 </listitem>
292 </varlistentry>
293
294 <varlistentry id="tapestat">
295 <term><command>tapestat</command></term>
296 <listitem>
297 <para>is used for monitoring the activity of tape drives connected to
298 a system.</para>
299 <indexterm zone="sysstat tapestat">
300 <primary sortas="b-tapestat">tapestat</primary>
301 </indexterm>
302 </listitem>
303 </varlistentry>
304
305 </variablelist>
306
307 </sect2>
308
309</sect1>
Note: See TracBrowser for help on using the repository browser.