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

NAME

6       pmdalio - Linux LIO subsystem PMDA
7

DESCRIPTION

9       pmdalio is a Performance Metrics Domain Agent (PMDA) which exports met‐
10       ric values about the Linux I/O target  subsystem,  which  provides  for
11       protocols  like iSCSI, FCP, FCoE.  These allow storage available on one
12       host to be exported and consumed by other hosts using industry standard
13       protocols.
14
15       This  PMDA exports summary metrics which are performance value aggrega‐
16       tions and configuration per LIO target instance.  Additionally, it pro‐
17       vides  per  LUN  performance metrics including IOPS, and READ and WRITE
18       throughput.
19
20       The LIO configuration is maintained within the kernel's  configfs  vir‐
21       tual  filesystem.   The  python-rtslib  module provides an interface to
22       configfs, allowing tools like pmdalio to interact with the settings and
23       metadata held in configfs.
24

INSTALLATION

26       Install the lio PMDA by using the Install script as root:
27
28           # cd $PCP_PMDAS_DIR/lio
29           # ./Install
30
31
32       To uninstall, do the following as root:
33
34           # cd $PCP_PMDAS_DIR/lio
35           # ./Remove
36
37       pmdalio  is  launched by pmcd(1) and should never be executed directly.
38       The Install and  Remove  scripts  notify  pmcd(1)  when  the  agent  is
39       installed or removed.
40

FILES

42       $PCP_PMDAS_DIR/lio/Install
43           installation script for the pmdalio agent
44
45       $PCP_PMDAS_DIR/lio/Remove
46           undo installation script for the pmdalio agent
47
48       $PCP_LOG_DIR/pmcd/lio.log
49           default log file for error messages from pmdalio
50

PCP ENVIRONMENT

52       Environment variables with the prefix PCP_ are used to parameterize the
53       file and directory names used by PCP. On each  installation,  the  file
54       /etc/pcp.conf  contains  the  local  values  for  these variables.  The
55       $PCP_CONF variable may be used to specify an alternative  configuration
56       file, as described in pcp.conf(5).
57

SEE ALSO

59       PCPIntro(1), pmcd(1), pminfo(1) and pmpython(1).
60
61
62
63Performance Co-Pilot                  PCP                           PMDALIO(1)
Impressum