NAME

       PCPCompat, pcp-collectl, pmmgr, pmwebd - backward-compatibility in the Performance Co-Pilot (PCP)

INTRODUCTION

       The  Performance  Co-Pilot  (PCP)  is  a  toolkit  designed  for  monitoring  and  managing  system-level
       performance.  These services are  distributed  and  scalable  to  accommodate  the  most  complex  system
       configurations and performance problems.

       In  order  to  achieve  these  goals  effectively, protocol and on-disk compatibility is provided between
       different versions of PCP.  It  is  feasible  (and  indeed  encouraged)  to  use  current  PCP  tools  to
       interrogate any remote, down-rev or up-rev pmcd(1) and also to replay any historical PCP archive (the PCP
       testsuite includes PCP archives created over 20 years ago!).

       From time to time the PCP developers deprecate and remove PCP utilities, replacing them with new versions
       of utilities providing comparable features.  This page describes replacement utilities for historical PCP
       tools.

SAR2PCP

       The  sar2pcp(1)  utility is now deprecated, and will be retired in a future version of PCP (v6).  This is
       being replaced by native support for generating PCP archives within the  tools  of  the  sysstat  package
       (which provides sar itself, as well as the sadf utility which produces PCP archives via the -l option).

PMLOGCONF-SETUP

       Earlier  versions  of  PCP  (prior  to  v5.1.1)  provided  a  shell  script  that  was used internally by
       pmlogconf(1), located in the PCP_BINADM_DIR directory,  named  pmlogconf-setup.   This  script  has  been
       retired.   The  equivalent  functionality remains available in the unlikely event it should be needed via
       the -s or --setup option to pmlogconf(1).

       The version 1 pmlogconf-setup configuration file format (from IRIX) was also  retired  in  this  release,
       after more than 10 years of automatic transition to version 2 format by pmlogconf.

PMMGR

       The  standalone  PCP  daemon manager pmmgr has been retired from PCP v5.2.0 onward.  It was phased out in
       favour of the simpler pmfind(1) service for setting up pmie(1) and pmlogger(1)  ``farms''  of  discovered
       PCP collector systems with pmfind_check(1).  The new mechanisms, especially when integrated with systemd,
       require  no  additional  daemons  and are better integrated with the pmie and pmlogger service management
       used elsewhere in PCP.

PCP-COLLECTL

       The pcp-collectl utility has been superceded by pmrep(1) from PCP v5 onward.

       The equivalent of pcp-collectl subsystem reporting is achieved as follows:

       pmrep :collectl-sc
              Processor subsystem view.

       pmrep :collectl-sm
              Memory subsystem view.

       pmrep :collectl-sd
              Aggregate disks view.

       pmrep :collectl-sD
              Per-disk-device view.

       pmrep :collectl-dm-sD
              Device mapper view.

       pmrep :collectl-sn
              Network subsystem view.

PCP-WEBAPPS

       The standalone web applications packaged with  older  PCP  versions  have  been  superceded  by  grafana-
       server(1) with the grafana-pcp plugin https://github.com/performancecopilot/grafana-pcp.

       This  plugin  provides  an  implementation  of  the  Vector  application,  as  well  as  data sources for
       pmdabpftrace(1) (bpftrace(8) scripts) and pmseries(1) (fast, scalable Redis-based time series analysis).

PMWEBD

       The pmwebd daemon has been superceded by pmproxy(1) from PCP v5 onward.

       By default, pmproxy will now listen on both its original port (44322) and the PCP web  API  port  (44323)
       when the time series support is built.

       pmproxy provides a compatible implementation of the live PMWEBAPI(3) interfaces used traditionally by the
       Vector  web  application  (see the ``PCP-WEBAPPS'' section).  It also provides extensions to the original
       pmwebd REST APIs (such as derived metrics, namespace lookups and instance domain profiles),  support  for
       the  HTTPS  protocol,  and  fast, scalable time series querying using the pmseries(1) REST API and redis-
       server(1).

       The partial Graphite API emulation provided by pmwebd has not been re-implemented - applications  wishing
       to use similar services could use the scalable time series REST APIs described on PMWEBAPI(3).

SEE ALSO

       pcp(1), pmcd(1), sar2pcp(1), pmrep(1), pmfind(1), pmfind_check(1), pmlogconf(1), pmproxy(1), pmseries(1),
       pmdabpftrace(1), redis-server(1), grafana-server(1) and PMWEBAPI(3).

Performance Co-Pilot                                   PCP                                          PCPCOMPAT(1)