1PMDAMOUNTS(1)               General Commands Manual              PMDAMOUNTS(1)
2
3
4

NAME

6       pmdamounts - filesystem mounts performance metrics domain agent (PMDA)
7

SYNOPSIS

9       $PCP_PMDAS_DIR/mounts/pmdamounts [-d domain] [-l logfile] [-U username]
10

DESCRIPTION

12       pmdamounts  is  a  simple Performance Metrics Domain Agent (PMDA) which
13       monitors availability of a given set of filesystem mounts.
14
15       The mounts PMDA exports metrics that  reflect  whether  the  configured
16       filesystems  are  mounted  ("up")  or not.  The list of mount points to
17       monitor is specified  via  the  $PCP_PMDAS_DIR/mounts/mounts.conf  file
18       which simply contains one line for each mount point.
19
20       A brief description of the pmdamounts command line options follows:
21
22       -d   It  is absolutely crucial that the performance metrics domain num‐
23            ber specified here is unique  and  consistent.   That  is,  domain
24            should  be  different for every PMDA on the one host, and the same
25            domain number should be used for the same PMDA on all hosts.
26
27       -l   Location of the log file.  By default, a log file named mounts.log
28            is  written in the current directory of pmcd(1) when pmdamounts is
29            started, i.e.  $PCP_LOG_DIR/pmcd.  If the log file cannot be  cre‐
30            ated  or  is not writable, output is written to the standard error
31            instead.
32
33       -U   User account under which to run the agent.  The default is the un‐
34            privileged  "pcp" account in current versions of PCP, but in older
35            versions the superuser account ("root") was used by default.
36

INSTALLATION

38       If you want access to the names, help text and values  for  the  mounts
39       performance metrics, do the following as root:
40
41            # cd $PCP_PMDAS_DIR/mounts
42            # ./Install
43
44       If you want to undo the installation, do the following as root:
45
46            # cd $PCP_PMDAS_DIR/mounts
47            # ./Remove
48
49       pmdamounts  is  launched  by  pmcd(1)  and should never be executed di‐
50       rectly.  The Install and Remove scripts notify pmcd(1) when  the  agent
51       is installed or removed.
52

FILES

54       $PCP_PMCDCONF_PATH
55                 command line options used to launch pmdamounts
56       $PCP_PMDAS_DIR/mounts/help
57                 default help text file for the mounts metrics
58       $PCP_PMDAS_DIR/mounts/Install
59                 installation script for the pmdamounts agent
60       $PCP_PMDAS_DIR/mounts/Remove
61                 undo installation script for the pmdamounts agent
62       $PCP_LOG_DIR/pmcd/mounts.log
63                 default  log  file  for  error messages and other information
64                 from pmdamounts
65

PCP ENVIRONMENT

67       Environment variables with the prefix PCP_ are used to parameterize the
68       file  and  directory names used by PCP.  On each installation, the file
69       /etc/pcp.conf contains the  local  values  for  these  variables.   The
70       $PCP_CONF  variable may be used to specify an alternative configuration
71       file, as described in pcp.conf(5).
72

SEE ALSO

74       PCPIntro(1), pmcd(1), pcp.conf(5) and pcp.env(5).
75
76
77
78Performance Co-Pilot                  PCP                        PMDAMOUNTS(1)
Impressum