summaryrefslogtreecommitdiff
path: root/src/pmdas/mounts/README
blob: 2bf3c6a89f9b337899cb666f6daa738c1790f127 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
#
#  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. 
#  Copyright (c) 2001,2004 Silicon Graphics, Inc.  All Rights Reserved.
#

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

This PMDA exports information about the mount status of file
systems specified in a config file. The default config file is
$PCP_PMDAS_DIR/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 $PCP_PMDAS_DIR/mounts

 +  Check that there is no clash in the Performance Metrics Domain
    defined in ./domain.h and the other PMDAs currently in use
    ($PCP_PMCDCONF_PATH).  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 $PCP_PMCDCONF_PATH file on the remote system), then

	# ./Install -N

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

 +  Simply use

        # cd $PCP_PMDAS_DIR/mounts
	# ./Remove

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

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