sysstat: System performance tools for the Linux operating system...
--
(C) 1999-2002 Sebastien Godard <sebastien.godard@wanadoo.fr>

The latest version of sysstat can always be found at ibiblio's Linux archive
in the following directory:

ftp://ibiblio.org/pub/Linux/system/status/

sysstat home page is now at:

http://perso.wanadoo.fr/sebastien.godard/

See the CHANGES file to know the new features/improvements/bug fixes added
in this release of sysstat.


INSTALLATION
------------

The sysstat utilities are a collection of performance monitoring tools for
Linux. These include mpstat, iostat, sar, isag and sa tools. 

The first stage is to configure sysstat for your system:

	make config

This is useful to change some configuration variables, for instance if you
want to choose installation directories.
Answer the questions or enter Return to accept the default values.
For yes/no questions, please answer 'y' or 'n' (without the quotes): It is
case sensitive! You can also enter '?' to get a help message.
Configuring your system is not compulsory. If not done, sysstat will use
a default configuration file...

The next stage is to build the various binary files. Enter:

	make

Then log in as root and enter:

	make install

(see next section to know the installed files).
That's all!

Of course tell me if there are any problems. This is the only way I can improve
'sysstat'. But if you wanna raise my morale, you can also send me reports of
successful use instead of bug reports ;-)

NB: The iostat command has been updated to take advantage of Stephen Tweedie's
kernel patch to display extended I/O statistics (option '-x' for iostat).
You can find Stephen's patch here:
ftp://ftp.uk.linux.org/pub/linux/sct/fs/profiling
Stephen used to maintain his patch for various kernel versions, but it is
no longer the case. You will have to get one of the relevant patch and
update it by hand to suit your kernel.
Note that some distros have this patch already applied. Just try 'iostat -x'
to see if it is there...

With regard to sysstat, patches and suggestions for improvements are always
welcome! Send them to <sebastien.godard@wanadoo.fr>.
Bugs and questions concerning the "isag" command should be sent to David
Doubrava <linux_monitor@volny.cz>.


FILES THAT ARE INSTALLED
------------------------

I _hate_ when packages install files eveywhere on my disk and I don't know
where...
So here is the list of files installed by sysstat, when you ask for a
complete installation.
${PREFIX} is the value of the PREFIX variable defined in the Makefile
(usually set to /usr/local or /usr).

${PREFIX}/lib/sa/sadc
${PREFIX}/lib/sa/sa1
${PREFIX}/lib/sa/sa2
${PREFIX}/bin/sar
${PREFIX}/bin/iostat
${PREFIX}/bin/mpstat
${PREFIX}/bin/isag
${PREFIX}(/share)/man/man8/sadc.8
${PREFIX}(/share)/man/man8/sa1.8
${PREFIX}(/share)/man/man8/sa2.8
${PREFIX}(/share)/man/man1/sar.1
${PREFIX}(/share)/man/man1/iostat.1
${PREFIX}(/share)/man/man1/mpstat.1
${PREFIX}(/share)/man/man1/isag.1
${PREFIX}/share/locale/fr/LC_MESSAGES/sysstat.mo
${PREFIX}/share/locale/de/LC_MESSAGES/sysstat.mo
${PREFIX}/share/locale/es/LC_MESSAGES/sysstat.mo
${PREFIX}/share/locale/pt/LC_MESSAGES/sysstat.mo
${PREFIX}/share/locale/af/LC_MESSAGES/sysstat.mo
${PREFIX}/share/locale/nb_NO/LC_MESSAGES/sysstat.mo
${PREFIX}/share/locale/nn_NO/LC_MESSAGES/sysstat.mo
${PREFIX}/share/locale/it/LC_MESSAGES/sysstat.mo
${PREFIX}/share/locale/ru/LC_MESSAGES/sysstat.mo
${PREFIX}/doc/sysstat-x.y/*
/var/log/sa
${INIT_DIR}/sysstat
${RC_DIR}/rc2.d/S03sysstat
${RC_DIR}/rc3.d/S03sysstat
${RC_DIR}/rc5.d/S03sysstat

with:

${INIT_DIR}=/etc/rc.d/init.d/	for [REDHAT] [CALDERA] [MANDRAKE] [TURBOLINUX] [KONDARA]
${INIT_DIR}=/sbin/init.d/	for [SUSE <= 7.0]
${INIT_DIR}=/etc/init.d/	for [SUSE >= 7.1] [DEBIAN]
${RC_DIR}=/etc/rc.d/		for [REDHAT] [CALDERA] [MANDRAKE] [TURBOLINUX] [KONDARA]
${RC_DIR}=/sbin/init.d/		for [SUSE <= 7.0]
${RC_DIR}=/etc/init.d/		for [SUSE >= 7.1]
${RC_DIR}=/etc/			for [DEBIAN]


MISCELLANEOUS
-------------

The sar, mpstat and iostat commands are only front-ends to the kernel proc
filesystem... They cannot display statistics that Linux does not
provide, nor can they be more accurate than Linux is.
The sysstat package has been tested on Linux kernels 2.0.x, 2.2.x and 2.4.x,
but since new statistics are added in sysstat, they are not necessarily
present in old kernels.

It has been designed with National Language Support (NLS) in mind, using
the GNU gettext package (available at http://www.gnu.org).
At the present time, English, French, German, Spanish, Portuguese,
Afrikaans, Norwegian, Italian and Russian translations are available.
You are welcome if you want to make other languages available ;-)
Please read the README-nls file in the nls directory before.

--
Sebastien Godard <sebastien.godard@wanadoo.fr>

