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

NAME

6       pmdarpm - RPM packages performance metrics domain agent (PMDA)
7

SYNOPSIS

9       $PCP_PMDAS_DIR/rpm/pmdarpm  [-C] [-d domain] [-l logfile] [-r path] [-U
10       username]
11

DESCRIPTION

13       pmdarpm is a Performance Metrics Domain  Agent  (PMDA)  which  extracts
14       performance  metrics  reflecting  the state of the RPM package database
15       managed by rpm(1).
16
17       The rpm PMDA exports metrics that describe each package installed on  a
18       system,  as  well  as  some  cumulative  totals.  When the RPM database
19       changes the PMDA automatically  detects  this  and  uses  a  background
20       thread to asynchronously refresh its values.
21
22       A brief description of the pmdarpm command line options follows:
23
24       -C   Verify  the  package  iteration  code by scanning the RPM database
25            once, then exiting.  Only useful for problem diagnosis  and  test‐
26            ing.
27
28       -d   It  is absolutely crucial that the performance metrics domain num‐
29            ber specified here is unique  and  consistent.   That  is,  domain
30            should  be  different for every PMDA on the one host, and the same
31            domain number should be used for the same PMDA on all hosts.
32
33       -l   Location of the log file.  By default, a log file named rpm.log is
34            written  in  the  current  directory  of  pmcd(1)  when pmdarpm is
35            started, i.e.  $PCP_LOG_DIR/pmcd.  If the log file cannot be  cre‐
36            ated  or  is not writable, output is written to the standard error
37            instead.
38
39       -r   Specify  an  alternate  path  to  the  RPM  database  (default  is
40            /var/lib/rpm/Packages).
41
42       -U   User  account  under  which  to run the agent.  The default is the
43            unprivileged "pcp" account.
44

INSTALLATION

46       If you want access to the names, help text and values for the rpm  per‐
47       formance metrics, do the following as root:
48
49            # cd $PCP_PMDAS_DIR/rpm
50            # ./Install
51
52       If you want to undo the installation, do the following as root:
53
54            # cd $PCP_PMDAS_DIR/rpm
55            # ./Remove
56
57       pmdarpm  is  launched by pmcd(1) and should never be executed directly.
58       The Install and  Remove  scripts  notify  pmcd(1)  when  the  agent  is
59       installed or removed.
60

FILES

62       $PCP_PMCDCONF_PATH
63                 command line options used to launch pmdarpm
64       $PCP_PMDAS_DIR/rpm/help
65                 default help text file for the rpm metrics
66       $PCP_PMDAS_DIR/rpm/Install
67                 installation script for the pmdarpm agent
68       $PCP_PMDAS_DIR/rpm/Remove
69                 undo installation script for the pmdarpm agent
70       $PCP_LOG_DIR/pmcd/rpm.log
71                 default  log  file  for  error messages and other information
72                 from pmdarpm
73

PCP ENVIRONMENT

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

SEE ALSO

82       PCPIntro(1), pmcd(1), pcp.conf(5) and pcp.env(5).
83
84
85
86Performance Co-Pilot                  PCP                           PMDARPM(1)
Impressum