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.  Additional,  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       To uninstall, do the following as root:
32
33             # cd $PCP_PMDAS_DIR/lio
34             # ./Remove
35
36       pmdalio  is  launched by pmcd(1) and should never be executed directly.
37       The Install and  Remove  scripts  notify  pmcd(1)  when  the  agent  is
38       installed or removed.
39

FILES

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

PCP ENVIRONMENT

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

SEE ALSO

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