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

NAME

6       pmdaroomtemp - room temperature performance metrics domain agent (PMDA)
7

SYNOPSIS

9       $PCP_PMDAS_DIR/roomtemp/pmdaroomtemp [-d domain] [-l logfile]
10

DESCRIPTION

12       pmdaroomtemp is a Performance Metrics Domain Agent (PMDA) which exports
13       the temperature from one or more sensors built  using  the  DS2480  and
14       DS1280  chipsets and MicroLAN technology from Dallas Semiconductor Cor‐
15       poration.
16
17       The roomtemp PMDA exports metrics that reflect  the  temperatures  from
18       one  or  more of these devices, in both degrees Celcius and Fahrenheit.
19       Each metric has one instance for each temperature sensor  device.   The
20       external  instance  identifiers  are the serial numbers (in hex) of the
21       DS1280 chips discovered when the MicroLAN was probed.
22
23       A brief description of the pmdaroomtemp command line options follows:
24
25       -d   It is absolutely crucial that the performance metrics domain  num‐
26            ber  specified  here  is  unique  and consistent.  That is, domain
27            should be different for every PMDA on the one host, and  the  same
28            domain number should be used for the same PMDA on all hosts.
29
30       -l   Location   of  the  log  file.   By  default,  a  log  file  named
31            roomtemp.log is written in the current directory of  pmcd(1)  when
32            pmdaroomtemp is started, i.e.  $PCP_LOG_DIR/pmcd.  If the log file
33            cannot be created or is not writable, output  is  written  to  the
34            standard error instead.
35

INSTALLATION

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

FILES

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

PCP ENVIRONMENT

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

SEE ALSO

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