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. 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
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
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
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
59 PCPIntro(1), pmcd(1), pminfo(1) and pmpython(1).
60
61
62
63Performance Co-Pilot PCP PMDALIO(1)