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       Note  that  the  platform  kernel  PMDA exports a more extensive set of
21       filesystem metrics for every mounted filesystem - this PMDA is  primar‐
22       ily intended for availability monitoring using the mounts.up metric.
23
24       A brief description of the pmdamounts command line options follows:
25
26       -d   It  is absolutely crucial that the performance metrics domain num‐
27            ber specified here is unique  and  consistent.   That  is,  domain
28            should  be  different for every PMDA on the one host, and the same
29            domain number should be used for the same PMDA on all hosts.
30
31       -l   Location of the log file.  By default, a log file named mounts.log
32            is  written in the current directory of pmcd(1) when pmdamounts is
33            started, i.e.  $PCP_LOG_DIR/pmcd.  If the log file cannot be  cre‐
34            ated  or  is not writable, output is written to the standard error
35            instead.
36
37       -U   User account under which to run the agent.   The  default  is  the
38            unprivileged  "pcp"  account  in  current  versions of PCP, but in
39            older versions the superuser account ("root") was used by default.
40

INSTALLATION

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

FILES

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

PCP ENVIRONMENT

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

SEE ALSO

78       PCPIntro(1), pmcd(1), pcp.conf(5) and pcp.env(5).
79
80
81
82Performance Co-Pilot                  PCP                        PMDAMOUNTS(1)
Impressum