PMLOGPUSH(1)

💅 PMLOGPUSH — push an archive to a remote pmproxy server ✨

okay bestie, gather round, because this one is from the General Commands Manual section and it's literally the little tool that yeets your PCP archive over to a remote server. it's called pmlogpush and it's in section 1 of the manual, and yes it slays 🫶

---

🌸 NAME 🌸

pmlogpush — push an archive to a remote pmproxy server

---

🦋 SYNOPSIS 🦋

pmlogpush [-SvV?]  [-D debug] [-h host] [-p port] [-s unix] [-U user]
[-P passfile] [-Z timezone] archive

---

✨ DESCRIPTION ✨

so here's the vibe: pmlogpush takes the contents of a Performance Co-Pilot (PCP) archive and sends it to a HTTP server — usually a remote pmproxy(1) daemon — using the logger API subset inside PMWEBAPI(5). no cap, that's the whole job 💖

the archive you're pushing must have already been created using pmlogger(1). that's not optional, that's the prerequisite, periodt.

also, that archive should be complete and finished — not actively being written to. if something's still writing to it, that's not this tool's moment 🙈

by default the archive gets transferred over cleartext HTTP. if you want the encrypted glow-up instead, the -S (--secure) option uses an encrypted TLS connection (https://). more on that option below, because it's a whole thing 💅

and here's a fun fact: you can get comparable functionality directly from pmlogger via the HTTP-prefixed archive name syntax, which pushes archives remotely while they are actively being written. different energy, same destination ✨

---

👑 OPTIONS 👑

here's every command line option, bestie, no skips:

• -h hostname, --host=hostname — the hostname of the remote pmproxy server that's gonna receive your PCP archive.
• -p port, --port=port — the internet socket port number where the remote pmproxy server is listening, waiting to receive the given PCP archive. the default port is 44322.
• -s path, --unix=path — the Unix domain socket path where a local pmproxy server is listening (locally, iykyk) and waiting to receive the given PCP archive.
• -S, --secure — use a secure, encrypted TLS connection (https://) to the remote pmproxy server instead of the default cleartext HTTP. the pmproxy server must have a TLS certificate configured (see pmproxy(1)), and because pmproxy auto-detects TLS on its usual port, no separate port is required 🎀. client-side TLS parameters — the certificate authority used to verify the server, and optionally a client certificate and key for mutual authentication — are read from $PCP_TLSCONF_PATH (typically /etc/pcp/tls.conf). pmlogpush always authenticates the server before sending any archive data: the pmproxy certificate must chain to a certificate authority trusted via $PCP_TLSCONF_PATH (tls-ca-cert-file or tls-ca-cert-dir), and its subject (or a subject alternative name) must match the hostname given with -h. an encrypted but unauthenticated connection is refused, because it would still be open to an active man-in-the-middle 😭. if TLS support is not available, or the handshake or verification fails, pmlogpush reports an error and exits; it never silently falls back to cleartext. no sneaky downgrades here 💀
• -U user, --username=user — authenticate to the remote pmproxy server as user using HTTP Basic authentication. this is an alternative to client-certificate (mutual TLS) authentication: it lets each pmlogpush present its own credential without provisioning per-client certificates. the password is not accepted on the command line (that would expose it in the process table 🙈); it's read from the file named by -P or, if that's not given, from the $PCP_PUSH_PASSWORD environment variable. and because HTTP Basic credentials are only base64 encoded and not encrypted, -U requires the -S (secure) option — sending credentials over a cleartext or unauthenticated connection is refused. periodt 🔥
• -P passfile, --password-file=passfile — read the HTTP Basic authentication password from the first line of passfile (a trailing newline is stripped). only meaningful together with -U. keeping the password in a file, rather than in the environment or on the command line, keeps it out of the process table and shell history — main character privacy behavior 💅
• -v, --verbose — increase the diagnostic information reported as pmlogpush runs.
• -?, --help — display usage message and exit.
• -V, --version — display version number and exit.

---

🎀 FILES 🎀

• $PCP_TLSCONF_PATH — client-side TLS configuration (certificate authority, and optionally a client certificate and key), used when the -S option requests a secure connection. typically /etc/pcp/tls.conf.
• $PCP_LOG_DIR/pmproxy/<hostname> — the default directory for pushed PCP archives created (remotely) by the receiving pmproxy server. the hostname is extracted from the given archive, as is the recording start time — together these properties are used to name the pushed archive on the receiving end (i.e. by the pmproxy server). so cute, it names itself 🦋

---

🌈 PCP ENVIRONMENT 🌈

environment variables with the prefix PCP_ are used to parameterize the file and directory names used by PCP. on each installation, the file /etc/pcp.conf contains the local values for these variables. the $PCP_CONF variable may be used to specify an alternative configuration file, as described in pcp.conf(5).

and also! when -U is used without -P, the HTTP Basic authentication password is taken from the $PCP_PUSH_PASSWORD environment variable. 👀

---

💜 DEBUGGING OPTIONS 💜

the -D or --debug option enables the output of additional diagnostics on stderr to help triage problems, although ngl the information is sometimes cryptic and primarily intended to provide guidance for developers rather than for end-users. debug is a comma separated list of debugging options; use pmdbg(1) with the -l option to obtain a list of the available debugging options and their meaning. the http debugging option is of particular interest for this utility. 🔍

---

🌟 SEE ALSO 🌟

PCPIntro(1), pmlogger(1), pmproxy(1), PMWEBAPI(3), pcp.conf(5) and pcp.env(5).

---

and that's the whole page, bestie 💖 this one came from Performance Co-Pilot under the PCP umbrella, and you were reading PMLOGPUSH(1). go push something iconic 🎀✨🦋