.TH MPADV 1
\"
\"	perfd multi-system adviser -- Chris Bertin
\"
.SH NAME
mpadv \- perfd multi-system adviser
.SH SYNOPSIS
.B mpadv
[options]
.SH DESCRIPTION
.PP
This program allows a performance expert to run \fBglance adviser\fR
scripts on multiple systems where the \fIperfd\fR daemon is running at
the same time. Note that, in order to limit the potentially high amount
of ouptut, \fImpadv\fR ignores all \fBprint\fR statements from the
\fIadviser\fR syntax file. It is recommended that remote scripts that
rely on \fBprint\fR statements be run on a single system using \fIpadv\fR.
.PP
The options are:
.PP
.TP 8
.B \-c\fR
If this option is present, time stamps will reflect the time on the system
where \fImpadv\fR is running, not the remote systems.
.TP
.B \-i iterations\fR
This option limits the number of iterations to be performed. By
default that value is 0 (zero), meaning a continuous run.
.TP
.B \-l list\fR
This specifies a file name containing a list of systems to run the
\fBadviser\fR script(s) on. The system names may be in the form
\fBsystem:port\fR where \fBport\fR is the port \fIperfd\fR is listening
on, one system per line with optional comments after a pound sign.
.TP
.B \-r
This option tells \fImpadv\fR to keep trying if a system is not available
when the program is invoked or if a system goes down as  the program is
running.
.TP
.B \-s script\fR
This option specifies which script to run. See the \fBFILES\fR section
in the \fIpadv(1)\fR man page for
default script and locations. If the list of system include multiple
platforms (OSes) and if a script is specified, the script must contain
metrics that are common to all platforms.
.TP
.B \-t threshold\fR
This option specifies a threshold value above which bottleneck
probabilities
will be printed even if the values do not result in an alert.
The default threshold is 70, meaning that any bottleneck
probability equal or above 70% will be printed. If a threshold above 100
is provided, only alerts contained in the \fIadviser\fR script(s) will be
printed.
.TP
.B \-v
This option causes \fImpadv\fR to produce more verbose output, such as
connection information.
.TP
.B \-?\fR
Print option list.
.SH FILES
Refer to the \fIpadv(1)\fR man page for default file name and locations.
If a script is not provided (with the \fB-s\fR option) and if the list
of systems contains multiple platforms, the appropriate OS default file
applies to each system.
.SH EXAMPLE
This will return print all alerts on all the systems in the 'systems' list,
connection and dropped connection messages.
.P
.nf
$ mpadv -l ~/stage/config/systems -v -r -t 101
Starting to monitor ovrlxb6, Fri Feb  8 10:21:48 2008
Starting to monitor hpcb2, Fri Feb  8 10:21:48 2008
Starting to monitor hpcb4, Fri Feb  8 10:21:48 2008
Starting to monitor ovrlxt55, Fri Feb  8 10:21:48 2008
Starting to monitor ovrlxb5, Fri Feb  8 10:21:48 2008
Starting to monitor ovrlxb10, Fri Feb  8 10:21:48 2008
Starting to monitor sunzone, Fri Feb  8 10:21:49 2008
Starting to monitor itania, Fri Feb  8 10:21:49 2008
Starting to monitor fatcat, Fri Feb  8 10:21:49 2008
Starting to monitor hpcb, Fri Feb  8 10:21:49 2008
Starting to monitor blueblood, Fri Feb  8 10:21:49 2008
Starting to monitor itill, Fri Feb  8 10:21:49 2008
Starting to monitor bluebolt, Fri Feb  8 10:21:49 2008
Starting to monitor ros80975ber, Fri Feb  8 10:21:50 2008
Connection to ovrlxb10 lost: Connection reset by peer, Fri Feb  8 10:43:18 2008
Starting to monitor ovrlxb10, Fri Feb  8 10:43:29 2008
Connection to ovrlxb6 lost: Connection reset by peer, Fri Feb  8 11:49:52 2008
Connection to ovrlxt55 lost: Connection reset by peer, Fri Feb  8 11:50:06 2008
Starting to monitor ovrlxb6, Fri Feb  8 11:50:53 2008
Starting to monitor ovrlxt55, Fri Feb  8 11:50:57 2008
ROS80975BER: YELLOW  Disk Bottleneck probability=    78.60%, 02/09/08 01:15:55
ROS80975BER: END     End of Disk Bottleneck Alert, 02/09/08 01:17:55
ROS80975BER: YELLOW  Disk Bottleneck probability=    71.40%, 02/09/08 01:30:30
ROS80975BER: END     End of Disk Bottleneck Alert, 02/09/08 01:30:50
ovrlxb10  : RED     Disk Bottleneck probability=    95.20%, 02/11/08 01:02:05
ovrlxb10  : END     End of Disk Bottleneck Alert, 02/11/08 01:03:15
ovrlxb10  : YELLOW  Memory Bottleneck probability=    85.00%, 02/12/08 05:39:25
ovrlxb10  : END     End of Memory Bottleneck Alert, 02/12/08 05:39:45
hpcb4     : YELLOW  CPU Bottleneck probability=    82.00%, 02/12/08 14:08:35
hpcb4     : END     End of CPU Bottleneck Alert, 02/12/08 14:10:45
.fi
.SH "SEE ALSO"
.PP
\fBglance\fR(1), \fBxglance\fR(1), \fBcpsh\fR(1), \fBpadv\fR(1), \fBperfd\fR(1M).