1PMDALIO(1) General Commands Manual PMDALIO(1)
2
3
4
6 pmdalio - Linux LIO subsystem PMDA
7
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
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
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
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
58 pmcd(1), pminfo(1) and pmpython(1).
59
60
61
62Performance Co-Pilot PCP PMDALIO(1)