summaryrefslogtreecommitdiff
path: root/src/pmdas/mounts/README
diff options
context:
space:
mode:
Diffstat (limited to 'src/pmdas/mounts/README')
-rw-r--r--src/pmdas/mounts/README72
1 files changed, 72 insertions, 0 deletions
diff --git a/src/pmdas/mounts/README b/src/pmdas/mounts/README
new file mode 100644
index 0000000..2bf3c6a
--- /dev/null
+++ b/src/pmdas/mounts/README
@@ -0,0 +1,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.