1PMDASENDMAIL(1)             General Commands Manual            PMDASENDMAIL(1)
2
3
4

NAME

6       pmdasendmail - sendmail performance metrics domain agent (PMDA)
7

SYNOPSIS

9       $PCP_PMDAS_DIR/sendmail/pmdasendmail [-d domain] [-l logfile]
10

DESCRIPTION

12       pmdasendmail  is  a  sendmail  Performance  Metrics Domain Agent (PMDA)
13       which exports mail traffic statistics as collected by sendmail(1).
14
15       Before the sendmail PMDA can export any metrics, sendmail(1) must  have
16       statistics  collection enabled.  This involves checking the name of the
17       statistics file, as given by the OS or O StatusFile  control  lines  in
18       /etc/sendmail.cf,  and  then  creating this file if it does not already
19       exist.  Removing the file will terminate statistics collection by send‐
20       mail(1) and hence the sendmail PMDA.
21
22       A brief description of the pmdasendmail command line options follows:
23
24       -d   It  is absolutely crucial that the performance metrics domain num‐
25            ber specified here is unique  and  consistent.   That  is,  domain
26            should  be  different for every PMDA on the one host, and the same
27            domain number should be used for the same PMDA on all hosts.
28
29       -l   Location of the log file.  By default,  a  log  file  named  send‐
30            mail.log  is  written  in  the  current  directory of pmcd(1) when
31            pmdasendmail is started, i.e.  $PCP_LOG_DIR/pmcd.  If the log file
32            cannot  be  created  or  is not writable, output is written to the
33            standard error instead.
34
35       There are no communication options, as the Install script  ensures  the
36       sendmail PMDA will be connected to PMCD by a pipe.
37

INSTALLATION

39       If  you want access to the names, help text and values for the sendmail
40       performance metrics, do the following as root:
41
42            # cd $PCP_PMDAS_DIR/sendmail
43            # ./Install
44
45       If you want to undo the installation, do the following as root:
46
47            # cd $PCP_PMDAS_DIR/sendmail
48            # ./Remove
49
50       pmdasendmail is launched  by  pmcd(1)  and  should  never  be  executed
51       directly.  The Install and Remove scripts notify pmcd(1) when the agent
52       is installed or removed.
53

FILES

55       $PCP_PMCDCONF_PATH
56                 command line options used to launch pmdasendmail
57       $PCP_PMDAS_DIR/sendmail/help
58                 default help text file for the sendmail metrics
59       $PCP_PMDAS_DIR/sendmail/Install
60                 installation script for the pmdasendmail agent
61       $PCP_PMDAS_DIR/sendmail/Remove
62                 undo installation script for the pmdasendmail agent
63       $PCP_LOG_DIR/pmcd/sendmail.log
64                 default log file for error  messages  and  other  information
65                 from pmdasendmail
66       /etc/sendmail.cf
67                 sendmail  configuration file to identify the name of the sta‐
68                 tistics file
69

PCP ENVIRONMENT

71       Environment variables with the prefix PCP_ are used to parameterize the
72       file  and  directory names used by PCP.  On each installation, the file
73       /etc/pcp.conf contains the  local  values  for  these  variables.   The
74       $PCP_CONF  variable may be used to specify an alternative configuration
75       file, as described in pcp.conf(4).
76

SEE ALSO

78       pmcd(1) and sendmail(1).
79
80
81
82Performance Co-Pilot                  SGI                      PMDASENDMAIL(1)
Impressum