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]
10

DESCRIPTION

12       pmdatrivial  is  the simplest possible Performance Metrics Domain Agent
13       (PMDA) which exports a single performance metric, the time  in  seconds
14       since the 1st of January, 1970.
15
16       The trivial PMDA is shipped as source code and is designed to be an aid
17       for PMDA developers.
18
19       A brief description of the pmdatrivial command line options follows:
20
21       -d   It is absolutely crucial that the performance metrics domain  num‐
22            ber  specified  here  is  unique  and consistent.  That is, domain
23            should be different for every PMDA on the one host, and  the  same
24            domain number should be used for the same PMDA on all hosts.
25
26       -l   Location  of  the  log  file.   By default, a log file named triv‐
27            ial.log is written in the current directory of pmcd(1) when  pmda‐
28            trivial is started, i.e.  $PCP_LOG_DIR/pmcd.  If the log file can‐
29            not be created or is not writable, output is written to the  stan‐
30            dard error instead.
31

INSTALLATION

33       If  you  want access to the names, help text and values for the trivial
34       performance metrics, do the following as root:
35
36            # cd $PCP_PMDAS_DIR/trivial
37            # ./Install
38
39       If you want to undo the installation, do the following as root:
40
41            # cd $PCP_PMDAS_DIR/trivial
42            # ./Remove
43
44       pmdatrivial is  launched  by  pmcd(1)  and  should  never  be  executed
45       directly.  The Install and Remove scripts notify pmcd(1) when the agent
46       is installed or removed.
47

FILES

49       $PCP_PMCDCONF_PATH
50                 command line options used to launch pmdatrivial
51       $PCP_PMDAS_DIR/trivial/help
52                 default help text file for the trivial metrics
53       $PCP_PMDAS_DIR/trivial/Install
54                 installation script for the pmdatrivial agent
55       $PCP_PMDAS_DIR/trivial/Remove
56                 undo installation script for the pmdatrivial agent
57       $PCP_LOG_DIR/pmcd/trivial.log
58                 default log file for error  messages  and  other  information
59                 from pmdatrivial
60

PCP ENVIRONMENT

62       Environment variables with the prefix PCP_ are used to parameterize the
63       file and directory names used by PCP.  On each installation,  the  file
64       /etc/pcp.conf  contains  the  local  values  for  these variables.  The
65       $PCP_CONF variable may be used to specify an alternative  configuration
66       file, as described in pcp.conf(4).
67

SEE ALSO

69       PCPIntro(1),  pmcd(1),  pmdasample(1),  pmdasimple(1), pmdatxmon(1) and
70       PMDA(3).
71
72
73
74Performance Co-Pilot                  SGI                       PMDATRIVIAL(1)
Impressum