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

NAME

6       pmdalmsensors  -  Linux  hardware monitoring performance metrics domain
7       agent (PMDA)
8

SYNOPSIS

10       $PCP_PMDAS_DIR/lmsensors/pmdalmsensors [-d  domain]  [-l  logfile]  [-U
11       username]
12

DESCRIPTION

14       pmdalmsensors  is  a  Performance  Metrics  Domain  Agent  (PMDA) which
15       extracts performance metrics describing the state of hardware using the
16       lm-sensors on compatible motherboards.
17
18       The  lmsensors  PMDA exports metrics that measure fan speeds, core tem‐
19       peratures and voltage levels.
20
21       A brief description of the pmdalmsensors command line options follows:
22
23       -d   It is absolutely crucial that the performance metrics domain  num‐
24            ber  specified  here  is  unique  and consistent.  That is, domain
25            should be different for every PMDA on the one host, and  the  same
26            domain number should be used for the same PMDA on all hosts.
27
28       -l   Location  of  the  log  file.  By default, a log file named lmsen‐
29            sors.log is written in  the  current  directory  of  pmcd(1)  when
30            pmdalmsensors  is  started,  i.e.  $PCP_LOG_DIR/pmcd .  If the log
31            file cannot be created or is not writable, output  is  written  to
32            the standard error instead.
33
34       -U   User  account  under  which  to run the agent.  The default is the
35            unprivileged "pcp" account in current  versions  of  PCP,  but  in
36            older versions the superuser account ("root") was used by default.
37

INSTALLATION

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

FILES

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

PCP ENVIRONMENT

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

SEE ALSO

75       PCPIntro(1), pmcd(1), pcp.conf(5) and pcp.env(5).
76
77
78
79Performance Co-Pilot                  PCP                     PMDALMSENSORS(1)
Impressum