source: general/sysutils/sysstat.xml@ e0a7d67c

10.0 10.1 11.0 11.1 11.2 9.1 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since e0a7d67c was e0a7d67c, checked in by Bruce Dubbs <bdubbs@…>, 3 years ago

Update to libinput-1.15.0.
Update to sshfs-3.7.0.
Update to glib-networking-2.62.3.
Update to sysstat-12.3.1.
Update to dhcpcd-8.1.5.

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

  • Property mode set to 100644
File size: 11.0 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://sebastien.godard.pagesperso-orange.fr/sysstat-&sysstat-version;.tar.xz">
8 <!ENTITY sysstat-download-ftp " ">
9 <!ENTITY sysstat-md5sum "66cb8d297bd6c14f14650dcd5fd4ac10">
10 <!ENTITY sysstat-size "696 KB">
11 <!ENTITY sysstat-buildsize "20 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 &lfs90_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 <para revision="systemd">
100 Fix the systemd unit by running the following command as the
101 <systemitem class="username">root</systemitem> user:
102 </para>
103
104<screen role="root" revision="systemd"><userinput>sed -i "/^Also=/d" /lib/systemd/system/sysstat.service</userinput></screen>
105
106 </sect2>
107
108 <sect2 role="commands">
109 <title>Command Explanations</title>
110
111 <para><envar>sa_lib_dir</envar>: This environment variable specifies the
112 location of the package-specific library directory.</para>
113
114 <para><envar>sa_dir</envar>: This environment variable specifies the
115 location of the directory containing the data files.</para>
116
117 <para><envar>conf_dir</envar>: This environment variable specifies the
118 location of the system configuration directory.</para>
119
120 <para><parameter>--disable-file-attr</parameter>: Do not set attributes on
121 files being installed. This parameter causes the installation to ignore the
122 man group variable resulting in the man files having
123 <systemitem class="username">root</systemitem>:
124 <systemitem class="groupname">root</systemitem> ownership.</para>
125
126 <note><para>Run <command>./configure --help</command> to see other influential
127 environment variables you can pass to <command>configure</command>. You may
128 want to use the <envar>history</envar> and <envar>compressafter</envar>
129 variables to customize the amount of data files kept on the system.</para></note>
130
131 </sect2>
132
133 <sect2 role="configuration">
134 <title>Configuring Sysstat</title>
135
136 <sect3 id="sysstat-config">
137 <title>Config Files</title>
138
139 <para>
140 <filename>/etc/sysconfig/sysstat</filename> and
141 <filename>/etc/sysconfig/sysstat.ioconf</filename>
142 </para>
143
144 <indexterm zone="sysstat sysstat-config">
145 <primary sortas="e-etc-sysconfig-sysstat">/etc/sysconfig/sysstat</primary>
146 </indexterm>
147 <indexterm zone="sysstat sysstat-config">
148 <primary sortas="e-etc-sysconfig-sysstat.ioconf">/etc/sysconfig/sysstat.ioconf</primary>
149 </indexterm>
150
151 </sect3>
152
153 <sect3>
154 <title>Cron Information</title>
155
156 <para>To begin gathering <application>Sysstat</application> history
157 information, you must add to, or create a privileged user's crontab. The
158 history data location is
159 <filename class="directory">/var/log/sa</filename>. The user running
160 <application>Sysstat</application> utilities via cron must have write
161 access to this location.</para>
162
163 <para>Below is an example of what to install in the crontab. Adjust the
164 parameters to suit your needs. Use <command>man sa1</command> and
165 <command>man sa2</command> for information about the commands.</para>
166
167<screen><literal># 8am-7pm activity reports every 10 minutes during weekdays
1680 8-18 * * 1-5 /usr/lib/sa/sa1 600 6 &amp;
169
170# 7pm-8am activity reports every hour during weekdays
1710 19-7 * * 1-5 /usr/lib/sa/sa1 &amp;
172
173# Activity reports every hour on Saturday and Sunday
1740 * * * 0,6 /usr/lib/sa/sa1 &amp;
175
176# Daily summary prepared at 19:05
1775 19 * * * /usr/lib/sa/sa2 -A &amp;</literal></screen>
178
179 <para>Ensure you submit the revised crontab to the cron daemon.</para>
180
181 </sect3>
182
183 <sect3 id="sysstat-init">
184 <title>System Startup Information</title>
185
186 <indexterm zone="sysstat sysstat-init">
187 <primary sortas="f-sysstat">sysstat</primary>
188 </indexterm>
189
190 <para revision="sysv">At system startup, a LINUX RESTART message must be
191 inserted in the daily data file to reinitialize the kernel counters. This
192 can be automated by installing the
193 <filename>/etc/rc.d/init.d/sysstat</filename> init script included in the
194 <xref linkend="bootscripts"/> package using the following command as the
195 <systemitem class="username">root</systemitem> user:</para>
196
197<screen role="root" revision="sysv"><userinput>make install-sysstat</userinput></screen>
198
199 <para revision="systemd">At system startup, a LINUX RESTART message must
200 be inserted in the daily data file to reinitialize the kernel counters.
201 This can be automated by enabling the previously installed systemd unit
202 by running the following command as the
203 <systemitem class="username">root</systemitem> user:</para>
204
205<screen role="root" revision="systemd"><userinput>systemctl enable sysstat</userinput></screen>
206
207 </sect3>
208
209 </sect2>
210
211 <sect2 role="content">
212 <title>Contents</title>
213
214 <segmentedlist>
215 <segtitle>Installed Programs</segtitle>
216 <segtitle>Installed Libraries</segtitle>
217 <segtitle>Installed Directories</segtitle>
218
219 <seglistitem>
220 <seg>cifsiostat, iostat, mpstat, pidstat, sadf, sar, and tapestat</seg>
221 <seg>None</seg>
222 <seg>/usr/lib/sa,
223 /usr/share/doc/sysstat-&sysstat-version; and
224 /var/log/sa
225 </seg>
226 </seglistitem>
227 </segmentedlist>
228
229 <variablelist>
230 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
231 <?dbfo list-presentation="list"?>
232 <?dbhtml list-presentation="table"?>
233
234 <varlistentry id="cifsiostat">
235 <term><command>cifsiostat</command></term>
236 <listitem>
237 <para>displays statistics about read and write operations on CIFS
238 filesystems.</para>
239 <indexterm zone="sysstat cifsiostat">
240 <primary sortas="b-cifsiostat">cifsiostat</primary>
241 </indexterm>
242 </listitem>
243 </varlistentry>
244
245 <varlistentry id="iostat">
246 <term><command>iostat</command></term>
247 <listitem>
248 <para>reports CPU statistics and input/output
249 statistics for devices and partitions.</para>
250 <indexterm zone="sysstat iostat">
251 <primary sortas="b-iostat">iostat</primary>
252 </indexterm>
253 </listitem>
254 </varlistentry>
255
256 <varlistentry id="mpstat">
257 <term><command>mpstat</command></term>
258 <listitem>
259 <para>writes activities for each available processor.</para>
260 <indexterm zone="sysstat mpstat">
261 <primary sortas="b-mpstat">mpstat</primary>
262 </indexterm>
263 </listitem>
264 </varlistentry>
265
266 <varlistentry id="pidstat">
267 <term><command>pidstat</command></term>
268 <listitem>
269 <para>is used for monitoring individual tasks currently being managed
270 by the Linux kernel.</para>
271 <indexterm zone="sysstat pidstat">
272 <primary sortas="b-pidstat">pidstat</primary>
273 </indexterm>
274 </listitem>
275 </varlistentry>
276
277 <varlistentry id="sadf">
278 <term><command>sadf</command></term>
279 <listitem>
280 <para>is used for displaying the contents of data files created by
281 the <command>sar</command> command. But unlike
282 <command>sar</command>, <command>sadf</command> can write its data
283 in many different formats.</para>
284 <indexterm zone="sysstat sadf">
285 <primary sortas="b-sadf">sadf</primary>
286 </indexterm>
287 </listitem>
288 </varlistentry>
289
290 <varlistentry id="sar">
291 <term><command>sar</command></term>
292 <listitem>
293 <para>is used for displaying the contents of elected cumulative activity
294 counters in the operating system.</para>
295 <indexterm zone="sysstat sar">
296 <primary sortas="b-sar">sar</primary>
297 </indexterm>
298 </listitem>
299 </varlistentry>
300
301 <varlistentry id="tapestat">
302 <term><command>tapestat</command></term>
303 <listitem>
304 <para>is used for monitoring the activity of tape drives connected to
305 a system.</para>
306 <indexterm zone="sysstat tapestat">
307 <primary sortas="b-tapestat">tapestat</primary>
308 </indexterm>
309 </listitem>
310 </varlistentry>
311
312 </variablelist>
313
314 </sect2>
315
316</sect1>
Note: See TracBrowser for help on using the repository browser.