Ignore:
Timestamp:
03/19/2020 10:00:16 AM (4 years ago)
Author:
Pierre Labastie <pieere@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
e68b588
Parents:
09f0998
Message:

Format sysutils

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • general/sysutils/sysstat.xml

    r09f0998 rb1532549  
    3030    <title>Introduction to Sysstat</title>
    3131
    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>
     32    <para>
     33      The <application>Sysstat</application> package contains utilities
     34      to monitor system performance and usage activity.
     35      <application>Sysstat</application> contains the <command>sar</command>
     36      utility, common to many commercial Unixes, and tools you can schedule via
     37      cron to collect and historize performance and activity data.
     38    </para>
    3739
    3840    &lfs91_checked;
    … …  
    4143    <itemizedlist spacing="compact">
    4244      <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>
     45        <para>
     46          Download (HTTP): <ulink url="&sysstat-download-http;"/>
     47        </para>
     48      </listitem>
     49      <listitem>
     50        <para>
     51          Download (FTP): <ulink url="&sysstat-download-ftp;"/>
     52        </para>
     53      </listitem>
     54      <listitem>
     55        <para>
     56          Download MD5 sum: &sysstat-md5sum;
     57        </para>
     58      </listitem>
     59      <listitem>
     60        <para>
     61          Download size: &sysstat-size;
     62        </para>
     63      </listitem>
     64      <listitem>
     65        <para>
     66          Estimated disk space required: &sysstat-buildsize;
     67        </para>
     68      </listitem>
     69      <listitem>
     70        <para>
     71          Estimated build time: &sysstat-time;
     72        </para>
    5973      </listitem>
    6074    </itemizedlist>
    … …  
    6276    <bridgehead renderas="sect3">Sysstat Dependencies</bridgehead>
    6377
    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>
     78    <para role="recommended">
     79      There are no build-time requirements for this package; however,
     80      it is designed to be controlled by a cron daemon such as
     81      <xref linkend="fcron" role="runtime"/>.
     82    </para>
    6783
    6884    <para condition="html" role="usernotes">User Notes:
    … …  
    7490    <title>Installation of Sysstat</title>
    7591
    76     <para>Install <application>Sysstat</application> by running the
    77     following commands:</para>
     92    <para>
     93      Install <application>Sysstat</application> by running the
     94      following commands:
     95    </para>
    7896
    7997<screen><userinput>sa_lib_dir=/usr/lib/sa    \
    … …  
    84102make</userinput></screen>
    85103
    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>
     104    <para>
     105      This package does not come with a test suite.
     106    </para>
     107
     108    <para>
     109      Now, as the <systemitem class="username">root</systemitem> user:
     110    </para>
    89111
    90112<screen role="root"><userinput>make install</userinput></screen>
    … …  
    109131    <title>Command Explanations</title>
    110132
    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>
     133    <para>
     134      <envar>sa_lib_dir</envar>: This environment variable specifies the
     135      location of the package-specific library directory.
     136    </para>
     137
     138    <para>
     139      <envar>sa_dir</envar>: This environment variable specifies the
     140      location of the directory containing the data files.
     141    </para>
     142
     143    <para>
     144      <envar>conf_dir</envar>: This environment variable specifies the
     145      location of the system configuration directory.
     146    </para>
     147
     148    <para>
     149      <parameter>--disable-file-attr</parameter>: Do not set attributes on
     150      files being installed. This parameter causes the installation to ignore
     151      the man group variable resulting in the man files having
     152      <systemitem class="username">root</systemitem>:
     153      <systemitem class="groupname">root</systemitem> ownership.
     154    </para>
     155
     156    <note>
     157      <para>
     158        Run <command>./configure --help</command> to see other influential
     159        environment variables you can pass to <command>configure</command>.
     160        You may want to use the <envar>history</envar> and
     161        <envar>compressafter</envar> variables to customize the amount of data
     162        files kept on the system.
     163      </para>
     164    </note>
    130165
    131166  </sect2>
    … …  
    154189     <title>Cron Information</title>
    155190
    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>
     191      <para>
     192        To begin gathering <application>Sysstat</application> history
     193        information, you must add to, or create a privileged user's crontab.
     194        The history data location is
     195        <filename class="directory">/var/log/sa</filename>. The user running
     196        <application>Sysstat</application> utilities via cron must have write
     197        access to this location.
     198      </para>
     199
     200      <para>
     201        Below is an example of what to install in the crontab. Adjust the
     202        parameters to suit your needs. Use <command>man sa1</command> and
     203        <command>man sa2</command> for information about the commands.
     204      </para>
    166205
    167206<screen><literal># 8am-7pm activity reports every 10 minutes during weekdays
    … …  
    1772165 19 * * * /usr/lib/sa/sa2 -A &amp;</literal></screen>
    178217
    179     <para>Ensure you submit the revised crontab to the cron daemon.</para>
     218      <para>
     219        Ensure you submit the revised crontab to the cron daemon.
     220      </para>
    180221
    181222    </sect3>
    … …  
    188229      </indexterm>
    189230
    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>
     231      <para revision="sysv">
     232        At system startup, a LINUX RESTART message must be
     233        inserted in the daily data file to reinitialize the kernel counters.
     234        This can be automated by installing the
     235        <filename>/etc/rc.d/init.d/sysstat</filename> init script included in
     236        the <xref linkend="bootscripts"/> package using the following command
     237        as the <systemitem class="username">root</systemitem> user:
     238      </para>
    196239
    197240<screen role="root" revision="sysv"><userinput>make install-sysstat</userinput></screen>
    198241
    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>
     242      <para revision="systemd">
     243        At system startup, a LINUX RESTART message must
     244        be inserted in the daily data file to reinitialize the kernel counters.
     245        This can be automated by enabling the previously installed systemd unit
     246        by running the following command as the
     247        <systemitem class="username">root</systemitem> user:
     248      </para>
    204249
    205250<screen role="root" revision="systemd"><userinput>systemctl enable sysstat</userinput></screen>
    … …  
    235280        <term><command>cifsiostat</command></term>
    236281        <listitem>
    237           <para>displays statistics about read and write operations on CIFS
    238           filesystems.</para>
     282          <para>
     283            displays statistics about read and write operations on CIFS
     284            filesystems.
     285          </para>
    239286          <indexterm zone="sysstat cifsiostat">
    240287            <primary sortas="b-cifsiostat">cifsiostat</primary>
    … …  
    246293        <term><command>iostat</command></term>
    247294        <listitem>
    248           <para>reports CPU statistics and input/output
    249           statistics for devices and partitions.</para>
     295          <para>
     296            reports CPU statistics and input/output
     297            statistics for devices and partitions.
     298          </para>
    250299          <indexterm zone="sysstat iostat">
    251300            <primary sortas="b-iostat">iostat</primary>
    … …  
    257306        <term><command>mpstat</command></term>
    258307        <listitem>
    259           <para>writes activities for each available processor.</para>
     308          <para>
     309            writes activities for each available processor.
     310          </para>
    260311          <indexterm zone="sysstat mpstat">
    261312            <primary sortas="b-mpstat">mpstat</primary>
    … …  
    267318        <term><command>pidstat</command></term>
    268319        <listitem>
    269           <para>is used for monitoring individual tasks currently being managed
    270           by the Linux kernel.</para>
     320          <para>
     321            is used for monitoring individual tasks currently being managed
     322            by the Linux kernel.
     323          </para>
    271324          <indexterm zone="sysstat pidstat">
    272325            <primary sortas="b-pidstat">pidstat</primary>
    … …  
    278331        <term><command>sadf</command></term>
    279332        <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>
     333          <para>
     334            is used for displaying the contents of data files created by
     335            the <command>sar</command> command. But unlike
     336            <command>sar</command>, <command>sadf</command> can write its data
     337            in many different formats.
     338          </para>
    284339          <indexterm zone="sysstat sadf">
    285340            <primary sortas="b-sadf">sadf</primary>
    … …  
    291346        <term><command>sar</command></term>
    292347        <listitem>
    293           <para>is used for displaying the contents of elected cumulative activity
    294           counters in the operating system.</para>
     348          <para>
     349            is used for displaying the contents of elected cumulative activity
     350            counters in the operating system.
     351          </para>
    295352          <indexterm zone="sysstat sar">
    296353            <primary sortas="b-sar">sar</primary>
    … …  
    302359        <term><command>tapestat</command></term>
    303360        <listitem>
    304           <para>is used for monitoring the activity of tape drives connected to
    305           a system.</para>
     361          <para>
     362            is used for monitoring the activity of tape drives connected to
     363            a system.
     364          </para>
    306365          <indexterm zone="sysstat tapestat">
    307366            <primary sortas="b-tapestat">tapestat</primary>
Note: See TracChangeset for help on using the changeset viewer.