PMCD(1) General Commands Manual PMCD(1) (NAME) pmcd - (SYNOPSIS) pmcd [-AfFQSv?] [-c config] [-C nctx] [-D debug] [-H hostname] [-i ipaddress] [-l logfile] [-L bytes] [-M nmetric] [-[n|N] pmnsfile] [-p port[,port ...]] [-q timeout] [-s sockname] [-t timeout] [-T traceflag] [-U username] [-x file] (DESCRIPTION) pmcd Performance Co-Pilot ( PCPIntro(1)) . PCP pmcd . pmcd pmcd . pmcd Performance Metrics Domain Agents ( ) (domain) . postgresql PostgreSQL . pmcd (DSO dlopen(3)) pmcd . . PDU . pmcd . . pmcd . pmcd . (OPTIONS) : -A (service advertisement). pmcd . . -c config, --config=config pmcd $PCP_PMCDCONF_PATH /etc/pcp.conf . config . . -C nctx, --maxctx=nctx pmcd (context) . (DoS) . -C nctx . -f, --foreground pmcd . -f . . -F, --managed pmcd . -F launchd(1) systemd(1) . -H hostname, --hostname=hostname pmcd . pmlogger(1) ( ) . pmcd.hostname pmhostname(1) . . -i ipaddress, --interface=ipaddress . -i pmcd IP ( ) . -i IP . ipaddress ( 100.23.45.6). -i IP . IP . (gateway) . IP . IP ( ). PCP . -l logfile, --log=logfile pmcd.log $PCP_LOG_DIR/pmcd . -l logfile . ..TP -L bytes, --maxbytes=bytes PDU pmcd (Denial of Service) . -L PDU . -M nmetric, --maxmetric=nmetric fetch pmcd . -M nmetric . -n pmnsfile, --namespace=pmnsfile pmcd (PMNS) $PCP_VAR_DIR/pmns/root -n pmnsfile . -N pmnsfile, --uniqnames=pmnsfile -n (PMID) pmnsfile - -n -N . -p port, --port=port . 44321 . -q timeout pmcd ( PCP 2.0 - ) pmcd . PCP 2.0 . -q ( ) . timeout . -q PMCD_CREDS_TIMEOUT . -Q, --remotecert (certificate) . -s sockname, --socket=sockname unix domain ( ). $PCP_RUN_DIR/pmcd.socket . -S, --reqauth . unix domain ( ). pmcd -S . -t timeout (PMCS) pmcd PDU (timeout) . . -t . timeout . (debugger) pmcd . pmcd ( ) pmcd.control.timeout pmstore(1) . -T traceflag, --trace=traceflag / pmcd pmcd . traceflag : 1 2 PDU 256 . pmstore(1) pmcd.control.tracebufs . pmcd () () pmcd.control.traceconn pmcd.control.tracepdu pmcd.control.tracenobuf . traceflag -T . pmcd pmcd.control.dumptrace pmstore(1) . . -U username, --username=USER pmcd . PCP <> (<>) . -v, --verify pmcd . -x file logfile pmcd pmcd . /dev/tty file ..TP -? --help . (CONFIGURATION) pmcd $PCP_PMCDCONF_PATH . pmcd . . : pmcd root . root . root . . . ( ). <<#>> . <<\>> () . . . . <<#>> . . (AGENT CONFIGURATION) pmcd . DSO (pipe) . . . () . . PMID . . DSO : label domain-no dso entry-point path . label domain-no entry-point DSO path DSO . pmcd DSO simabi ( ABI ) ( simabi ). simabi pmcd pmcd.simabi . file(1) simabi pmcd . path PMCD_PATH (:) DSO . $PCP_SHARE_DIR/lib:/usr/pcp/lib . : label domain-no socket addr_family address [ command ] . label domain-no addr_family AF_INET AF_INET6 AF_UNIX inet ipv6 unix . address addr_family . unix ( UNIX). inet ipv6 . pmcd . command pmcd . command pmcd . command . fork(2) command execve(2) . stdin/stdout pmcd : label domain-no pipe protocol command . .TP 14 label domain-no protocol binary . protocol notready pmcd . PDU PM_ERR_PMDAREADY pmcd . IPC Install PMDA ipc_prot PMDA(3) . command pmcd . command . command protocol . fork(2) command execve(2) . (ACCESS CONTROL CONFIGURATION) . . : (``['' ``]'') (``{'' ``}'') (``:'') (``;'') (``,''). . ( ) . : [access] ( ) access pmcd pmcd '.access' . [access] . access . () . . pmcd : fetch pmcd . ( ) . pminfo(1) . store pmcd . ( ). PMDA ( ) - store . pmstore(1) . pmcd - . . /etc/passwd /etc/groups ( ) getpwent(3) getgrent(3) . IP IPv6 ``"unix:"'' ``"local:"'' . ``"unix:"'' pmcd . ``"local:"'' ``"unix:"'' ``localhost`` . (wildcard) ``*'' . ``".*"'' inet (IPv4) . ``":*"'' IPv6 . IPv6 ``::'' ``*'' . ``*'' ``"unix:"'' . . : boing localhost giggle.melbourne.sgi.com 129.127.112.2 129.127.114.* 129.* .* fe80::223:14ff:feaf:b62c fe80::223:14ff:feaf:* fe80:* :* "unix:" "local:" * : *.melbourne 129.127.*.* 129.*.114.9 129.127* fe80::223:14ff:*:* fe80::223:14ff:*:b62c fe80* IP () . . ( 127* fe80* ). localhost . 127.0.0.1 ::1 inet IPv6 pmcd . pmcd (multi-homed) ..PP : allow users userlist : operations ; disallow users userlist : operations ; allow groups grouplist : operations ; disallow groups grouplist : operations ; allow hosts hostlist : operations ; disallow hosts hostlist : operations ; list userlist grouplist hostlist . operations all ( / ) all except operations ( / ) . users groups hosts . hosts . . allow disallow . . pmcd PM_ERR_PERMISSION . (wildcarding) . clank 129.127.112.2 : allow host clank : fetch, store; disallow host 129.127.112.2 : all except fetch; fetch . (override) . : allow host clank : all; (override) : disallow host 129.127.112.* : all except fetch; ( ) . : disallow host * : all; pmcd . maximum n connections operations allow . disallow . n () . ( ) . . . pmcd . << >> . . pmcd (user ID) (group ID) . . pmcd - . . pmcd . - SASL Unix domain socket ( ). -S . pmcd.feature.creds_required pmcd . << >> . . : allow host clank : all, maximum 5 connections; allow host * : all except store, maximum 2 connections; "clank" . "boing" pmcd ( ). . "clank" . "clank" . "clank" . . . "clank" . pmcd "boing" . "clank" . . "boing" . pmcd ..PP () . . pmcd ( ) . (AGENT FENCING) PMDA . <<>> PMAPI . PMDA PMCD pmstore(1) # pmstore -i nfsclient,kvm pmcd.agent.fenced 1 . <<>> # pmstore -i nfsclient,kvm pmcd.agent.fenced 0 PMDA # pmstore pmcd.agent.fenced 0 pmcd.agent.fenced ( ) . -T, --helptext pminfo(1) . PMCD (RECONFIGURING PMCD) PMNS pmcd SIGHUP # pmsignal -a -s HUP pmcd pmcd SIGHUP . . . pmcd . PMNS . PMNS / . tail(1) pmcd . ( ) . . . . . ( SIGTERM pmsignal(1)) SIGHUP pmcd . PMCD (STARTING AND STOPPING PMCD) pmcd . pmcd . (superuser) pmcd # $PCP_RC_DIR/pmcd start pmcd: # $PCP_RC_DIR/pmcd stop pmcd . pmcd . ( ). pmcd pmcd . . PMDA pmcd PMDA ( pmcd ). pmcd ( SIGHUP ) PMDA ( ). PMDA pmcd PMDA pmcd . pmcd 44321 TCP/IP ( http://www.iana.org). PMCD_PORT -p () pmcd . -p pmcd -p PMCD_PORT . pmcd PMCD_PORT pmcd ( PCPIntro(1) )..SH " (CAVEATS)" pmcd ( agents) (pipes) . . . . -t (IPC) pmcd PMDA . PMCD_CONNECT_TIMEOUT PMCD_REQUEST_TIMEOUT ( PCPIntro(1)) pmcd pmcd . (DIAGNOSTICS) pmcd "Error: OpenRequestSocket bind: Address may already be in use" . pmcd . TIME_WAIT ( ) pmcd . PCP pmdbg(1) pmcd : appl0 I/O appl1 appl2 . (FILES) $PCP_PMCDCONF_PATH $PCP_PMCDCONF_PATH.access $PCP_PMCDOPTIONS_PATH pmcd $PCP_RC_DIR/pmcd . (-) . $PCP_SYSCONFIG_DIR/pmcd pmcd . "PMCD_VARIABLE=value" "PCP_VARIABLE=value" . $PCP_SYSCONF_DIR/labels.conf PMCS. $PCP_SYSCONF_DIR/labels context pmcd . "." ".json" name:value "JSONB" . pmcd.labels . context . $PCP_SYSCONF_DIR/labels/optional context pmcd . context . ./pmcd.log ( $PCP_LOG_DIR/pmcd/pmcd.log ) . $PCP_RUN_DIR/pmcd.pid (PID) pmcd . /etc/pcp/tls.conf OpenSSL (Secure Socket Layer). /etc/passwd /etc/groups (ENVIRONMENT) $PCP_SYSCONFIG_DIR/pmcd . PCP PCP ENVIRONMENT PMCD_PORT TCP/IP ( 44321) PMCD_SOCKET . 1 PMCD_LOCAL pmcd -localhost loopback (bind) . pmcd.feature.local pmcd . PMCD_MAXPENDING . PMCD_ROOT_AGENT pmcd pmdaroot ( ) PMDA . pmcd PMDA pmdaroot . PMCD_RESTART_AGENTS pmcd PMDA ( PDU ). pmcd PMDA . ..SH " PCP (PCP ENVIRONMENT)" PCP_ PCP . /etc/pcp.conf . $PCP_CONF pcp.conf(5) . PCP pmGetOptions(3) . (DEBUGGING OPTIONS) -D --debug stderr . debug pmdbg(1) -l . pmcd : +----------------+-----------------------------------------------------+ | | | +----------------+-----------------------------------------------------+ |appl0 | PDU | +----------------+-----------------------------------------------------+ |appl1 | | | | | | | | +----------------+-----------------------------------------------------+ |appl2 | | | | | | | | +----------------+-----------------------------------------------------+ |appl3 | | | | | +----------------+-----------------------------------------------------+ |appl4 | | | | | | | | +----------------+-----------------------------------------------------+ |appl5 | | | | (attribute) | +----------------+-----------------------------------------------------+ |appl6 | | | | PMDA | +----------------+-----------------------------------------------------+ (SEE ALSO) PCPIntro(1) pmdbg(1) pmerr(1) pmgenmap(1) pminfo(1) pmrep(1) pmstat(1) pmstore(1) pmval(1) getpwent(3) getgrent(3) labels.conf(5) pcp.conf(5) pcp.env(5) PMNS(5). Performance Co-Pilot PCP PMCD(1)