AFS::Monitor - Perl interface to AFS monitoring and debugging tools
Gathers statistics about specified File Server and Cache Manager operations. There are 271 available File Server statistics and 571 available Cache Manager statistics, listed in afsmon_stats(1). See afsmonitor(1)
Reports status of cache manager and cache entries on a particular AFS client machine. See cmdebug(1)
Provides debugging trace of Rx activity for a specified server or client machine. See rxdebug(1)
Gathers statistics from the File Server processes running on the specified machines. See scout(1)
Reports the status of the Ubik process associated with a database server process. See udebug(1)
Gathers the specified data collections associated with the specified Cache Manager. See xstat_cm_test(1)
Gathers the specified data collections associated with the specified File Server process. See xstat_fs_test(1)
The configurations that this package has been tested on are listed below:
OS @sys Perl OpenAFS ----------------------------------------------------------------------------- FC5 amd64_linux26 v5.8.8 1.4.2-beta1 RHEL4-64 amd64_linux26 v5.8.5 1.4.1 RHEL4-32 no machine RHEL3-32 i386linux24 v5.8.0, v5.8.8, v5.6.0 1.4.1, 1.2.10 RHEL3-64 no machine SLES9 ia64_linux26 v5.8.3 1.4.1 Solaris 5.8 sun4x_58 v5.8.8, v5.6.0, 5.005_03 1.4.1, 1.2.10 Solaris 5.9 sun4x_59 v5.8.8, v5.6.0 1.4.1, 1.2.10 Solaris 5.10 sun4x_510 v5.8.8, v5.6.0 1.4.1, 1.2.10 Mac OS X 10.3 ppc_darwin_70 v5.8.1-RC3 1.4.1 Mac OS x 10.4 ppc_darwin_80 v5.8.6 1.4.1
Perl 5.6.0 or newer. No problems were found with threaded Perl. AFS system libraries and header files from OpenAFS 1.2.x or newer. It is not know whether version 0.3.0 of this module works with IBM/Transarc AFS because I don't have this version available any more.
This package does not depend on any other Perl modules.
This package depends on the corresponding OpenAFS libraries. These underlying libraries still don't work properly on or with 64bit Linux systems. The problem manifests itself in statistic values beeing zero instead of the real value. This problem will go away once the OpenAFS libraries are fixed.
The code and documentation for this class were contributed by Stanford Linear Accelerator Center, a department of Stanford University. This documentation was written by
Copyright 2004-2006 Alf Wachsmann <alfw@slac.stanford.edu> and Elizabeth Cassell <e_a_c@mailsnare.net> All rights reserved. Most of the explanations in this document are taken from the original AFS documentation. AFS-3 Programmer's Reference: Volume Server/Volume Location Server Interface Edward R. Zayas (c) 1991 Transarc Corporation. All rights reserved. IBM AFS Administration Reference (c) IBM Corporation 2000. All rights reserved. This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install AFS::Monitor, copy and paste the appropriate command in to your terminal.
cpanm
cpanm AFS::Monitor
CPAN shell
perl -MCPAN -e shell install AFS::Monitor
For more information on module installation, please visit the detailed CPAN module installation guide.