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

NAME

6       pmdalustrecomm  -  Lustre  filesystem  comms performance metrics domain
7       agent (PMDA)
8

SYNOPSIS

10       $PCP_PMDAS_DIR/lustrecomm/pmdalustrecomm [-d domain] [-l  logfile]  [-U
11       username]
12

DESCRIPTION

14       pmdalustrecomm  is  a Performance Metrics Domain Agent (PMDA) which ex‐
15       tracts performance metrics from the Linux procfs filesystem  about  the
16       state of various aspects of the Lustre filesystem.
17
18       The  lustrecomm PMDA exports metrics that focus on distributed communi‐
19       cation in the filesystem, including metrics related to  timeouts,  net‐
20       work  drops, send/recv information and route lengths.  However, it also
21       covers the memory use of some of the Lustre filesystem components.
22
23       A brief description of the pmdalustrecomm 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 lus‐
31            trecomm.log is written in the current directory  of  pmcd(1)  when
32            pmdalustrecomm  is  started,  i.e.  $PCP_LOG_DIR/pmcd.  If the log
33            file cannot be created or is not writable, output  is  written  to
34            the standard error instead.
35
36       -U   User account under which to run the agent.  The default is the un‐
37            privileged "pcp" account in current versions of PCP, but in  older
38            versions the superuser account ("root") was used by default.
39

INSTALLATION

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

FILES

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

PCP ENVIRONMENT

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

SEE ALSO

77       PCPIntro(1), pmcd(1), pcp.conf(5) and pcp.env(5).
78
79
80
81Performance Co-Pilot                  PCP                    PMDALUSTERCOMM(1)
Impressum