Atsar can be used to measure the load on the most relevant system-resources,
such as CPU, disk, memory and network.
Long-term analysis can be done via cron, by maintaining log-files with
statistical information.
Short-term analysis can be done by starting the command atsar with an
interval and a number of samples.

              +++++++++++++++++++++++++++++++++++++++++++++++++

Version 1.4
	Initial LINUX-port
	Tested for Intel-based systems only.


Version 1.5
	Delivered as RPM.

	Bug fixes.

	Code cleanup.

	Performance optimizations.

	Consistent usage of /proc instead of kernel-structures from /dev/kmem.
	   - less critical in case of different kernel-versions
	   - no root-permission (setuid on atsadc) any more to access /dev/kmem

	Additional counters printed for TCP and network-interfaces.

	New counters gathered/printed for NFS/RPC and sockets.

	Ported & tested on Alpha-based systems.

	Improved man-pages (description of all output-columns).

	Features to register number of FTP- and HTTP-transfers (optional).


Version 1.6
	Kernel 2.4 counters supported.

	Some minor bug fixes.

	Easier post-processing of atsar-output by other tools (awk/perl/...)
	for further processing or for graphical representation
	   - disable buffering on stdout
	   - new flag -S to produce a time-stamp before every output-line

	Modified parsing for output of /proc/partitions as introduced
	with kernel 2.4 and with sard-0.5 (patches of Stephen Tweedie -
	see remark at end of this file).

	Increased number of FTP- and HTTP-transfers and introduction
	of configuration-file /etc/atsar.conf for xfer- and access-logfiles.

	Load-averages and current runq-size added to CPU-statistics:
          %usr %sys %nice %idle pswch/s runq nrproc lavg1 lavg5 avg15     _cpu_

	IPv6 statistics added:
          inrecv/s outreq/s inmc/s outmc/s indeliv/s reasmok/s fragcre/s  _ip6_
          in: dsc/s hder/s ader/s unkp/s ratim/s rfail/s ot: dsc/s nort/s _ip6_
                                                        socknow sockmax  _tcp6_
          indgram/s otdgram/s   inerr/s  noport/s       socknow sockmax  _udp6_
          intot/s outtot/s inerr/s innsol/s innadv/s otnsol/s otnadv/s  _icmp6_
          iecho/s ierep/s oerep/s idu/s odu/s ird/s ord/s ite/s ote/s   _icmp6_

	Enhanced NFS server statistics added:
          rchit/s rcmiss/s %hit fhstal/s iord/s iowr/s racach thr tlast/s

	TTY (serial line) statistics added:
          port   xmit/s   recv/s   frer/s  parer/s  ovrun/s    brk/s

        Note that some existing counters in version 1.5 are represented
        in a different way in version 1.6, so this may require modifications
	in programs which do post-processing on the output of atsar.
	Apart from the additional colums in the output of the CPU-stats
	(load-averages, etc as mentioned above), the representation of the
	disk-stats has changed:

          1.5: device   rdwr/s  read/s rsect/s  write/s wsect/s           
          1.6: device           read/s rdKb/s   write/s wrKb/s      rdwr/s

	The order of the columns has changed and the transfer-rate is in
	Kbytes i.s.o. sectors.
	Furthermore the device-name has changed from e.g. "disk00" to
	"disk000-001" (kernel 2.4: major-minor number).

	Also the representation of the partition-stats is changed: 

          1.5: partition  busy  read/s  rdK/s   write/s  wrK/s  avque  avserv
          1.6: partition  busy  read/s Kbyt/r   write/s Kbyt/w  avque  avserv

	The average number of Kbytes (for read and write) is not per second
	any more, because that would give the same info again as the
	disk-stats. In version 1.6 the average number of Kbytes per read
	or write is shown.
	Furthermore the major-minor number of a partition is added to
	correlate the partition-stats with the disk-stats (kernel 2.4).


Version 1.7
	Kernel 2.6 counters supported.

	Minor bug fixes.

              +++++++++++++++++++++++++++++++++++++++++++++++++


Quick manual installation (only if the RPM is not used):
--------------------------------------------------------
     -	Run the following commands:
		make
		make install

     -	Optional: FTP- and/or HTTP-accounting

		edit the file /etc/atsar.conf

	If this type of accounting is not required, empty this 
	configuration-file.

     	The figures shown by atsar for FTP- and HTTP-accounting
	(flags -F and -H) are only relevant when obtained from
	the history-files; not for "real-time" figures (atsar started with
	interval).


              +++++++++++++++++++++++++++++++++++++++++++++++++

Original versions of atsar can be retrieved from 

	ftp://ftp.ATComputing.nl/pub/tools/linux



Gerlof Langeveld (gerlof@ATComputing.nl)
AT Computing
Nijmegen
The Netherlands
