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

NAME

6       pmdatrivial - trivial performance metrics domain agent (PMDA)
7

SYNOPSIS

9       $PCP_PMDAS_DIR/trivial/pmdatrivial  [-d  domain] [-l logfile] [-U user‐
10       name]
11

DESCRIPTION

13       pmdatrivial is the simplest possible Performance Metrics  Domain  Agent
14       (PMDA)  which  exports a single performance metric, the time in seconds
15       since the 1st of January, 1970.
16
17       The trivial PMDA is shipped as source code and is designed to be an aid
18       for PMDA developers.
19
20       A brief description of the pmdatrivial 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  triv‐
28            ial.log  is written in the current directory of pmcd(1) when pmda‐
29            trivial is started, i.e.  $PCP_LOG_DIR/pmcd.  If the log file can‐
30            not  be created or is not writable, output is written to the stan‐
31            dard error 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  trivial
39       performance metrics, do the following as root:
40
41            # cd $PCP_PMDAS_DIR/trivial
42            # ./Install
43
44       If you want to undo the installation, do the following as root:
45
46            # cd $PCP_PMDAS_DIR/trivial
47            # ./Remove
48
49       pmdatrivial  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 pmdatrivial
56       $PCP_PMDAS_DIR/trivial/help
57                 default help text file for the trivial metrics
58       $PCP_PMDAS_DIR/trivial/Install
59                 installation script for the pmdatrivial agent
60       $PCP_PMDAS_DIR/trivial/Remove
61                 undo installation script for the pmdatrivial agent
62       $PCP_LOG_DIR/pmcd/trivial.log
63                 default  log  file  for  error messages and other information
64                 from pmdatrivial
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), pmdasample(1),  pmdasimple(1),  pmdatxmon(1)  and
75       PMDA(3).
76
77
78
79Performance Co-Pilot                  PCP                       PMDATRIVIAL(1)
Impressum