#
#  Copyright (c) 2001 Silicon Graphics, Inc.  All rights reserved.
# 
#  Copyright (c) 2001 Alan Bailey (bailey@mcs.anl.gov or abailey@ncsa.uiuc.edu) 
#  for the portions of the code supporting the initial agent functionality.
#  All rights reserved. 
# 
#  This program is free software; you can redistribute it and/or modify it
#  under the terms of version 2.1 of the GNU Lesser General Public License
#  as published by the Free Software Foundation.
# 
#  This program is distributed in the hope that it would be useful, but
#  WITHOUT ANY WARRANTY; without even the implied warranty of
#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
# 
#  Further, this software is distributed without any warranty that it is
#  free of the rightful claim of any third person regarding infringement
#  or the like.  Any license provided herein, whether implied or
#  otherwise, applies only to this software file.  Patent licenses, if
#  any, provided herein do not apply to combinations of this program with
#  other software, or any other product whatsoever.
# 
#  You should have received a copy of the GNU Lesser General Public
#  License along with this program; if not, write the Free Software
#  Foundation, Inc., 59 Temple Place - Suite 330, Boston MA 02111-1307,
#  USA.
# 
#  Contact information: Silicon Graphics, Inc., 1600 Amphitheatre Pkwy,
#  Mountain View, CA  94043, or:
# 
#  http://www.sgi.com
# 
#  For further information regarding this notice, see:
# 
#  http://oss.sgi.com/projects/GenInfo/SGIGPLNoticeExplan/
#
# $Id: README,v 1.3 2001/05/29 00:34:46 markgw Exp $

Mounts PMDA
============

This PMDA exports information about the mount status of file
systems specified in a config file. The default config file is
/var/pcp/pmdas/mounts/mounts.conf, which should contain one line
for each file system you wish to monitor.

This source code was contributed by Alan Bailey (abailey@ncsa.uiuc.edu)
to the PCP open source project.

Metrics
=======

The file ./help contains descriptions for all of the metrics exported
by this PMDA.

Once the PMDA has been installed, the following command will list all
the available metrics and their explanatory "help" text:

	$ pminfo -fT mounts

Installation
============

 +  # cd /var/pcp/pmdas/mounts

 +  Check that there is no clash in the Performance Metrics Domain
    defined in ./domain.h and the other PMDAs currently in use
    (/var/pcp/config/pmcd/pmcd.conf).  If there is, edit ./domain.h to choose another
    domain number.

 +  Then simply use

	# ./Install

    and choose both the "collector" and "monitor" installation
    configuration options -- everything else is automated.

 +  Alternatively, to install just the Performance Metrics Name Space
    for the mounts metrics on the local system, but not the mounts PMDA
    (presumably because the local system is running PCP 1.x and you
    wish to connect to a remote system where PCP 2.0 and the mounts PMDA
    is running), make sure the Performance Metrics Domain defined in
    ./domain.h matches the domain chosen for the mounts PMDA on the
    remote system (check the second field in the corresponding line of
    the /var/pcp/config/pmcd/pmcd.conf file on the remote system), then

	# ./Install -N

De-installation
===============

 +  Simply use

        # cd /var/pcp/pmdas/mounts
	# ./Remove

Troubleshooting
===============

 +  After installing or restarting the agent, the PMCD log file
    (/var/log/pcp/pmcd/pmcd.log) and the PMDA log file
    (/var/log/pcp/pmcd/mounts.log) should be checked for any warnings or
    errors.
